evertecdigital/imageflex
Composer 安装命令:
composer require evertecdigital/imageflex
包简介
Dynamic Image Resizer Manager
关键字:
README 文档
README
ImageFlex é uma classe PHP para gerenciamento e manipulação de imagens usando a biblioteca GD. Ela permite redimensionar imagens, adicionar marcas d'água e preservar a transparência das imagens originais.
Funcionalidades
- Redimensionar imagens mantendo a proporção original
- Adicionar marcas d'água com posição e opacidade configuráveis
- Preservar a transparência de imagens PNG e GIF
- Suporte a vários formatos de imagem: JPEG, PNG, GIF, e WEBP
- Sistema de cache para melhorar o desempenho
Requisitos
- PHP 7.4 ou superior
- Extensão GD habilitada no PHP
Instalação
Via composer
"evertecdigital/imageflex": "1.0.*"
ou execute
composer require evertecdigital/imageflex
Uso
Configurações Básicas
// Inclua a classe imageflex require_once 'imageflex.php'; // Configure a classe imageflex imageflex::setOutputFormat('auto'); // Formato de saída automático (igual ao da imagem original) imageflex::setQuality(85); // Qualidade de 85 para imagens JPEG e WEBP imageflex::setCompression(6); // Nível de compressão de 6 para imagens PNG $imagePath = 'images/example.jpg'; // Redimensione a imagem $resizedImagePath = imageflex::resize($imagePath, 800, 600); if ($resizedImagePath) { echo 'Imagem redimensionada e salva em: ' . $resizedImagePath; } else { echo 'Erro ao redimensionar a imagem: ' . implode(', ', imageflex::getErrors()); }
Diretamente na tag HTML
Simplifique utilizando diretamente na tag HTML.
<img src="<?= imageflex::resize($imagePath, 800, 600);?>">
Adicionar Marca d'Água
$watermarkPath = 'images/watermark.png'; // Configure a marca d'água imageflex::setWatermark($watermarkPath); // Defina a imagem da marca d'água imageflex::setWatermarkOpacity(50); // Defina a opacidade da marca d'água para 50% imageflex::setWatermarkPosition('bottom right'); // Defina a posição da marca d'água para canto inferior direito // Redimensione a imagem e aplique a marca d'água $resizedImagePath = imageflex::resize($imagePath, 800, 600); if ($resizedImagePath) { echo 'Imagem redimensionada e salva em: ' . $resizedImagePath; } else { echo 'Erro ao redimensionar a imagem: ' . implode(', ', imageflex::getErrors()); }
Limpar Cache
Se necessário, podera criar uma rotina para limpar a pasta de cache periodicamente.
// Limpar todas as imagens em cache imageflex::clearCache();
Métodos Disponíveis
| Metódo | Parâmetro | Descrição |
|---|---|---|
setOutputDir($dir) |
string | Diretório para armazenamento das thumbs |
setOutputFormat($format) |
string $format (opções: 'auto', 'jpg', 'png', 'webp', 'gif') | Define o formato de saída para as imagens redimensionadas. |
setQuality($quality) |
int $quality (0-100) | Define o nível de qualidade para as imagens JPEG e WEBP. |
setCompression($compression) |
int $compression (0-9) | Define o nível de compressão para as imagens PNG. |
setWatermark($watermarkPath) |
string $watermarkPath (caminho para a imagem da marca d'água) | Define a imagem da marca d'água. |
setWatermarkOpacity($opacity) |
int $opacity (0-100) | Define a opacidade da marca d'água. |
setWatermarkPosition($position) |
string $position (opções: 'top left', 'top', 'center', 'top right', 'middle left', 'middle center', 'middle right', 'bottom left', 'bottom center', 'bottom right') | Define a posição da marca d'água. |
resize($imagePath, $width, $height = null) |
string $imagePath (caminho para a imagem original) int $width (largura desejada) int OR null $height (altura desejada, opcional) | Redimensiona uma imagem e salva a versão redimensionada no diretório de cache. |
clearCache() |
- | Limpa todas as imagens em cache. |
getErrors() |
- | Retorna um array de mensagens de erro encontradas durante as operações. Retorno: array |
Contribuição
Por favor, veja CONTRIBUIÇÃO para maiores detalhes.
Creditos
- Everson Aguiar (Desenvolvedor)
- Evertec Digital (Business)
- All Contributors (This Project)
Licença
A licença MIT (MIT). Consulte Arquivo de Licença para obter mais informações.
evertecdigital/imageflex 适用场景与选型建议
evertecdigital/imageflex 是一款 基于 PHP 开发的 Composer 扩展包,目前已累计 8 次下载、GitHub Stars 达 3, 最近一次更新时间为 2024 年 07 月 02 日, 在 PHP 生态内属于活跃度较高的组件。
它主要适用于以下技术方向: 「image」 「resize」 「gd」 「watermark」 「image cache」 「image crop」 等业务场景。在实际项目中,围绕这些方向常见需要落地的问题包括:接口对接、性能调优、并发安全、与既有框架(Laravel / ThinkPHP / Yii / Webman 等)的兼容适配,以及生产环境的日志埋点与稳定性保障。
我们在过去多个企业项目中使用过 evertecdigital/imageflex 或与其功能相近的方案,如果你在选型或落地过程中遇到问题,例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查,欢迎联系我们协助评估。
基于 evertecdigital/imageflex 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。
线上偶发问题、内存泄漏、慢查询、并发异常等排查修复;针对高流量场景做缓存、队列、索引层面的调优。
承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维;也可按月提供技术保姆服务。
与 evertecdigital/imageflex 相关的其它包
同方向 / 同关键字的高下载量 PHP Composer 包推荐,方便对比选型:
Powerful PHP class using GD library to work easily with images including layer notion (like Photoshop or GIMP)
Yii2 LightBox image galary widget uses Lightbox v2.10.0 by Lokesh Dhakar
The Yii2 extension uses jQuery jquery.carousel-1.1.min.js and makes image carousel from php array of structure defined.
Powerful PHP class using GD library to work easily with images including layer notion (like Photoshop or GIMP)
Image cache
Image manipulation library for Laravel 8 based on Imagine and inspired by Croppa for easy url based manipulation
统计信息
- 总下载量: 8
- 月度下载量: 0
- 日度下载量: 0
- 收藏数: 5
- 点击次数: 21
- 依赖项目数: 0
- 推荐数: 0
其他信息
- 授权协议: MIT
- 更新时间: 2024-07-02