README

PHP包装器，用于轻松调用Java元数据提取库。

简介

php-metadata-extractor 是一个包装器，用于调用强大的 Java metadata-extractor 库，并能够访问相同的 PHP API。

因此，在这里我们将提供与 metadata-extractor 相同的文档，但针对 PHP，以下是使用该库获取元数据的方法。

Metadata metadata = ImageMetadataReader.readMetadata(imagePath);

安装

安装库的最简单方法是使用 composer，并在您的 composer.json 文件中定义以下依赖项

{
    "require": {
        "gomoob/php-metadata-extractor": "~2.9"
    }
}

请注意，由于库是围绕 Java 库的包装器，因此必须在您的 PATH 变量中可用 java 可执行文件。

版本控制

为了便于版本识别，php-metadata-extractor 的版本将始终与 Java metadata-extractor 库的版本保持一致。

php-metadata-extrator 的稳定版本将是 X.Y.Z-N，其中 N 代表与 php-metadata-extractor 关联的补丁号。

不稳定或不完整的版本将是 X.Y.Z-alpha.N、X.Y.Z-beta.N 或 X.Y.Z-rc.N。
。

贡献

规则

由于 metadata-extractor Java 库非常完善，因此我们需要改进其集成。如果您想做出贡献，请遵守以下规则：

• 只在 develop 分支上创建您的拉取请求，master 分支应由 Gomoob 用于创建新版本；
• 使用 grunt phpcbf 命令自动使用 PHP Code Sniffer 格式化您的代码；
• 使用 grunt phpcs 命令在创建拉取请求之前检查您的代码；
• 始终尝试完整地记录您的类、属性和函数。

构建

构建脚本使用 Grunt 管理，要使用它，您首先需要安装 Node 并运行 npm install。

使用 Composer 管理PHP依赖项，在调用任何构建命令之前运行 composer update 命令。

确保您有一个正常工作的 Java 环境，并且 java 可执行文件位于您的 PATH 中。

以下构建可用：

• grunt 清理临时构建文件，运行 PHPUnit 单元测试并生成 PHPDocumentor 文档；
• grunt phpcbf 自动清理用于 PHP Code Sniffer 的源代码；
• grunt phpcs 使用 PHP Code Sniffer 检查源代码的有效性；
• grunt test 执行 PHPUnit 单元测试；
• grunt generate-documentation 生成 PHPDocumentor 文档；
• grunt pdepend 生成 PDepend 质量图表；
• grunt phpmd 生成 PHPMD 代码质量报告。

发布历史

2.9.1-alpha.4 (2016-08-25)

• 添加 \Gomoob\MetadataExtractor\Metadata\Photoshop\DuckyDirectory 类。

2.9.1-alpha.3 (2016-08-25)

• 将 \Gomoob\MetadataExtractor\Metadata\Bmp\BmpHeaderDescriptor 添加到开始管理 BMP 文件；
• 将 \Gomoob\MetadataExtractor\Metadata\Bmp\BmpHeaderDirectory 添加到开始管理 BMP 文件；
• 更新 composer 依赖并优化 composer 配置。

2.9.1-alpha.2 (2016-08-10)

• 实现 \Gomoob\MetadataExtractor\Metadata\Directory#containsTag($tagType) 方法；
• 在 Travis 上修复单元测试；
• 在 README 文件中添加贡献说明。

2.9.1-alpha.1 (2016-08-09)

• 初始版本。

关于 Gomoob

在 Gomoob，我们每天都在使用出色的开源框架构建高质量软件。您想要与我们开始下一个项目吗？太棒了！给我们打电话或给我们发电子邮件，我们将会尽快回复您！

您可以通过电子邮件 contact@gomoob.com 或电话号码 (+33) 6 85 12 81 26 或 (+33) 6 28 35 04 49 联系我们。

还可以访问 http://gomoob.github.io 来发现我们开发的更多开源软件。