chipk4/selectel

Laravel 包,用于 Selectel API 云存储(selectel.com)

v0.4 2017-03-26 11:48 UTC

This package is not auto-updated.

Last update: 2024-09-20 20:21:13 UTC


README

GitHub release Software License

此包提供了一种简单的方法将 Selectel 云存储 API 集成到 Laravel 5 中。以下是您可以使用此包做一些示例操作的说明

SelectelApi::storageInfo();

//You may use virtual folders like 'newFolder/newFileName.jpg'
SelectelApi::storeFile('container', 'filePath/1243.jpg', 'newFileName.jpg')

SelectelApi::containerInfo('your_container')

SelectelApi::storageContainerList()

/*
* You can use private or public container type
* Public container present by default
* For private container use 
*/
SelectelApi::getFile('container', 'fileName', true);
//For public container
SelectelApi::getFile('container', 'fileName');

SelectelApi::containerFileList('container_name');

//If you want to do something else, you can get an instance of the underlying API:
SelectelApi::getApi();

安装

您可以通过 Composer 使用以下命令安装此包

composer require chipk4/selectel

您还必须安装此服务提供者。

// config/app.php
'providers' => [
    ...
    Chipk4\Selectel\SelectelApiServiceProvider::class,
    ...
];

如果您想使用外观(facade),您也必须安装它。

// config/app.php
'aliases' => [
    ..
    'SelectelApi' => Chipk4\Selectel\SelectelApiFacade::class,
];

要发布配置文件到 app/config/selectel-api.php,请运行

php artisan vendor:publish --provider="Chipk4\Selectel\SelectelApiServiceProvider"

这将发布一个位于您的配置目录中的 selectel-api.php 文件,其内容如下

return [
    /*
     * This is agreement number from system
     */
    'authUser' => env('SELECTEL_LOGIN'),

    /*
     * Password for cloud storage service.
     * Note: it's different with account password
     */
    'authKey' => env('SELECTEL_PASSWORD'),

    /*
     * API url
     */
    'apiUrl' => 'https://auth.selcdn.ru/',

    /*
     * Default value for request timeout
     */
    'timeout' => 10,

    /*
     * Default storage url
     */
    'storageUrl' => env('SELECTEL_STORAGE_URL', ''),

    /*
     * Response view
     * Can be in json or xml
     */
    'returnView' => env('SELECTEL_RETURN_VIEW', 'json'),
    
];

使用方法

使用外观(Facade)

  use SelectelApi;
  
  SelectelApi::getFile('container', 'fileName');

使用服务容器

    use Chipk4\Selectel\CloudStorage;
    
    public function test(CloudStorage $storage) 
    {
        $storage->getFile('container', 'fileName');
    }

许可证

MIT 许可证(MIT)。请参阅 许可证文件 获取更多信息。