Aliyun-oss-storage 开源项目使用教程

Aliyun-oss-storage 开源项目使用教程

1. 项目的目录结构及介绍

Aliyun-oss-storage/
├── src/
│   ├── AliyunOssServiceProvider.php
│   ├── AliyunOssAdapter.php
│   ├── AliyunOssClient.php
│   ├── AliyunOssException.php
│   ├── AliyunOssUtil.php
│   └── AliyunOssFacade.php
├── config/
│   └── aliyun-oss.php
├── tests/
│   └── AliyunOssTest.php
├── composer.json
├── README.md
└── LICENSE

• src/：包含项目的核心代码文件。
  • AliyunOssServiceProvider.php：服务提供者文件。
  • AliyunOssAdapter.php：适配器文件。
  • AliyunOssClient.php：客户端文件。
  • AliyunOssException.php：异常处理文件。
  • AliyunOssUtil.php：工具类文件。
  • AliyunOssFacade.php：门面文件。
• config/：包含项目的配置文件。
  • aliyun-oss.php：Aliyun OSS 配置文件。
• tests/：包含项目的测试文件。
  • AliyunOssTest.php：测试文件。
• composer.json：Composer 依赖管理文件。
• README.md：项目说明文件。
• LICENSE：项目许可证文件。

2. 项目的启动文件介绍

项目的启动文件主要是 src/AliyunOssServiceProvider.php，这个文件负责注册服务提供者，绑定服务容器，并加载配置文件。

namespace Jacobcyl\AliOSS\Plugins;

use Illuminate\Support\ServiceProvider;

class AliyunOssServiceProvider extends ServiceProvider
{
    public function boot()
    {
        $this->publishes([
            __DIR__.'/../config/aliyun-oss.php' => config_path('aliyun-oss.php'),
        ]);
    }

    public function register()
    {
        $this->app->singleton('aliyun-oss', function ($app) {
            return new AliyunOssClient(config('aliyun-oss'));
        });
    }
}

3. 项目的配置文件介绍

项目的配置文件是 config/aliyun-oss.php，这个文件包含了连接 Aliyun OSS 所需的所有配置信息。

return [
    'bucket'         => env('ALIYUN_OSS_BUCKET'),
    'access_id'      => env('ALIYUN_OSS_ACCESS_ID'),
    'access_key'     => env('ALIYUN_OSS_ACCESS_KEY'),
    'endpoint'       => env('ALIYUN_OSS_ENDPOINT'),
    'cdnDomain'      => env('ALIYUN_OSS_CDN_DOMAIN', ''),
    'ssl'            => env('ALIYUN_OSS_SSL', false),
    'debug'          => env('ALIYUN_OSS_DEBUG', false),
];

• bucket：OSS 存储桶名称。
• access_id：访问 ID。
• access_key：访问密钥。
• endpoint：OSS 服务端点。
• cdnDomain：CDN 域名（可选）。
• ssl：是否启用 SSL。
• debug：是否启用调试模式。

以上是 Aliyun-oss-storage 开源项目的目录结构、启动文件和配置文件的详细介绍。希望这份教程能帮助你更好地理解和使用该项目。