README

使用#php_imagine 标签来推特分享。

PHP 5.3 的图像处理库，灵感来源于 Python 的 PIL 和其他图像库。

需求

Imagine 库有以下需求

PHP 5.3+

根据选择的图像实现，可能需要以下 PHP 扩展之一

GD2
Imagick（需要 ImageMagick 版本 6.2.9 或更高版本，但不是版本 7.0.7-32）
Gmagick

要读取 EXIF 元数据（例如，用于自动旋转），请激活 PHP 的 exif 扩展。这是可选的：Imagine 不需要 PHP 的 exif 扩展也能工作，但那时它无法读取和操作图像方向或其他 EXIF 元数据。

使用 composer 安装

php composer.phar require imagine/imagine

基本原理

Imagine 的主要目的是提供所有必要的功能，以将所有原生低级图像处理库在 PHP 中统一到简单直观的 OO API。

为了实现这一点，需要以下几个要素

图像处理工具，如调整大小、裁剪等。
绘图 API - 创建基本形状和高级图表，在图像上写文字
遮罩功能 - 能够将黑白或灰度图像作为遮罩应用，导致被遮罩图像的半透明或绝对透明

上述工具应该是称为 Imagine 中 Filters 的更强大工具集的基本基础。

一些即将推出的过滤器的想法

图表和图形过滤器 - 饼图和条形图，带注释的线性图
反射 - 苹果风格
圆角 - 网页 2.0

文档

由 Read The Docs 托管

演示文稿

文章

使用 Imagine 进行图像处理

贡献

分支

新的拉取请求应基于 develop 分支。 master 分支是稳定分支：它通常与最新版本匹配，但有时会略微领先。

测试组

一些 PHPUnit 测试被标记为跳过（例如，需要支持多个层的驱动程序并使用 GD 驱动程序执行的测试）。此外，如果您没有安装 gmagick，gmagick 测试将被标记为跳过。

如果您不想运行标记为“始终跳过”的测试，可以向 PHPUnit 指定排除 always-skipped 组。同样，对于需要特定驱动程序（gd、imagick）的测试也是如此。

因此，例如，要排除 always-skipped 和 gmagick 测试，可以使用以下命令选项启动 phpunit

composer run test -- --exclude-group always-skipped,gmagick

开发环境

设置包含所有必需库的环境可能非常困难。为了在本地运行测试，可以使用 Imagine 用于测试拉取请求的相同 docker 图像。

例如，如果您将 Imagine 本地放在 /home/me/imagine 文件夹中，您可以使用以下非常简单的方法运行 PHP 8.1 的测试，同时使用 GD 和 Imagick

使用以下命令启动临时 docker 容器

docker run --rm -it -v /home/me/imagine:/app -w /app ghcr.io/php-imagine/test:8.1-gd-imagick bash

在 docker 容器内部，运行以下命令

# Start a local web server: some tests require it
cd tests
php -n -S 0.0.0.0:8013 >/dev/null 2>&1 &
cd ..
# Tell the tests that the local web server is available at the port 8013
export IMAGINE_TEST_WEBSERVERURL=http://localhost:8013
# Install the composer dependencies
composer update
# Run the tests
composer run test -- --exclude-group always-skipped,gmagick

注意：这种方法也适用于Windows：只需使用以下命令启动docker容器
docker run --rm -it -v C:\Path\To\Imagine:/app -w /app ghcr.io/php-imagine/test:8.1-gd-imagick bash

构建测试文件

许多测试会在tests/tmp目录中创建临时文件（包含构建的镜像）。这些临时文件会与预期的镜像进行比较，然后被删除。如果您想保留这些临时文件（例如，检查正在构建的内容），可以设置IMAGINE_TEST_KEEP_TEMPFILES环境变量。如果GitHub Action测试中配置了IMAGINE_TEST_KEEP_TEMPFILES，则这些临时文件将作为附件附加到测试中。

datingvip / imagine

维护者

详细信息