README

FlorianWolters\Component\Geometry 是一个易于使用的 PHP 组件，提供与几何相关的对象模型和操作。

特性

使用静态和动态测试程序测试了工件
- 使用 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\Geometry 的最佳文档是其单元测试，这些测试包含在包中。您可以在您的 PEAR 仓库中找到它们，在 Linux 系统上通常是 /usr/share/php/test。

安装

本地安装

FlorianWolters\Component\Geometry 应使用依赖管理器 Composer 进行安装。您可以使用 PHP 安装 Composer。

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

这只是一个检查几个PHP设置，然后下载composer.phar到您的工作目录。此文件是Composer的二进制文件。它是一个PHAR（PHP存档），是一种可以用于命令行运行以及其他事物的PHP存档格式。

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

php composer.phar install

系统级安装

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

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

作为组件的依赖项

Composer

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

{
    "require": {
        "florianwolters/component-geometry": "dev-master"
    }
}

PEAR

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

<dependencies>
  <required>
    <package>
      <name>Geometry</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-Geometry
git clone http://github.com/FlorianWolters/PHP-Component-Geometry

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

# build vendor/ folder
phing build-vendor

为了使您的生活更加便利，已使用phing自动化了常见的任务（例如运行单元测试、生成代码审查分析以及创建PEAR包）。您将在组件提供的build.xml文件中找到这些自动化步骤。

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

许可证

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

本程序是在希望它有用的前提下分发的，但不提供任何保证；甚至不提供适销性或适用于特定目的的隐含保证。有关更多信息，请参阅GNU通用公共许可证。

您应该已经收到GNU通用公共许可证的副本。如果没有，请参阅http://gnu.org/licenses/lgpl.txt。

florianwolters / component-geometry

维护者

详细信息