filejet/filejet-bundle

Symfony bundle for FileJet service

FileJet bundle

Provides seamless integration of FileJet service with your Symfony based project.

For plain PHP library and FileJet documentation visit filejet/filejet-php repository.

Installation

You can install FileJet bundle easily via Composer:

composer require filejet/filejet-bundle ^2.3

We recommend to install following pachages before installing FileJet bundle if you don't already have installed any HTTPlug compatible packages:

composer require php-http/guzzle6-adapter ^1.1
composer require php-http/message ^1.6

After installation register the bundle with Symfony's bundles system.

Upgrading the bundle

We recommend upgrade the bundle with --with-dependencies option:

composer update filejet/filejet-bundle --with-dependencies

Configuration

You need to provide API key and Storage ID within your config file:

file_jet:
    storage_id: <your storage id>
    api_key: <your api key>
    signature_secret: <your signature secret> # optional - needed for usage with external files
    auto_mode: true/false # defaults to true
    custom_domain: <your custom domain> # optional, without scheme, e.g. cdn.example.com

More about Auto optimization mode.

Usage

Bundle provides a Twig extension for generating the public and private (signed) URLs of your files.

file_url(publicFile, 'resize_100_100')
external_file_url(publiclyAccessibleImageUrl, 'resize_100_100')
private_file_url(privateFileIdentifier, expiresInSeconds)

file_url accepts object which needs to implement FileJet\FileInterface interface. As second argument you can optionally provide mutation string (if you want to generate URL of image) - see mutations documentation

external_file_url accepts URL of publicly accessible image as first argument and mutation as second one.

private_file_url accepts file identifier string as first argument and number of seconds the signed URL will be valid. The function internaly contacts FileJet API and returns signed URL for private files. This function can be used for files with sensitive information because the file is not publicly accessible the download link is valid only for the selected time period and then it expires. Each call of this function is contacting FileJet API hence the function cam be quite costly.

Bundle also provides @FileJet\FileJet service which is automatically wired to the Symfony's container. The documentation can be found at filejet/filejet-php.

filejet-bundle's Issues

bug: invalid asset url when mutation is empty and auto mode is on

https://github.com/filejet/filejet-bundle/blob/master/src/Twig/FileJetExtension.php#L40

public function getAsset(string $path, string $mutation = null): string
    {
        $mutation = empty($mutation) ? '' : "/${mutation}";
        $mutation .= $this->config->isAutoMode() ? ',auto' : '';
        $originPath = urlencode("{$this->config->getBaseUrl()}{$path}");

        return "{$this->config->getPublicUrl()}/ext{$mutation}?src={$originPath}";
    }

should looks like e.g

public function getAsset(string $path, string $mutation = null): string
    {
        $parts = [];

        if($mutation) {
            $parts[] = $mutation;
        }

        if($this->config->isAutoMode()) {
            $parts[] = 'auto';
        }

        $finalMutation = !empty($parts) ? "/" . implode(',', $parts) : '';
        $originPath = urlencode("{$this->config->getBaseUrl()}{$path}");

        return "{$this->config->getPublicUrl()}/ext{$finalMutation}?src={$originPath}";
    }