README

php-thumber是一个用于动态创建缩略图的PHP库，并实现了缩略图的文件缓存。它使用intervention/image作为包装器。

你喜欢这个插件吗？它的开发需要我花费大量时间。请考虑捐赠的可能性：一杯咖啡就足够了！谢谢。

• 要求和支持的格式
• 安装和配置
  • 旧版PHP版本上的安装
    • 对于PHP 7.4或更高版本
    • 对于PHP 7.2或更高版本
    • 对于PHP 5.6或更高版本
• 如何使用
• 测试
• 版本控制

要求和支持的格式

php-thumber需要GD库(>=2.0) 或 Imagick PHP扩展(>=6.5.7)。

使用Imagick是非常推荐的，因为它提供更好的性能和更多的支持格式。

支持的格式可能因所使用的库而异。

有关支持的格式的更多信息，请参阅Intervention Image文档。

安装和配置

您可以通过composer安装此插件

$ composer require --prefer-dist mirko-pagliai/php-thumber

因此，在使用库之前，可能需要配置一些常量

• THUMBER_DRIVER：您想要用于创建缩略图的驱动。有效的值是imagick或gd；
• THUMBER_TARGET：创建缩略图的完整路径目录（因此您必须创建此目录并使其可写）。

示例

define('THUMBER_DRIVER', 'imagick');
define('THUMBER_TARGET', '/tmp/php-thumber');

否则，您可以包含/引入config/bootstrap.php文件，该文件将自动确定要使用的驱动程序，并设置创建缩略图的临时目录（在Unix环境中，它将是/tmp/php-thumber）。

旧版PHP版本上的安装

最近发布的包和主分支需要至少PHP 7.4，当前代码开发基于这些和后续版本的PHP。然而，还有一些分支与之前的PHP版本兼容。

对于PHP 7.4或更高版本

php7.4分支需要至少PHP 7.4。

在这种情况下，您也可以安装该包

$ composer require --prefer-dist mirko-pagliai/php-thumber:dev-php7.4

请注意，从2024年1月5日起，php7.4分支将不再更新，除非是安全补丁，它与1.5.5版本相匹配。

对于PHP 7.2或更高版本

php7.2分支需要至少PHP 7.2。

在这种情况下，您也可以安装该包

$ composer require --prefer-dist mirko-pagliai/php-thumber:dev-php7.2

请注意，从2022年4月28日起，php7.2分支将不再更新，除非是安全补丁，它与1.4.3版本相匹配。

对于PHP 5.6或更高版本

php5.6分支需要至少PHP 5.6。

在这种情况下，您也可以安装该包

$ composer require --prefer-dist mirko-pagliai/php-thumber:dev-php5.6

请注意，从2021年4月22日起，php5.6分支将不再更新，除非是安全补丁，它与1.2.3版本相匹配。

如何使用

查看我们的wiki

• 如何使用ThumbCreator创建缩略图.

请参阅我们的API。

测试

一些测试属于imageEquals组。这些测试会生成缩略图并与预加载的缩略图（位于tests/examples/comparing_files）进行比较。默认情况下，这些测试不会执行，因为如果从不同的环境和系统生成，图像可能不同。

要排除这些测试，你应该运行

vendor/bin/phpunit --exclude-group imageEquals

版本控制

为了透明度和对我们发布周期的洞察，同时保持向后兼容性，php-thumber将根据语义化版本控制指南进行维护。