phix / contractlib
ContractLib 是一个轻量级的 PHP 库,旨在帮助您通过在代码中强制执行编程约定来编写更健壮的 PHP 组件。
Requires
- phix/exceptionslib: 1.*
Requires (Dev)
- phix/autoloader: 4.*
This package is not auto-updated.
Last update: 2024-09-24 04:04:42 UTC
README
ContractLib 是一个简单易用的 PHP 组件,可以轻松地在您的 PHP 组件中强制执行编程约定。这些编程约定可以大大帮助您和您的组件用户开发更健壮的代码。
ContractLib 是受微软研究院对 .NET 的代码约定库 的工作的启发。
系统范围安装
应使用 PEAR 安装程序 安装 ContractLib。此安装程序是 PHP 社区安装 PHP 组件的事实标准。
sudo pear channel-discover pear.phix-project.org
sudo pear install --alldeps phix/ContractLib
作为组件的依赖项
如果您正在创建依赖 ContractLib 的组件,请确保将 LicenseLib 添加到您的组件的 package.xml 文件中。
<dependencies> <required> <package> <name>ContractLib</name> <channel>pear.phix-project.org</channel> <min>1.0.0</min> <max>1.999.9999</max> </package> </required> </dependencies>
用法
ContractLib 最好的文档是其单元测试,这些测试包含在包中。您将在 PEAR 仓库中找到它们,在 Linux 系统上通常是 /usr/share/php/test。
您还可以在 GitHub 上找到它们:http://github.com/stuartherbert/ContractLib/
开发环境
如果您想修补或增强此组件,您需要创建一个合适的发展环境,通过 安装 phix。
然后,克隆 git 仓库
# ContractLib
git clone git@github.com:stuartherbert/ContractLib.git
然后,安装此组件依赖项的本地副本以完成开发环境
# build vendor/ folder
phing build-vendor
为了使您的生活更轻松,常用的任务(如运行单元测试、生成代码审查分析以及创建 PEAR 包)已使用 phing 自动化。您将在组件提供的 build.xml 文件中找到这些自动化步骤。
在组件的最高级目录中运行命令 'phing' 以查看可用的所有自动化任务。
许可
有关完整的许可详情,请参阅 LICENSE.txt。