Download the PHP package imponeer/smarty-image without Composer
On this page you can find all versions of the php package imponeer/smarty-image. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download imponeer/smarty-image
More information about imponeer/smarty-image
Files in imponeer/smarty-image
Package smarty-image
Short Description Smarty plugin that adds some image related template syntax enchantments
License MIT
Informations about the package smarty-image
Smarty Image
A modern Smarty extension that provides image resizing capabilities with built-in caching. This extension allows you to resize images directly from your Smarty templates using the resized_image
function.
Installation
To install and use this package, we recommend to use Composer:
Otherwise, you need to include manually files from src/
directory.
Setup
Basic Setup
For Smarty v5 and newer, use the new extension system:
For older Smarty use v2.0 version of this plugin.
Using with Symfony Container
When using Symfony's dependency injection container, you can register the extension as a service:
Then inject it into your Smarty instance:
Using with PHP-DI
With PHP-DI container, configure the extension in your container definitions:
Using with League Container
With League Container, register the services like this:
Usage
To resize images from Smarty templates, you can use the resized_image
function:
This function supports such arguments:
Argument | Required | Default value | Description |
---|---|---|---|
file |
yes | Image file to resize | |
width |
if height is not specified |
Resized image width | |
height |
if width is not specified |
Resized image height | |
fit |
no | outside |
Method used for resize. Supported fill , inside , outside |
href or link |
no | if specified and return is set to image , will output generated HTML as image with link to this specific location |
|
basedir |
no | $_SERVER['DOCUMENT_ROOT'] | Base dir where to look for image files |
return |
no | image |
Returns result as HTML tag if value is image , or as resized image URI if value is url . |
All extra arguments will be rendered into image tag, if return mode is image
.
Development
This project uses modern PHP development tools and practices:
Running Tests
Code Style
The project follows PSR-12 coding standards. Check code style with:
Fix code style issues automatically:
Static Analysis
Run PHPStan for static code analysis:
Documentation
API documentation is automatically generated and available in the project's wiki. For more detailed information about the classes and methods, please refer to the project wiki.
How to contribute?
We welcome contributions! If you want to add functionality or fix bugs:
- Fork the repository
- Create a feature branch from
main
- Make your changes following the coding standards
- Add or update tests as needed
- Run the test suite to ensure everything works
- Submit a pull request with a clear description of your changes
For bug reports or feature requests, please use the issues tab and provide as much detail as possible.
All versions of smarty-image with dependencies
smarty/smarty Version ^5.0
intervention/image Version ^3
psr/cache Version ^3.0
ext-json Version *
ext-gd Version *