如何优雅地将阿里云OSS集成到PHP应用中？使用Flysystem-OSS适配器轻松搞定！

<code class="bash">$ composer require "iidestiny/flysystem-oss:^4" -vvv</code>

<pre class="brush:php;toolbar:false;">use League\Flysystem\Filesystem;
use Iidestiny\Flysystem\Oss\OssAdapter;

$prefix = ''; // 可选：文件存储路径的前缀
$accessKeyId = 'YOUR_ACCESS_KEY_ID';
$accessKeySecret = 'YOUR_ACCESS_KEY_SECRET';
$endpoint= 'oss-cn-beijing.aliyuncs.com'; // OSS提供的域名，如果使用CName，这里填你的CName域名
$bucket = 'your-bucket-name';
$isCName = false; // 如果endpoint是你的自定义域名（CName），设置为true

$adapter = new OssAdapter($accessKeyId, $accessKeySecret, $endpoint, $bucket, $isCName, $prefix);

// 如果需要，还可以设置CDN加速域名
// $adapter->setCdnUrl('https://cdn.yourdomain.com');

$flysystem = new Filesystem($adapter);

<pre class="brush:php;toolbar:false;">// 写入字符串内容
$flysystem->write('path/to/file.txt', 'Hello, OSS!');

// 写入网络文件内容
$flysystem->write('path/to/remote.txt', 'http://example.com/somefile.txt', ['options' => ['xxxxx' => 'application/redirect302']]);

// 写入文件流
$stream = fopen('path/to/local/image.jpg', 'r');
$flysystem->writeStream('path/to/image.jpg', $stream);
if (is_resource($stream)) {
    fclose($stream);
}

<pre class="brush:php;toolbar:false;">$flysystem->move('old/path/file.txt', 'new/path/file.txt');
$flysystem->copy('source/file.txt', 'destination/file.txt');

<pre class="brush:php;toolbar:false;">$flysystem->delete('path/to/file.txt');
$flysystem->deleteDirectory('path/to/directory');

<pre class="brush:php;toolbar:false;">if ($flysystem->fileExists('path/to/file.txt')) {
    $contents = $flysystem->read('path/to/file.txt');
    echo $contents;
}

$metadata = $flysystem->getMetadata('path/to/file.txt');
$fileSize = $flysystem->fileSize('path/to/file.txt');
$mimeType = $flysystem->mimeType('path/to/file.txt');
$lastModified = $flysystem->lastModified('path/to/file.txt');

// 获取文件URL (通过适配器实例)
$url = $adapter->getUrl('path/to/file.jpg');
echo $url;

// 获取带签名的临时URL，支持图片处理
$temporaryUrl = $adapter->getTemporaryUrl('path/to/image.jpg', 3600, ['x-oss-process' => 'image/resize,w_100']);
echo $temporaryUrl;

<pre class="brush:php;toolbar:false;">$contents = $flysystem->listContents('path/to/directory');
foreach ($contents as $item) {
    echo $item['path'] . PHP_EOL;
}

<pre class="brush:php;toolbar:false;">// 生成用于前端直传的签名配置
$config = $adapter->signatureConfig(
    $prefix = 'uploads/', // 上传到OSS的路径前缀
    $callBackUrl = 'https://yourdomain.com/oss/callback', // OSS回调服务器的URL
    $customData = ['user_id' => 123], // 自定义回调参数
    $expire = 300, // 签名有效期（秒）
    $maxSize = 1024 * 1024 * 5 // 文件大小限制（5MB）
);
// $config 包含了前端直传所需的所有参数，如policy、signature等

<pre class="brush:php;toolbar:false;">list($verify, $data) = $adapter->verify(); // PHP 7.1+ 可用 [$verify, $data] = $adapter->verify();

if (!$verify) {
    // 验签失败，处理错误
    header("Content-Type: application/json");
    echo json_encode(['status' => 'error', 'message' => $data]);
    exit();
}

// 验签成功，$data 包含OSS返回的文件信息和自定义参数
// 例如：$data['filename'], $data['user_id']
header("Content-Type: application/json");
echo json_encode(['status' => 'success', 'data' => $data]);