搜索wineworlds / image-on-demand-service
一款为提供按需图像处理服务的TYPO3扩展。
Requires
- typo3/cms-core: ^11.5.26 || ^12.4 || dev-main
- typo3/cms-extbase: ^11.5.26 || ^12.4 || dev-main
This package is auto-updated.
Last update: 2024-09-08 22:36:00 UTC
README
按需图像服务是一款为TYPO3网站提供按需图像处理服务的TYPO3扩展。它允许您根据特定请求动态处理和生成图像。
特性
- 即时图像处理。
- 动态调整图像大小和格式。
安装
扩展可以使用Composer轻松安装，并在Packagist上可用。
- 使用Composer安装扩展
composer require wineworlds/image-on-demand-service
- 在TYPO3后端激活扩展。
用法
Image on Demand Service扩展会自动处理符合特定URL模式的请求图像。它使用ImageOnDemandMiddleware类来处理图像请求。当图像请求URL与指定的模式匹配时，中间件会处理请求并提供处理后的图像。
URL模式（1.1.0）
图像请求的URL模式为：/image-service/{width}/{height}/{filename}?id={fileReferenceId}&type={format}&crop={cropVariant}&text={dummyImageText}&bgColor={dummyImageBgColor}&textColor={dummyImageTextColor}
filename在缓存中不考虑。
URL模式（1.0.3）
图像请求的URL模式为：/image-service/{fileId}/{width}/{height}/{format}/{filename}
fileReferenceId：要处理的文件引用的唯一ID。width：处理图像所需的宽度。TYPO3文档图像宽度height：处理图像所需的高度。TYPO3文档图像高度format：处理图像所需的格式（文件扩展名）。TYPO3文档GFX文件扩展名filename：图像文件的名称（用于SEO友好的URL）。
例如：/image-service/123/300c/200c/jpeg/my-seo-friendly-image.jpeg将请求一个ID为123的图像，宽度为300c像素，高度为200c像素，以JPEG格式保存，文件名为"my-seo-friendly-image.jpeg"。
如果请求的图像找不到或处理过程中发生错误，将返回一个占位符"Image Not Found"图像。
贡献者
- Kubilay Melnikov - 开发者
许可证
此TYPO3扩展受MIT许可证的许可。