spacecatninja / imager-x-imgix-download-transformer
Imager X 的 Imgix 下载转换器
Requires
- php: ^8.2
- craftcms/cms: ^5.0.0
- spacecatninja/imager-x: ^5.0.0-beta.1
This package is auto-updated.
Last update: 2024-09-06 15:00:13 UTC
README
这是一个为 Imager X 设计的转换器,它使用 Imgix 进行转换,但将转换后的图像本地存储。
需求
此插件需要 Craft CMS 5.0.0 或更高版本,Imager X 5.0.0 或更高版本,以及一个 Imgix 账户。
用法
此插件是默认的 craft
转换器(使用 GD 或 Imagick 在服务器上本地生成图像转换)和 imgix
转换器(使用 Imgix)之间的混合体。它使用 Imgix 进行图像转换,但将图像下载并存储在服务器上。
为什么不只使用 imgix
?可以节省一些费用。
为什么不只使用 craft
?可以节省大量的 CPU 周期和内存,而且不会受到服务器配置的限制。
所有配置都通过 Imager 的标准配置 完成,就像使用 craft
和 imgix
转换器时一样。此转换器将根据需要使用每个配置,因此如果您遇到问题,请测试您的配置是否适用于那些转换器。
要激活转换器,请将 transformer
配置设置 设置为 imgixdownload
'transformer' => 'imgixdownload',
注意事项、缺点和建议
不使用 Imgix 通过其 CDN 提供图像的最大缺点是,auto: format
现在不再工作。您将不得不手动提供不同的格式,最好使用 <picture>
,就像您使用本地转换时一样。
尽管转换不在服务器上完成,但在等待 Imgix 交付图像时仍会有一些延迟。因此,就像使用 craft
转换器一样,您将从为您的项目配置 自动生成转换 中受益。
外部存储 和 优化器 与此转换器的工作方式与 craft
完全相同。
Imager 将在提供图像时使用您的 imagerUrl
配置设置,因此您可以自由地 添加自己的拉取 CDN。
安装
要安装插件,请按照以下说明操作
- 通过在项目目录中运行
composer require spacecatninja/imager-x-imgix-download-transformer
使用 composer 安装。 - 在 Craft 控制面板的“设置”>“插件”下安装插件,或从命令行通过
./craft plugin/install imager-x-imgix-download-transformer
安装。
配置
此插件中目前没有任何配置项,所有配置都在 Imager X 配置 中完成。
价格、许可证和支持
该插件遵循MIT许可证发布。它需要Imager X,这是一个商业插件,可在Craft插件商店中找到(点击访问)。如果您需要帮助或发现了一个错误,请在本仓库或在Imager X的仓库中提交一个问题。