PHP 扩展开发检测清单（扩展开发必读）

想要作出一个成功的 PHP 扩展包，不单单是简单的将代码放进文件夹中就能够了，除此以外，还有很是多的因素来决定你的扩展是否优秀。如下清单的内容将有助于完善你的扩展，而且在 PHP 社区中获得更多的重视。

1. 为你的扩展选择一个正确合适的名字

• 确保你的命名没有被其余项目使用。
• 扩展的名字须要和你的 PHP 命名空间保持一致。
• 不要在你的命名空间中使用本身的姓名或者其余带有我的色彩的东西。

2. 将你的扩展开源

• GitHub 能够免费管理这一类公共的项目。
• GitHub 很是有助于你来管理这个开源项目，而且方便他人获取你的扩展。
• 若是你不想使用，能够尝试替代品: Bitbucket.

3. 对自动加载友好一些

• 使用 PSR-4 兼容的自动加载器命名空间。
• 请将代码放在 src 文件夹里。

4. 经过 Composer 发布

• 确保能够经过 Composer 来找到你的类库， Composer 是PHP的一个依赖管理工具
• 发布在 Packagist上，Packagist 是一个主要的 Composer 包仓库。

5. 不局限于框架

• 不要局限于项目只能使用在一个框架上。
• 经过服务提供器来给框架提供特殊支持。

6. 遵循一种编码风格

• 强烈建议你坚持使用 PSR-2 编码风格。
• 使用代码自动格式化工具，好比 PHP Coding Standards Fixer 。
• 使用代码风格检测工具，好比 PHP Code Sniffer 。

7. 编写单元测试

• 覆盖大部分的代码。
• 使用 PHPUnit ，一个经常使用的 PHP 单元测试框架。
• 其余可选： phpspec ， Behat ， atoum ， Codeception。

8. 为代码写注释

• 将注释看成内置文档来看待。
• 代码注释也能够改善 IDE 的代码自动完成功能, 好比 PhpStorm 。
• 能够自动转换成 API 文档， 查看 phpDocumentor 。

9. 使用语义化版本管理

• 使用 语义化版本号 来管理版本号。
• 遵循 主版本.次版本.补丁版本 规范。
• 让开发人员安全的升级软件，而不用担忧会产生破坏性的改动。
• 请记得及时给发布版本打上标签！

10. 保持按期更新日志

• 明确标记并展现出版本之间显著的变化。
• 考虑遵循 Keep a CHANGELOG 的格式进行编写。

11. 使用持续集成

• 使用服务来自动检查编码是否标准而且可否经过运行测试。
• 在多个不一样的 PHP 版本都进行运行测试会是个不错的办法。
• 确保提交或者拉取的时候均可以自动运行。
• 参考：Travis-CI，Scrutinizer, Circle-CI。

12. 编写大量的使用文档

• 一份优秀的文档对于扩展包来讲相当重要。
• 至少要确保库中有详细的 README (自述) 文件。
• 能够尝试在 GitHub Pages　中托管文档。
• 可用参考： Read the Docs。

13. 包含一份受权（License）

• 包含一份受权协议，可以颇有效地保护你的工做成果，而且很容易作到。
• 参考 choosealicense.com。 大部分PHP 开源项目使用 MIT 协议。
• 至少要在代码库中包含 LICENSE 文件。
• 还能够考虑在 Docblocks 中加入你的受权协议。

14. 欢迎你们的贡献

• 想要你们辅助改进项目，那必定要多多请求你们的贡献！
• 有一份 CONTRIBUTING 文件，列出贡献者的名单。
• 利用这份文件解释项目环境要求，例如测试环境。

更多现代化 PHP 知识，请前往 Laravel / PHP 知识社区