Download the PHP package spacecatninja/imager-x-pdf-adapter without Composer

On this page you can find all versions of the php package spacecatninja/imager-x-pdf-adapter. 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?

Informations about the package imager-x-pdf-adapter

Imager X PDF Adapter plugin for Craft CMS

A plugin for transforming PDFs using Imager X.
Also, an example of how to make a custom file adapter for Imager X.

Requirements

This plugin requires Imager X 4.1+/5.0+, Craft CMS 4.0+/5.0+, PHP 8.0+ and Imagick with support for opening PDFs.

Support for opening PDFs, what does it mean?

As a start, it means that ghostscript needs to be installed on the server, and available to ImageMagick as a delegate format. It usually is.

Where you're more likely to encounter issues is that in some environments access to open PDFs may be restricted by your ImageMagick policy file. This is an XML file that sets the resource and security policy for ImageMagick, and in turn Imagick. On Ubuntu, it's located in /etc/ImageMagick-6/policy.xml (if you have ImageMagick 6, replace the 6 with 7 if that's what's installed), a google search will probably help you figure out where it is on your distro.

If you get an error (on your log or debug bar) saying something about PDFs and policy, you probably have this in that file:

Changing the rights to read|write:

Make sure to restart your webserver/php-fpm after making changes, or the old settings will be cached. If that didn't work there're more tips in this StackOverflow-thread that you can try.

Installation

To install the plugin, follow these instructions:

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

Usage

Install and configure the adapter as described below.

You can now transform PDF files simply by adding a PDF file to Imager's transformImage method:

You can pass configuration parameters to the adapter, using the adapterParams transform parameter:

You can also create the adapter as a separate step, with the advantage of being able to better control settings, and inspecting the PDF.

Auto generation

The PDF adapter works perfectly with the auto generation functionality in Imager. The only thing you need to do, is add pdf to the list of safe file formats to transform, using the config setting 'safeFileFormats'.

Configuring

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

defaultDensity [int]

Default: 144
Sets the default density/dpi to use when converting from pdf to bitmap image.

The higher the number, the larger the resulting file will be, and the better the quality. But it'll also require more resources, and opening PDFs is a resource intensive endeavour, so be careful.

defaultFormat [string]

Default: 'png'
Sets the default format of the temporary bitmap image that the adapter generates. You can of course transform this to whatever format you'd like later, using Imager.

cacheEnabled [bool]

Default: true
Enables/disables caching of generated images. Only disable this if testing, as it will seriously impact performance.

cacheDuration [bool|int]

Default: false
Sets the cacheDuration that's used if cacheEnabled is true. By default, forever. Clearing the Imager runtime cache will also clear this cache.

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.

All versions of imager-x-pdf-adapter with dependencies

PHP Build Version
Package Version
Requires php Version ^8.0.2
ext-imagick Version *
craftcms/cms Version ^4.0.0|^5.0.0-beta.1
spacecatninja/imager-x Version ^4.1.0|^5.0.0-beta.1
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-pdf-adapter contains the following files

Loading the files please wait ....