Download the PHP package czim/file-handling without Composer
On this page you can find all versions of the php package czim/file-handling. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package file-handling
File Handling and Storage Helper
Handles uploads, manipulations and (external) storage
Changelog
View the changelog.
Usage
This package is framework-independent.
Here's an example of how to set up variant processing in general:
For Laravel, you could use the following framework specific storage implementation:
It is recommended of course to use the dependency container / IoC solution of your framework to simplify the above approach.
Custom Container
If you don't have a feasible PSR-11 container available, you can use a very simple implementation provided with this package.
Storage
Files can be stored using customizable storage implementations.
A very simple adapter/decorator for the Laravel storage is provided.
For any other framework/setup you will (for now) have to write your own implementation of the \Czim\FileHandling\Contracts\Storage\StorageInterface
.
Variants
When a file is processed, variants can be created automatically and stored along with the original.
These can be resizes, crops or recolors of the original image. This package is set up to allow you to easily create your own strategies for making variants.
A single variant is defined by one or more strategy steps, making it possible to combine effects and re-use strategies.
Variants can be re-created from the original.
Note that it this package is designed to easily create and add in custom variant strategies. Consider the source code for the strategies listed below examples to get you started.
Image Strategies
Included strategies for image manipulation:
-
ImageAutoOrientStrategy
: Re-orients rotated or flipped images. -
ImageResizeStrategy
: Resizes (and crops) images.
(Uses Stapler's options & approach to resizes.) -
ImageWatermarkStrategy
: Pastes a watermark onto an image.
In any corner or the center.
Options:
position
(string):top-left
,top-right
,center
,bottom-left
,bottom-right
.
watermark
(string): full path to the watermark image.
The watermark should be a PNG (transparent) image for best results. -
ImageOptimizationStrategy
Optimizes images to decreate their file size.This strategy requires installation of spatie/image-optimizer.
In order for it to work, you'll need to install a few image optimizers as well:
jpegoptim
optipng
pngquant
svgo
gifsicle
Installation example for Ubuntu:
Installation example for MacOS, using Homebrew:
Video Strategies
Included strategies for video manipulation:
VideoScreenshotStrategy
: Extracts a video frame for a preview.
(Requiresffmpeg
/ffprobe
).
Options:
seconds
(int): the second of video runtime to take the shot at.
percentage
(int): the percentage of video runtime to take the shot at (overruled byseconds
).ffmpeg
(string): path to ffmpeg binary (if not/usr/bin/ffmpeg
).ffprobe
(string): path to ffprobe binary (if not/usr/bin/ffprobe
).
Variant Gotcha
When using the resize strategy while working with potentially EXIF-rotated images, keep in mind that portrait/landscape width/height only resizes may run into trouble unless they are auto-oriented first.
For this reason, it is recommended to precede the ImageResizeStrategy
by the ImageAutoOrientStrategy
.
In general, it is always a good idea to consider the order in which strategies are applied.
You may also opt to combine multiple strategies into one strategy class, if efficiency is important. You may use this approach to prevent opening/saving the same file more than once.
Handling URI content
In previous versions, this package automatically retrieved content from raw string content with URIs to local or remote files. This has now been disabled by default to minimize security risks.
For more information on this change, see SECURITY for more information.
Configuration
Configuration of file handling is set by injecting an associative array with a tree structure into the FileHandler.
Contributing
Please see CONTRIBUTING for details.
Credits
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of file-handling with dependencies
imagine/imagine Version ^1.2
myclabs/php-enum Version ^1.4
psr/container Version ^1.0
symfony/http-foundation Version ^3.0|^4.0|^5.0
ext-curl Version *