Download the PHP package x000000/storage-manager without Composer
On this page you can find all versions of the php package x000000/storage-manager. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download x000000/storage-manager
More information about x000000/storage-manager
Files in x000000/storage-manager
Package storage-manager
Short Description Storage manager with thumbnails support
License MIT
Informations about the package storage-manager
Storage Manager
This project is a PHP library written to make uploading and storing files as easy as possible. And it can make thumbnails you want.
Requirements & Dependency
The library has the following requirements:
- PHP 5.6+
- The library has a single dependency - Imagine. This only needed if you what to make thumbnails with storage-manager.
Installation
The preferred way to install this library is through composer.
Either run
or add
to the require section of your composer.json.
Usage
Storing
First of all you need to instantiate Storage object:
Now we need to store some files there.
We can make it either with $storage->processFile()
and passing full path to the file we want to store:
or if you want to process newly uploaded file you can use $storage->processUploadedFile()
and passing an item from $_FILES array:
Now if everything is fine we have $image
stored in $baseDir
and renamed with it md5 content accordingly.
For example it could be something like aed0d71a5adaff3a43b75fb4ccc7ff48.png
.
Yes, we've lost it original name, but we do not store duplicates either.
After successful storing file on your physical disk, you may want to save it to the database too.
And you do not have to save a full path to the file, you may save only a file name - $image
.
Displaying
Now you may want to display an $image
or just share a link to it:
That's it. By calling $storage->getSource()
we can get a full url (domain not included) to the source file (not only images).
Thumbnails
There are use-cases when you do not want to display an original $image
.
Or you want to display a nice square thumbnail (hello Instagram). Or just resized/watermarked $image
.
To make it possible there is a helper method $storage->thumb()
:
For now, there are only resize and crop supported,
but you can use your own image transforms. For more info see Transform::add()
.