larva/laravel-flysystem-tos

This is a Flysystem adapter for the volcengine TOS.

1.0.2 2025-08-19 08:07 UTC

Requires

• php: ^8.2.0
• laravel/framework: ^10.0|^11.0|^12.0
• larva/flysystem-tos: ^1.0
• league/flysystem: ^3.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.6

MIT

• tos
• Flysystem
• Larva
• volcengine

README

适用于 Laravel 的火山引擎 TOS 适配器，完整支持火山引擎 TOS 所有方法和操作。

要求

• PHP >= 8.0
• Laravel >= 10.0

安装

composer require larva/laravel-flysystem-tos -vv

修改配置文件: config/filesystems.php

添加一个磁盘配置

'tos' => [
    'driver'     => 'tos',
    'access_key' => env('TOS_ACCESS_KEY', 'your key'),
    'access_secret' => env('TOS_ACCESS_SECRET', 'your secret'),
    'bucket' => env('TOS_BUCKET', 'your bucket'),
    'endpoint' => env('TOS_ENDPOINT', 'your endpoint'),//不要用CName,经过测试，官方SDK实现不靠谱
    'url' => env('TOS_URL','cdn url'),//CNAME 写这里，可以是域名绑定或者CDN地址 如 https://www.bbb.com 末尾不要斜杠
    'ssl' => true,//是否开启https
],

修改默认存储驱动

    'default' => 'tos'

使用

参见 Laravel wiki