Wish-and-Dell/craft-glide

该包最新版本(2.0.2)没有提供许可信息。

通过Glide添加对Craft的按需图像转换支持

2.0.2 2024-05-18 14:18 UTC

This package is auto-updated.

Last update: 2024-09-18 15:15:32 UTC


README

使用PHP League的Glide 2.0对Craft CMS进行按需图像操作

注意:当前仅支持本地存储文件系统。

示例用法

<img src="/glide/myimage.jpg?w=100&h=200" alt="My Image" />

如果你的craft上传的资产是 mysite.com/assets/animage.jpg,则现在可以使用Glide在 mysite.com/glide/animage.jpg?w=100 进行渲染

有关支持的参数更多信息,请参阅 Glide网站

安装

composer require wishanddell/craft-glide

现在可以使用Glide通过以下方式渲染资产:

https://your-domain.com/path-to-craft/glide/{filename}

CDN / 高级用法

如果你有预算,我们强烈建议使用 Imgix 或类似服务。它与此插件类似,但有一些额外的好功能,并且所有响应都通过CDN提供。

此插件从未打算取代Imgix、Cloudinary等,而是针对预算更小、需要比Craft原生转换更多灵活性的项目。

应该可以使用你的域名作为源创建CDN分发,只需确保已启用查询字符串转发即可。

安全性

通过使用私钥签名每个请求,无法对URL参数进行更改。

创建文件 config/glide2.php,内容如下

<?php

return [
    'signed' => true,
    'key' => 'random-long-string',
];

然后你可以使用此服务生成URL

\wishanddell\glide\Plugin::getInstance()->render->url('image.jpg', ['w' => '100']);

或者使用Twig

<img src="{{ craft.glide.url('wedding.jpg', {w: 500}) }}" alt="My Image" />