README

FlorianWolters\Component\Drawing\Color 是一个简单易用的 PHP 组件，提供了与颜色相关的对象模型和操作。

简介

此组件受到 System.Drawing.Color 结构的启发，该结构是 .NET Framework 的组成部分。

FlorianWolters\Component\Drawing\Color 包含以下四个组件

接口 FlorianWolters\Component\Drawing\Color\ColorInterface：表示实现类实现了颜色模型。
类 FlorianWolters\Component\Drawing\Color\CmykColor：将颜色模型 CMYK 封装在对象中。
类 FlorianWolters\Component\Drawing\Color\RgbaColor：将颜色模型 RGB(A) 封装在对象中。
实用类 FlorianWolters\Component\Drawing\Color\ColorUtils：提供颜色模型之间的转换操作。

功能

使用静态和动态测试程序对组件进行了测试
- 使用 PHPUnit 实现了动态组件测试（单元测试）。
- 以下工具执行了静态代码分析
  - PHP_CodeSniffer：风格检查器
  - PHP Mess Detector (PHPMD)：代码分析器
  - phpcpd：复制/粘贴检测器（CPD）
  - phpdcd：死代码检测器（DCD）
通过 Composer 或 PEAR 命令行安装程序安装
- 提供了一个可由依赖管理器 Composer 安装的 Packagist 软件包。点击此处查看Packagist上的软件包。
- 提供了一个可由包管理器 PEAR 安装程序安装的 PEAR 包。点击此处查看PEAR频道。
提供了一个由文档生成器 ApiGen 生成的完整应用程序编程接口（API）文档。点击此处查看当前API文档。
遵循自动加载互操作性要求的PSR-0。
遵循PSR-1基本编码风格指南。
遵循PSR-2编码风格指南。
遵循语义版本规范（SemVer）2.0.0-rc.1。

要求

PHP >= 5.4

用法

FlorianWolters\Component\Drawing\Color的最佳文档是其单元测试，这些测试包含在软件包中。您可以在PEAR存储库中找到它们，在Linux系统上通常是/usr/share/php/test。

安装

本地安装

FlorianWolters\Component\Drawing\Color应使用依赖管理器Composer安装。Composer可以使用PHP安装。

php -r "eval('?>'.file_get_contents('http://getcomposer.org/installer'));"

这只会检查一些PHP设置，然后将composer.phar下载到您的当前工作目录。此文件是Composer的二进制文件。它是一个PHAR（PHP存档），它是一种PHP存档格式，可以在命令行上运行，等等。

接下来，运行install命令以解析和下载依赖项

php composer.phar install

全局安装

FlorianWolters\Component\Drawing\Color应使用PEAR安装程序安装。此安装程序是PHP社区安装PHP组件的事实标准。

pear channel-discover pear.florianwolters.de
pear install --alldeps fw/Color

作为组件的依赖项

Composer

如果您正在创建依赖于FlorianWolters\Component\Drawing\Color的组件，请确保将FlorianWolters\Component\Drawing\Color添加到您的组件的composer.json文件中

{
    "require": {
        "florianwolters/component-drawing-color": "dev-master"
    }
}

PEAR

如果您正在创建依赖于FlorianWolters\Component\Drawing\Color的组件，请确保将FlorianWolters\Component\Drawing\Color添加到您的组件的package.xml文件中

<dependencies>
  <required>
    <package>
      <name>Color</name>
      <channel>pear.florianwolters.de</channel>
      <min>0.1.0</min>
      <max>0.1.99</max>
    </package>
  </required>
</dependencies>

开发环境

如果您想修补或增强此组件，您将需要创建一个合适的发展环境。最容易的方法是安装phix4componentdev

# phix4componentdev
pear channel-discover pear.phix-project.org
pear install phix/phix4componentdev

然后，克隆Git存储库

# PHP-Component-Drawing-Color
git clone http://github.com/FlorianWolters/PHP-Component-Drawing-Color

然后，安装此组件依赖项的本地副本以完成开发环境

# build vendor/ folder
phing build-vendor

为了让您的生活更轻松，一些常见任务（如运行单元测试、生成代码审查分析以及创建PEAR软件包）已使用phing自动化。您可以在组件中附带build.xml文件中找到自动化步骤。

在组件的顶级目录中运行命令phing，以查看所有可用的自动化任务列表。

许可证

本程序是免费软件：您可以根据自由软件基金会发布的GNU通用公共许可证的条款重新分发和/或修改它，许可证版本为3，或（根据您的选择）任何更高版本。

本程序以希望它有用而分发，但没有任何保证；甚至没有关于其商业性或适用于特定目的的隐含保证。有关详细信息，请参阅GNU Lesser General Public License。

您应该已收到GNU Lesser General Public License的副本。如果没有，请参阅http://gnu.org/licenses/lgpl.txt。

florianwolters / component-drawing-color

维护者

详细信息