florianwolters / component-core-valueobject
PHP 组件中的值对象实现模式。
Requires
- php: >=5.4
- florianwolters/component-core-equality: 0.2.*
- florianwolters/component-core-immutable: 0.1.*
This package is not auto-updated.
Last update: 2024-09-14 15:11:12 UTC
README
FlorianWolters\Component\Core\ValueObject 是一个简单易用的 PHP 组件,实现了 值对象 实现模式。
特性
- 使用静态和动态测试程序测试的工件
- 使用 PHPUnit 实现的动态组件测试(单元测试)。
- 使用以下工具进行静态代码分析:
- PHP_CodeSniffer:样式检查器
- PHP Mess Detector (PHPMD):代码分析器
- phpcpd:复制/粘贴检测器(CPD)
- phpdcd:死代码检测器(DCD)
- 可以通过 Composer 或 PEAR 命令行安装程序 安装。
- 提供了一个由文档生成器 ApiGen 生成的完整应用程序编程接口(API)文档。点击 这里 获取当前的 API 文档。
- 遵循 PSR-0 的自动加载器互操作性要求。
- 遵循 PSR-1 基本编码风格指南。
- 遵循 PSR-2 编码风格指南。
- 遵循 语义化版本控制规范(SemVer) 2.0.0-rc.1。
要求
- PHP >= 5.4
使用方法
FlorianWolters\Component\Core\ValueObject 的最佳文档是包含在包中的单元测试。您可以在您的 PEAR 仓库中找到它们,在 Linux 系统上通常是 /usr/share/php/test。
安装
本地安装
FlorianWolters\Component\Core\ValueObject 应使用依赖管理器 Composer 进行安装。您可以通过 PHP 来安装 Composer。
php -r "eval('?>'.file_get_contents('https://composer.php.ac.cn/installer'));"
这将只检查几个 PHP 设置,然后将
composer.phar下载到您的当前工作目录。此文件是 Composer 的二进制文件。它是一个 PHAR (PHP 归档),它是一种可以用于命令行的 PHP 归档格式,可用于多种用途。接下来,运行
install命令以解析和下载依赖项
php composer.phar install
系统级安装
FlorianWolters\Component\Core\ValueObject 应使用 PEAR 安装程序 进行安装。此安装程序是 PHP 社区的默认标准,用于安装 PHP 组件。
pear channel-discover pear.florianwolters.de
pear install --alldeps fw/ValueObject
作为您组件的依赖项
Composer
如果您正在创建一个依赖 FlorianWolters\Component\Core\ValueObject 的组件,请确保将 FlorianWolters\Component\Core\ValueObject 添加到您的组件的 composer.json 文件中
{
"require": {
"florianwolters/component-core-valueobject": "0.1.*"
}
}
PEAR
如果您正在创建一个依赖 FlorianWolters\Component\Core\ValueObject 的组件,请确保将 FlorianWolters\Component\Core\ValueObject 添加到您的组件的 package.xml 文件中
<dependencies> <required> <package> <name>ValueObject</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-Core-ValueObject
git clone http://github.com/FlorianWolters/PHP-Component-Core-ValueObject
然后,安装此组件依赖项的本地副本以完成开发环境
# build vendor/ folder
phing build-vendor
为了使您的生活更轻松,已使用 phing 自动化了常见任务(例如运行单元测试、生成代码审查分析和创建 PEAR 包)。您可以在组件提供的 build.xml 文件中找到自动化步骤。
在组件的顶级目录中运行 phing 命令以查看可用的所有自动化任务列表。
许可协议
本程序是免费软件:您可以按照自由软件基金会发布的 GNU 较小通用公共许可证(Lesser General Public License)的条款重新分发和/或修改它,许可证版本为 3 或(根据您的选择)更高版本。
本程序分发时希望它能对您有用,但没有任何保证;甚至没有关于其适销性或适用于特定目的的暗示性保证。有关详细信息,请参阅 GNU 较小通用公共许可证。
您应已收到一份 GNU 较小通用公共许可证的副本。如果没有,请参阅 http://gnu.org/licenses/lgpl.txt。