组件 — 存储与云分发

return [

    /**
     * -------------------------------------------------------------------------
     *  默认存储桶名称
     * -------------------------------------------------------------------------
     *
     * 在此处，您可以指定希望默认用于所有存储操作的存储桶。
     *
     */

    'default' => env('STORAGE_SERVER', 'uploads'),

    /**
     * -------------------------------------------------------------------------
     *  存储服务器
     * -------------------------------------------------------------------------
     *
     * 您的应用程序配置了每个服务器。
     * 当然，下面显示了自定义 Spiral 支持的每个可用服务器的示例，以简化开发。
     *
     */

    'servers' => [
        'static' => [
            'adapter' => 'local',
            'directory' => __DIR__ . '/../../runtime/static',
        ],

        's3' => [
            'adapter' => 's3', // or "s3-async"
            'region' => env('S3_REGION'),
            'bucket' => env('S3_BUCKET'),
            'key' => env('S3_KEY'),
            'secret' => env('S3_SECRET'),
        ],
    ],

    /**
     * -------------------------------------------------------------------------
     *  存储桶
     * -------------------------------------------------------------------------
     *
     *  这里是使用上面服务器设置的特定桶（或存储）的列表。
     *  此列表中每个“server”部分必须引用上面列表中的有效服务器名称。
     *
     *  在这种情况下，设置列表也是一个使用示例。您可以
     *  根据需要自由更改桶的数量和设置类型。
     *
     */

    'buckets' => [
        'uploads' => [
            'server' => 'static',
            'prefix' => 'upload',
        ],

        'images' => [
            'server' => 'static',
            'prefix' => 'img',
        ],

        'videos' => [
            'server' => 's3',
        ],
    ],
];

$storage = new \Spiral\Storage\Storage();

$storage->add('example', \Spiral\Storage\Bucket::fromAdapter(
    new \League\Flysystem\Local\LocalFilesystemAdapter(__DIR__ . '/path/to/directory')
));

$file = $storage->bucket('example')
    ->write('file.txt', 'content');

fileserver:
  address: 127.0.0.1:10101
  calculate_etag: true
  weak: false
  stream_request_body: true
  serve:
    - prefix: "/avatars"
      root: "/app/storage/user-profiles/avatars"

use Spiral\Storage\StorageInterface;

class UploadController
{
    public function createFile(StorageInterface $storage): array
    {
        $result = [];
        
        // 1. Storage 级别
        $result[] = $storage->create('bucket://example.txt');

        // 2. Bucket 级别
        $result[] = $storage->bucket('bucket')
            ->create('example.txt');

        // 3. File 级别
        $result[] = $storage->bucket('bucket')
            ->file('example.txt')
            ->create();

        return $result;
    }
}

use Spiral\Storage\BucketInterface;
use Psr\Http\Message\ServerRequestInterface;

class UploadingController
{
    public function upload(ServerRequestInterface $request, BucketInterface $bucket): string
    {
        /** @var \Psr\Http\Message\UploadedFileInterface $file */
        foreach ($request->getUploadedFiles() as $i => $file) {
            $bucket->write("file-{$i}.txt", $file->getStream());
        }

        return \count($request->getUploadedFiles()) . ' files uploaded';
    }
}

// 从桶创建文件
$file = $bucket->create('file.txt');

// 从桶创建具有字符串内容的文件
$file = $bucket->write('file.txt', 'message');

// 从桶创建具有资源流内容的文件
$file = $bucket->write('file.txt', fopen(__DIR__ . '/local/file.txt', 'rb+'));

$backup = $firstBucket->copy('from.txt', 'backup.txt');

$moved  = $firstBucket->move('backup.txt', 'to.txt', $secondBucket);

$bucket->delete('file.txt');

$string = $bucket->getContents('text.txt');

$resource = $bucket->getStream('music.mp3');

$isExists = $bucket->exists('file.txt');

$bytes = $bucket->getSize('file.txt');

$timestamp = $bucket->getLastModified('file.txt');

$mime = $bucket->getMimeType('file.txt');

$visibility = $bucket->getVisibility('file.txt');

// 如果文件是“private”，则发布它
if ($visibility === Visibility::VISIBILITY_PRIVATE) {
    $bucket->setVisibility('file.txt', Visibility::VISIBILITY_PUBLIC);
}

return [
    // ...
    'buckets' => [
        'uploads' => [
            'server' => '...',

            //
            // + 添加与现有分发的关联。
            //
            'distribution' => 'NAME_OF_DISTRIBUTION'
        ],
    ],
];

use Spiral\Storage\BucketInterface;
use Spiral\Distribution\UriResolverInterface;

class UriController
{
    // 使用默认的 URI 解析器
    public function getUri(BucketInterface $bucket): string
    {
        return (string)$bucket
            ->file('picture.jpg')
            ->toUri();
    }

    // 使用另一个 URI 解析器
    public function getAnotherUri(BucketInterface $bucket, UriResolverInterface $resolver): string
    {
        return (string)$bucket
            ->file('picture.jpg')
            ->toUriFrom($resolver);
    }
}

