README

此软件包提供 Sirv 图像的文件系统驱动程序。如果您需要更多控制或想实现更多 Sirv API 端点，请查看我们的Laravel 包装器 for Sirv，该包装器也被此软件包使用。

Sirv 图像 API 的完整文档可以在此处找到。

要求

PHP >= 8.0
Laravel >= 9.0

安装

要开始使用此软件包，您需要通过 Composer 安装它

composer require lipit146/filesystem-sirv

Laravel 版本兼容性

服务提供者

将软件包服务提供者在您的 config/app.php 中添加

'providers' => [
    // ...
    Lipit146\FilesystemSirv\FilesystemSirvImagesServiceProvider::class,
];

发布软件包资产

使用此 php artisan 命令发布软件包资产文件

$ php artisan vendor:publish --provider="Lipit146\FilesystemSirv\FilesystemSirvImagesServiceProvider"

配置

将以下内容添加到您的 config/filesystems.php 文件中

'sirv' => [
    'driver' => 'sirv',
    'key' => env('SIRV_ACCESS_KEY_ID'),
    'secret' => env('SIRV_SECRET_ACCESS_KEY'),
    'region' => env('SIRV_DEFAULT_REGION'),
    'bucket' => env('SIRV_BUCKET'),
    'url' => env('SIRV_URL'),
    'endpoint' => env('SIRV_ENDPOINT'),
    'scheme'  => 'https',
],

将以下环境变量添加到您的 .env 文件中

SIRV_ACCESS_KEY_ID="<your_email>"
SIRV_SECRET_ACCESS_KEY="<your_access_key>"
SIRV_DEFAULT_REGION="<option_region>"
SIRV_BUCKET="<your_bucket>"
SIRV_ENDPOINT="https://s3.sirv.com"
SIRV_URL="https://<your_bucket>.sirv.com"

如果您还没有我们的 Laravel-Sirv 包装器，您还需要将以下环境变量添加到您的 .env 文件中

SIRV_ACCESS_KEY_ID=""
SIRV_SECRET_ACCESS_KEY=""
SIRV_BUCKET=""

入门

Sirv 图像文件系统驱动程序可以使用您使用其他文件系统驱动程序的方式使用。有关 Laravel 文件系统的文档，请参阅此处。

以下示例显示了如何使用 Sirv 图像文件系统驱动程序存储文件。

use Illuminate\Support\Facades\Storage;

Storage::disk('sirv')->put('example.png', 'contents');

注意

Sirv 图像不支持目录，因此并非所有文件系统方法都可用。以下方法受支持

get
put
delete
directories

以下方法不受支持

files
allFiles
allDirectories
createDirectory
deleteDirectory
fileExists
url
copy
rename
visibility

以下方法仍需实现

setVisibility
getVisibility

安全漏洞

如果您在此项目中发现安全漏洞，请通过songviytuong@gmail.com 发送电子邮件给我。

官方网站

https://sirv.com - Image CDN: Image Optimization, Processing & Hosting • Sirv
https://sirv.com/help/articles/s3-api/php-sdk-for-sirv-s3/ - PHP SDK for Sirv S3

lipit146 / filesystem-sirv

维护者

详细信息