Download the PHP package spacecatninja/imager-x-bunny-transformer without Composer

On this page you can find all versions of the php package spacecatninja/imager-x-bunny-transformer. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of spacecatninja/imager-x-bunny-transformer

Informations about the package imager-x-bunny-transformer

Bunny.net transformer for Imager X

A plugin for using Bunny.net Optimizer as a transformer in Imager X.
Also, an example of how to make a custom transformer for Imager X.

Requirements

This plugin requires Craft CMS 5.0.0 or later, Imager X 5.0.0 or later, and an account at bunny.net.

Usage

Install and configure this transformer as described below. Then, in your Imager X config, set the transformer to bunny, ie:

Transforms are now by default transformed with bunny.net, test your configuration with a simple transform like this:

If this doesn't work, make sure you've configured a defaultProfile, have a profile with the correct name, and that the pull zone is set up to point to the location of your asset volume.

Cave-ats, shortcomings, and tips

This transformer only supports a subset of what Imager X can do when using the default craft transformer. The Bunny.net API is very limited, and essentially just supports resizing using crop and fit resize modes. Width, height, ratio, quality and format, is automatically converted from the standard Imager parameters, while the rest of the additional options can be passed directly to Bunny using the transformerParams transform parameter. Example:

For more information, check out the Bunny.net Optimizer documentation.

Installation

To install the plugin, follow these instructions:

  1. Install with composer via composer require spacecatninja/imager-x-bunny-transformer from your project directory.
  2. Install the plugin in the Craft Control Panel under Settings > Plugins, or from the command line via ./craft plugin/install imager-x-bunny-transformer.

Configuration

You can configure the transformer by creating a file in your config folder called imager-x-bunny-transformer.php, and override settings as needed.

profiles [array]

Default: []
Profiles are usually a one-to-one mapping to the pull zones you've created in Bunny.net. You must the default profile to use using the defaultProfile config setting, and can override it at the template level by setting profile in your transformerParams.

Example profile:

Each profile takes the following settings:

hostname: This is the Hostname for your zone.

addPath: Prepends a path to the asset's path. Can be useful if you have several volumes that you want to serve with one Bunny.net zone. If this setting is an array, the key should be the volume handle, and the value the path to add. See example above.

useCloudSourcePath: If enabled, Imager will prepend the Craft source path to the asset path, before adding it to the Bunny.net path. This makes it possible to have one Bunny zone pulling images from many Craft volumes when they are for instance on the same S3 bucket, but in different subfolder. This only works on volumes that implements a path setting (AWS S3 and GCS does, local volumes does not).

defaultParams: An array of default parameters that you want passed to all of your Bunny transforms. Example:

💡 Any default parameter added to a profile can be overridden per-transform, via the transformerParams transform parameter.

apiKey: A Bunny.net API key for this specific profile, used for cache purging. If set, it takes precedence over the top-level apiKey setting. See Purging below.

excludeFromPurge: Set to true to exclude this profile from cache purging. Default is false.

defaultProfile [string]

Default: ''
Sets the default profile to use (see profiles). You can override profile at the transform level by setting it through the transformParams transform parameter. Example:

apiKey [string]

Default: ''
A global Bunny.net API key used for cache purging across all profiles. Can be overridden per-profile using the apiKey profile setting. See Purging below.

autoPurge [bool]

Default: false
When enabled, assets are automatically purged from the Bunny CDN cache when they are replaced, deleted, or moved in Craft. Requires at least one profile to have a valid API key (either via the top-level apiKey setting or the profile's own apiKey).

purgeElementAction [bool]

Default: true
When enabled, a "Purge from Bunny" action is added to the asset index element actions menu, allowing editors to manually purge selected images from the Bunny CDN cache. Requires at least one profile to have a valid API key.

Purging

The plugin supports purging assets from the Bunny CDN cache in two ways:

Automatic purging — enabled via the autoPurge config setting. When active, assets are purged automatically when replaced, deleted, or moved in Craft (the latter requires removeTransformsOnAssetFileops to be enabled in your Imager X config).

Manual purging via element action — enabled via the purgeElementAction config setting (on by default). Adds a "Purge from Bunny" option to the actions menu in the asset index, letting editors selectively purge images on demand.

To enable purging, you need a Bunny.net API key. Set it globally via the top-level apiKey config setting, or per-profile using the apiKey profile setting. Profiles can be excluded from purging individually using excludeFromPurge.

A minimal purge-enabled config looks like this:

Price, license and support

The plugin is released under the MIT license. It requires Imager X, which is a commercial plugin available in the Craft plugin store. If you need help, or found a bug, please post an issue in this repo, or in Imager X' repo (preferably).

All versions of imager-x-bunny-transformer with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
craftcms/cms Version ^5.0.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package spacecatninja/imager-x-bunny-transformer contains the following files

Loading the files please wait ...