sellerlabs/nucleus

一些核心PHP实用工具

v0.6.0 2017-01-23 02:20 UTC

README

一个独立的PHP工具库。深受类似项目如libphutil的启发。目前用于个人和工作项目。旨在使PHP工作更轻松、更可预测。

需要HHVM 3.6或PHP 5.6

目标

  • 提供对常见操作的统一API。
  • 将最有用的代码片段收集到一个库中。
  • 强调严格的类型检查(例如 float !== integer)。
  • 欢迎函数式编程思想和概念(我对此是新手)。

核心组件

虽然Nucleus包含一些杂乱无章的内容,但有一些值得提及的有用类

  • Spec:一个多用途约束检查框架,可以轻松扩展。
  • Validator:基于Spec,Validator组件为SpecResult提供生成UX友好消息的接口。
  • Impersonator:一个构造器依赖自动mock器。对于具有许多外部依赖项的类和大量使用容器依赖注入的项目非常有用。
  • View:一组用于生成干净、安全HTML/Text的类和实用工具。它有点像没有XML的XHP或去糖化的React.js代码。
  • Std, Arr和其他:我们都知道PHP标准库是一团糟。有许多尝试修复它的失败尝试。这是其中之一。我创建了一些具有许多静态别名的类,试图改进它。是的,这会有性能损失(验证加至少一个函数调用),但它使许多操作更可预测、更安全。

构建文档

cd docs
pip install -r requirements.txt
make html

贡献

GitHub上接受pull请求。欢迎修复错误和小的改进。大想法将进行审查和讨论。

代码规范:PSR-2和一些补充。有关详细信息,请参阅https://github.com/sellerlabs/php-standard

许可证

此代码根据MIT许可证授权。有关更多信息,请参阅LICENSE。