如何在PHP项目中通过Composer集成并使用Swoole/Hyperf？（高性能框架）

Swoole 和 Hyperf 不是传统 PHP-FPM 插件，而是常驻内存的协程运行范式；推荐新建 Hyperf 项目而非硬集成旧框架，CLI 场景可谨慎复用 Swoole 特性但须禁用同步 IO 并确保协程安全。

直接在现有 PHP 项目中通过 Composer 集成 Swoole 或 Hyperf 并非“加个包就能跑”，关键在于理解它们的运行模型差异——Swoole 是常驻内存的协程服务器，Hyperf 是基于 Swoole 构建的全异步框架，二者都不走传统 PHP-FPM 流程。强行在 Laravel/ThinkPHP 等同步框架里“局部引入 Swoole 扩展”容易引发阻塞、内存泄漏或协程上下文丢失，不推荐。

明确项目定位：是升级为常驻服务，还是仅复用部分能力？

这是第一步决策：

• 想彻底转向高性能长连接、高并发微服务 → 直接新建 Hyperf 项目，别硬套进旧项目
• 只想在现有项目里用 Swoole 的某些特性（如协程 MySQL、定时器、异步任务） → 可以在 CLI 模式下有限使用，但必须确保不混用同步阻塞调用（如 file_get_contents、curl_exec）
• 试图让 Laravel 同时跑在 FPM 和 Swoole 上 → Hyperf 官方不兼容，社区方案（如 laravels）维护成本高、协程安全难保障，生产环境慎选

推荐路径：用 Composer 初始化标准 Hyperf 项目

Hyperf 是目前最成熟、文档最全、生态最活跃的 Swoole 应用框架，适合绝大多数需要高性能的场景。

终端执行：

立即学习“PHP免费学习笔记（深入）”；

进入目录后，它已自带：

标签： mysql php thinkphp laravel redis composer apache nginx webso