library qiniu-bundle

nnmer/qiniu-bundle

Symfony2(3) bundle integration with 七牛 (Qiniu) CDN service

This bundle aim is to help to work with 七牛 CDN service., _(*1)

The work on bundle is in process, the documentation will be updated respectively., _(*2)

Installation & Configuration

Note: this bundle doesn't provide any 七牛 frontend related code., _(*3)

1. Install: composer require nnmer/qiniu-bundle, _(*4)

2. Add bundle AppKernel.php :, _(*5)

 ...
 new Nnmer\QiniuBundle(),
 ...

1. Add bundle configuration at config.yml

nnmer_qiniu:
    accessKey: xxxxxxx
    secretKey: yyyyyyy
    defaultBucket: a1
    initiateAdapters:
        - gaufrette
    buckets: # is an array of the buckets, later each of them will be available as a service. Should be at least 1 provided
        - a1
        - b2

1. Add to you routing

qiniu_processing_results:
    resource: "@NnmerQiniuBundle/Controller/QiniuCallbackController.php"
    type:     annotation
    prefix:   /

1. if you are behind symfony's firewall, then add to your security.yml access_control section:

- { path: ^/qiniu-callback-url, role: IS_AUTHENTICATED_ANONYMOUSLY }
- { path: ^/qiniu-persistence-notify-url, role: IS_AUTHENTICATED_ANONYMOUSLY }

1. Done. From this point once you will receive a callback from Qiniu the 2 events can be raised, depends on the callback:

- QiniuEvents::FILE_UPLOADED - QiniuEvents::PERSISTENCE_RESULTS_RECEIVED, _(*6)

the content of the event is the payload of the callback, so you can process you logic by listening to this events and manage the payload data, _(*7)

Overwriting controller

If you want to have custom controller logic then do either: - extend QiniuCallbackController class (this will give you existing 2 callbacks defined) - implement QiniuCallbackControllerInterface interface (you will need to define the content for the controller's 2 callbacks methods), _(*8)

In this case remember to repoint routing definition to your content, or remove it if you manage routing definitions yourself, _(*9)

Available services

NOTE: bucket's name in services being renamed from original name: all - arereplaces by _, _(*10)

After container is built available next services:, _(*11)

nnmer_qiniu.*_service , where * is each of the buckets, _(*12)

and nnmer_qiniu.service which is alias to the service with defaultBucket, _(*13)

if KnpGaufretteBundle is installed and nnmer_qiniu.initiateAdapters has gaufrette as array element then additional next services will be generate:, _(*14)

nnmer_qiniu.gaufrette_*_adapter where * is each of the buckets, _(*15)

Twig helpers

downloadUrl(url, service) - to build a download link, signed and with time expiration. service is the id of the needed service. (in a controller the alias is $this->container->get('service id here')->getAuth()->privateDownloadUrl($url)), _(*16)