src-run / augustus-exception-library
具有高级上下文信息和内置字符串替换功能的核心异常类实现。
Requires
- php: ^8.1
- src-run/augustus-utility-library: ^0.20
- src-run/cocoa-var-dumper-library: ^0.20
Requires (Dev)
- codacy/coverage: ~1.4
- friendsofphp/php-cs-fixer: ~3.2
- php-coveralls/php-coveralls: ~2.1
- symfony/phpunit-bridge: ~4.1 | ~5.0 | ~6.0
- symfony/yaml: ~4.2 | ~5.0 | ~6.0
README
概述
欢迎! src-run/augustus-exception-library
包提供了以下功能
具有高级上下文信息和内置字符串替换功能的核心异常类实现。
分组
我们使用Willy Wonka灵感的命名规范为我们的包分组命名。本包属于augustus分组,这是一个以“核心反射基类”和相关功能为重点的包集合。
如果您手头有太多时间,欢迎研究一些关于这个特定分组的无用细节。
JTT
本包代表了一个在大量开源代码集合中的单个项目,这些代码在“SR”命名空间下发布,包括许多框架无关的库、一组Symfony捆绑包以及一些独立发布。该项目由以下作者和维护:
快速入门
安装
通过使用Composer CLI显式要求代码,或通过编辑您的 composer.json 文件以反映依赖关系并更新您的项目需求来获取代码。例如,要使用CLI显式要求此项目,请使用以下命令。
$ composer require src-run/augustus-exception-library
或者,要将此项目添加到您的“composer.json”文件中,请将以下内容添加到“require”部分。
require: { "src-run/augustus-exception-library": "dev-master" }
注意:不建议使用“dev-master”约束。请记住,这样做可能会允许拉入具有向后不兼容的破坏性更改的发布。相反,使用语义版本控制并明确指定要求是良好的实践。例如,要要求版本1.0,请使用 ^1.0
。
参考
API文档
本包的API参考文档可在我们的文档网站上找到(请参阅下文“附加链接”部分中的“参考”行中的表格)。所有API文档都会在git push事件发生时自动针对master分支进行编译。
计划提供特定版本的静态API参考,一旦此包成熟并达到1.0版本,将发布。.
上述API参考网站使用一个可靠且功能完善的CLI工具Sami自动生成。它经过严格的定期测试,并被用于一些大型项目,例如Symfony全栈框架 <see: https://src.run/go/symfony-api>,以及一些较小的项目,例如Twig <see: https://src.run/go/twig-api>。请参考Sami的仓库页面以研究在您自己的项目中使用Sami的方法。
示例/教程
目前,除了这份README(它本身也是从模板生成的)之外,没有“人工编写”的文档。待包稳定、可用的人力以及外部用户实际需求后,我们可能会发布一个包含官方文档、教程和额外资源的Read the Docs页面。
贡献
讨论
对于一般性咨询或讨论广泛的主题或想法,请到Freenode上查找“robfrawley”。他总是乐意讨论语言级别的想法、项目可能的新的发展方向、新兴技术,以及天气。
问题
要报告问题或请求新功能,请使用项目问题跟踪器。在任何错误报告中提供尽可能多的信息。如果在几天内没有收到回复,请随意“ping”该主题(有时GitHub的通知电子邮件会遗漏)。
代码
在使用本包的过程中,您创建了额外的功能?太好了:将它发送回上游!不要犹豫,提交pull request!您的想象力以及我们CONTRIBUTING.md文件中概述的要求是唯一限制。
许可证
本项目遵循MIT许可证,这是一个由FSF和OSI批准的、与GPL兼容的宽松的免费软件许可证。请查阅随源代码一起分发的LICENSE文件,以获取更多信息。