survos/bunny-bundle

Symfony bundle for interacting with BunnyCDN using https://github.com/ToshY/BunnyNet-PHP

1.5.333 2024-09-20 16:36 UTC

Requires

• php: ^8.2
• endroid/installer: ^1.4
• symfony/config: ^6.4 || ^7.0
• symfony/dependency-injection: ^6.4 || ^7.0
• symfony/http-kernel: ^6.4 || ^7.0
• toshy/bunnynet-php: ^4.4
• twig/twig: ^3.4
• zenstruck/console-extra: ^1.4

Requires (Dev)

• phpstan/phpstan: ^1.10
• survos/simple-datatables-bundle: ^1.5.333
• symfony/browser-kit: ^6.4 || ^7.0
• symfony/framework-bundle: ^6.4 || ^7.0
• symfony/phpunit-bridge: ^6.4 || ^7.0
• symfony/twig-bundle: ^6.4 || ^7.0
• symfony/var-dumper: ^6.4 || ^7.0

Suggests

• survos/simple-datatables-bundle: searchable/sortable tables when browsing

MIT

• symfony
• symfony-ux

README

A Symfony bundle to interact with BunnyCDN via the Bunny-PHP library.

Still under development, feedback welcome!

Quickstart

symfony new bunny-demo --webapp && cd bunny-demo
composer require survos/bunny-bundle

Installation

Go to https://dash.bunny.net/account/api-key and get the main api key. You should create at least one zone, as the bundle does not support creating zones.

Create a new Symfony project.

symfony new bunny-demo --webapp && cd bunny-demo
composer require survos/bunny-bundle
0df72e6f-01e3-44c8-801f-fa502b302179
bin/console bunny:config <api-key> >> .env.local 
bin/console bunny:list

You can browse interactively with the basic admin controller.

composer require survos/simple-datatables-bundle
symfony server:start -d
symfony open:local --path=/bunny/zones

Or edit .env.local and add your API key.

As each storage zone has its own passwords and id, these need to be configured individually in survos_bunny.yaml. Rather than tediously configuring each zone by cutting and pasting, we can use the first utility to dump the configuration with just the main api key. This saves you from having to go to https://dash.bunny.net/storage and go to each storage zone, then click on it and select "FTP and ApiAccess" and selecting each key.

bin/console bunny:config <api-key> 

Note: use --filter to limit to the zones to a regex (@todo)

You can skip passing the api key on the command line by defining it as an environment variable, etc.

echo "BUNNY_API_KEY=api-key >> .env.local

This command dumps the packages/config/survos_bunny.yaml file with references to the environment variables, which are also dumped and should be added to .env.local. If your application only reads from bunny, you can remove the password environment variables, it is only used during writing. You can also remove the main api key if your application doesn't need it in production.

Open .env.local and replace the values.

Your application now has a bare-bones controller located at /admin/bunny, you may want to secure this route in security.yaml, or configure it in config/routes/survos_bunny.yaml.

You also have access to a command line interface.

bin/console bunny:list 

+------------- museado/ -----+--------+
| ObjectName     | Path      | Length |
+----------------+-----------+--------+
| photos finales | /museado/ | 0      |
+----------------+-----------+--------+