项目状态
PHP TrueAsync 是一个修改 PHP 核心的非官方项目！
目前提出的 RFC 处于不确定的状态，
尚不清楚它是否会在未来被接受。
然而，作为项目的作者，我相信拥有选择是进步的重要条件。
PHP TrueAsync 项目欢迎各种想法、建议和帮助。
如果您想讨论什么 — 请在项目论坛上留言或直接联系我：
贡献方式
代码
- 修复 Bug — 查看带有
good first issue标签的未解决 issues 来开始 - 新功能 — 在实现之前先在 Discussions 中讨论您的想法
- 代码审查 — 帮助审查 pull requests，这是宝贵的贡献
文档
- 纠错 — 发现了不准确的地方？点击任何页面底部的「编辑此页」
- 翻译 — 帮助将文档翻译成其他语言
- 示例 — 为实际场景编写 API 使用示例
- 教程 — 为特定任务创建分步指南
测试
- 构建测试 — 尝试在您的系统上安装 TrueAsync 并报告任何问题
- 编写测试 — 增加现有 API 的测试覆盖率
- 负载测试 — 帮助发现性能瓶颈
社区
- 回答问题 — 在 GitHub Discussions 和 Discord 上
- 传播项目 — 演讲、文章、博客文章
- 报告 Bug — 一份详细的 Bug 报告能节省数小时的开发时间
如何开始
1. Fork 仓库
git clone https://github.com/true-async/php-src.git
cd php-src
2. 设置环境
按照构建说明为您的平台进行配置。 开发建议使用 debug 构建：
./buildconf
./configure --enable-async --enable-debug
make -j$(nproc)
3. 创建分支
git checkout -b feature/my-improvement
4. 进行修改
- 遵循项目的代码风格
- 为新功能添加测试
- 确保现有测试通过：
make test
5. 提交 Pull Request
- 描述您修改了什么以及为什么
- 引用相关的 issues
- 准备好进行讨论和修改
仓库结构
| 仓库 | 描述 |
|---|---|
| php-src | 带有 Async API 的 PHP 核心 |
| ext-async | 带有实现的扩展 |
| true-async.github.io | 本文档网站 |
指南
- 小 PR 优于大 PR — 一个 PR 解决一个任务
- 实现前先讨论 — 对于重大更改，请先创建 issue 或 discussion
- 编写测试 — 没有测试的代码更难被接受
- 编写文档 — 更改 API 时更新文档
联系方式
感谢您为 PHP 的未来做出贡献！