$uri = $file->toUri(new \DateInterval('PT30S'));
// 并且
$uri = $file->toUriFrom($resolver, new \DateInterval('PT30S'));

<?php

return [

    /**
     * -------------------------------------------------------------------------
     *  默认分发解析器名称
     * -------------------------------------------------------------------------
     *
     * 在此处，您可以指定希望在
     * 默认情况下用于所有 URI 生成的解析器。 当然，您可以使用
     * 多个解析器，同时使用分发库。
     *
     */

    'default' => env('DISTRIBUTION_RESOLVER', 'local'),

    /**
     * -------------------------------------------------------------------------
     *  分发解析器
     * -------------------------------------------------------------------------
     *
     *  以下是为您的应用程序配置的每个解析器。
     *  当然，下面显示了自定义 Spiral 支持的每个可用分发的示例，
     *  以简化开发。
     *
     */

    'resolvers' => [
        'local' => [
            'type' => 'static',
            'uri'  => env('APP_URL', 'http://localhost')
        ],

        'cloudfront' => [
            'type' => 'cloudfront',
            'key' => env('AWS_CF_KEY'),
            'domain' => env('AWS_CF_KEY'),
            'private' => env('AWS_CF_PRIVATE_KEY'),
        ],

        's3' => [
            'type' => 's3',
            'region' => env('S3_REGION'),
            'bucket' => env('S3_BUCKET'),
            'key' => env('S3_KEY'),
            'secret' => env('S3_SECRET'),
        ],
    ],

];

$manager = new \Spiral\Distribution\Manager();

$manager->add('resolver-name', new CustomResolver());

$manager->resolver('resolver-name'); // object(CustomResolver)

use Nyholm\Psr7\Uri;
use Spiral\Distribution\Manager;
use Spiral\Distribution\Resolver\StaticResolver;

$manager = new Manager();
$manager->add('local', new StaticResolver(new Uri('https://static.example.com')));

use Spiral\Distribution\DistributionInterface;

class FilesController
{
    public function showImage(DistributionInterface $dist): string
    {
        $resolver = $dist->resolver('local');

        return (string)$resolver->resolve('example/image.jpg');
    }
}

use Spiral\Distribution\UriResolverInterface;

class FilesController
{
    public function showImage(UriResolverInterface $resolver): string
    {
        return (string)$resolver->resolve('example/image.jpg');
    }
}

$uri = $resolver->resolve('path/to/file.txt');
//
// 预期：
//  object(Psr\Http\Message\UriInterface)
//

return [
    // ...
    'resolvers' => [
        // ...
        'local' => [
            //
            // 解析器类型的必需键。
            // 对于静态解析器，它必须包含“static”字符串值。
            //
            'type' => 'static',

            //
            // 静态服务器 URL 的必需键。
            //
            'uri'  => env('APP_URL', 'http://localhost')
        ],
    ]
];

/** @var \Spiral\Distribution\Resolver\StaticResolver $resolver */
$resolver = $manager->resolver('local');

echo $resolver->resolve('path/to/file.txt');
//
// 预期：
//  string(33) "http://localhost/path/to/file.txt"
//

return [
    // ...
    'resolvers' => [
        // ...
        'cloudfront' => [
            //
            // 解析器类型的必需键。
            // 对于 CloudFront，它必须包含“cloudfront”字符串值。
            //
            'type' => 'cloudfront',

            //
            // CloudFront 访问密钥 ID 的必需键。
            // 这必须包含字符串值，如“AAAABBBBCCCCDDDDEEEE”。
            //
            // 可以在您的个人“安全凭证”页面上找到标识符，网址为：
            //  - https://console.aws.amazon.com/iam/home#/security_credentials
            //
            'key' => env('AWS_CF_KEY'),
            
            //
            // CloudFront 私钥的必需键。
            // 这必须是私钥字符串值或私钥文件的路径。
            //
            // 标识符也可以在此处的“安全凭证”页面上找到：
            //  - https://console.aws.amazon.com/iam/home#/security_credentials
            //
            // 请注意，您只能在生成期间下载私钥文件！
            //
            'private' => env('AWS_CF_PRIVATE_KEY'),

            //
            // CloudFront 域名所需的密钥。
            // 这必须包含字符串值，如“example.cloudfront.net”。
            //
            // 可以在此处找到域在“CloudFront 分发”页面上：
            //  - https://console.aws.amazon.com/cloudfront/home
            //
            'domain' => env('AWS_CF_DOMAIN'),
            
            //
            // CloudFront 文件前缀的可选键。
            // 这必须包含类似“path/to/directory”的字符串。在这种情况下，
            // 每次生成 URL 时都会添加此前缀。
            //
            'prefix' => env('AWS_CF_PREFIX'),
        ],
    ]
];

//
// 在构造函数中使用 PHP 8 命名参数是为了清晰起见
//
$cloudfront = new \Spiral\Distribution\Resolver\CloudFrontResolver(
    keyPairId: 'AAAABBBBCCCCDDDDEEEE',
    privateKey: \file_get_contents(__DIR__ . '/path/to/key.pem'),
    domain: 'example.cloudfront.net',
    prefix: 'path/to/files'
);

$url = $cloudfront->resolve(...);