Git Product home page Git Product logo

flysystem-qcloud-cos-v4's Introduction

flysystem-qcloud-cos-v4

Software License Build Status Coverage Status Quality Score Packagist Version Total Downloads

This is a Flysystem adapter for the qcloud-cos-sdk-php v4.

腾讯云COS对象存储 V4

Attention

if you are a new registered user(after October 2016), v4 should be used.

2016年10月以后新注册的用户默认使用V4版本

if you have used COS before October 2016, v3 can continue to use.

2016年10月之前使用COS的用户可以继续使用V3版本

Installation

composer require freyo/flysystem-qcloud-cos-v4

Bootstrap

<?php
use Freyo\Flysystem\QcloudCOSv4\Adapter;
use League\Flysystem\Filesystem;

include __DIR__ . '/vendor/autoload.php';

$config = [
    'protocol' => 'http',
    'domain' => 'your-domain',
    'app_id' => 'your-app-id',
    'secret_id' => 'your-secret-id',
    'secret_key' => 'your-secret-key',
    'timeout' => 60,
    'bucket' => 'your-bucket-name',
    'region' => 'gz',
    'debug' => false,
];

$adapter = new Adapter($config);
$filesystem = new Filesystem($adapter);

API

bool $flysystem->write('file.md', 'contents');

bool $flysystem->writeStream('file.md', fopen('path/to/your/local/file.jpg', 'r'));

bool $flysystem->update('file.md', 'new contents');

bool $flysystem->updateStram('file.md', fopen('path/to/your/local/file.jpg', 'r'));

bool $flysystem->rename('foo.md', 'bar.md');

bool $flysystem->copy('foo.md', 'foo2.md');

bool $flysystem->delete('file.md');

bool $flysystem->has('file.md');

string|false $flysystem->read('file.md');

array $flysystem->listContents();

array $flysystem->getMetadata('file.md');

int $flysystem->getSize('file.md');

string $flysystem->getUrl('file.md'); 

string $flysystem->getTemporaryUrl('file.md', date_create('2018-12-31 18:12:31')); 

string $flysystem->getMimetype('file.md');

int $flysystem->getTimestamp('file.md');

string $flysystem->getVisibility('file.md');

bool $flysystem->setVisibility('file.md', 'public'); //or 'private'

Full API documentation.

Use in Laravel

Laravel 5.5 uses Package Auto-Discovery, so doesn't require you to manually add the ServiceProvider.

  1. Register the service provider in config/app.php:
'providers' => [
  // ...
  Freyo\Flysystem\QcloudCOSv4\ServiceProvider::class,
]
  1. Configure config/filesystems.php:
'disks'=>[
    // ...
    'cosv4' => [
        'driver' => 'cosv4',
        'protocol' => env('COSV4_PROTOCOL', 'http'),
        'domain' => env('COSV4_DOMAIN'),
        'app_id' => env('COSV4_APP_ID'),
        'secret_id' => env('COSV4_SECRET_ID'),
        'secret_key' => env('COSV4_SECRET_KEY'),
        'timeout' => env('COSV4_TIMEOUT', 60),
        'bucket' => env('COSV4_BUCKET'),
        'region' => env('COSV4_REGION', 'gz'),
        'debug' => env('COSV4_DEBUG', false),
    ],
],

Use in Lumen

  1. Add the following code to your bootstrap/app.php:
$app->singleton('filesystem', function ($app) {
    $app->alias('filesystem', Illuminate\Contracts\Filesystem\Factory::class);
    return $app->loadComponent(
        'filesystems',
        Illuminate\Filesystem\FilesystemServiceProvider::class,
        'filesystem'
    );
});
  1. And this:
$app->register(Freyo\Flysystem\QcloudCOSv4\ServiceProvider::class);
  1. Configure .env:
COSV4_PROTOCOL=http
COSV4_DOMAIN=
COSV4_APP_ID=
COSV4_SECRET_ID=
COSV4_SECRET_KEY=
COSV4_TIMEOUT=60
COSV4_BUCKET=
COSV4_REGION=gz
COSV4_DEBUG=true

Usage

$disk = Storage::disk('cosv4');

// create a file
$disk->put('avatars/1', $fileContents);

// check if a file exists
$exists = $disk->has('file.jpg');

// get timestamp
$time = $disk->lastModified('file1.jpg');

// copy a file
$disk->copy('old/file1.jpg', 'new/file1.jpg');

// move a file
$disk->move('old/file1.jpg', 'new/file1.jpg');

// get file contents
$contents = $disk->read('folder/my_file.txt');

// get url
$url = $disk->url('new/file1.jpg');
$temporaryUrl = $disk->temporaryUrl('new/file1.jpg', Carbon::now()->addMinutes(5));

// create a file from remote(plugin support)
$disk->putRemoteFile('avatars/1', 'http://example.org/avatar.jpg');
$disk->putRemoteFileAs('avatars/1', 'http://example.org/avatar.jpg', 'file1.jpg');

Full API documentation.

Region

地区 区域表示
华南 gz
华北 tj
华东 sh

flysystem-qcloud-cos-v4's People

Contributors

freyo avatar houxiaobei avatar scrutinizer-auto-fixer avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

flysystem-qcloud-cos-v4's Issues

Lumen支持说明

试了下 在 Lumen 里面也可以用 但是需要改点东西

app/helpers.php添加方法config_path

if (!function_exists('config_path')) {
    function config_path($path = '')
    {
        $path = trim($path);
        return app()->getConfigurationPath(dirname($path) . DIRECTORY_SEPARATOR . basename($path, '.php'));
    }
}

bootstrap/app.php注册单例filesystem

$app->singleton('filesystem', function ($app) {
    return $app->loadComponent(
        'filesystems',
        Illuminate\Filesystem\FilesystemServiceProvider::class,
        'filesystem'
    );
});

laravel5.4上传报错

在正常上传的时候,出现错误
You do not have permission to get URL '/files/v2/XXXXXXX0/XXXg-XXXXXX0/XXXXXXXXXXX40e5911.png' from this server.
有大佬在使用的过程中出现过这个问题吗

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.