php-the-right-way

PHP: The Right Way 是一本易于阅读的 PHP 最佳实践速查手册，涵盖公认的编码规范以及网络上权威教程的链接。该项目明确阐述了其动机：PHP 社区缺乏足够且可信的信息来帮助新入门的 PHP 程序员，而该站点旨在填补这一空白。 站点与仓库结构： - 该网站是一个托管在 GitHub Pages 上的 Jekyll 项目。 - 每个章节和子章节都是 _posts/ 目录下的一个 Markdown 文件，子章节在其 front matter 中标记为 isChild: true。 - 导航和页面结构由这些文件自动生成。 内容标准：贡献者的代码示例必须符合 PSR-1 或更高标准。贡献者风格指南要求使用美式英语拼写（仅限主要英语仓库），使用四个空格缩进而非制表符，并将文本换行限制在 120 个字符以内。 贡献方式：贡献者需阅读 CONTRIBUTING.md 获取详细说明，然后 fork 仓库并进行编辑，可选安装 Ruby 及 Jekyll gem 以在本地预览更改，最后提交 pull request。该项目还提供网页横幅图片，支持者可以将其放置在自己的网站上，以引导新的 PHP 开发者了解该资源。 翻译：该文档除英语外还提供多种语言版本，包括西班牙语、法语、印尼语、意大利语、波兰语、巴西葡萄牙语、罗马尼亚语、斯洛文尼亚语、塞尔维亚语、土耳其语、保加利亚语、俄语、乌克兰语、阿拉伯语、波斯语、泰语、韩语、日语、简体中文和繁体中文。新翻译通过 fork 仓库并将本地化 fork 发布到 GitHub Pages 来完成，发布地址可以是 [username].github.io/php-the-right-way，也可以通过 CNAME 文件配置为子域名；维护者随后会在主文档中链接到完成的翻译版本，以避免内容碎片化。 作者与许可：该项目由 Slim Framework 的作者 Josh Lockhart 维护，协作者包括 Kris Jordan 和 Phil Sturgeon。内容以 Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License 发布。