amphp/amp 要求 PHP ≥ 8.0，低版本需升级而非降级；协程需显式启动 Loop::run() 并使用 Promise；amphp/mysql 不支持 MySQL 8 默认认证插件；框架中硬塞 Amp 会崩溃，应分离为独立异步服务。
Composer 安装 amphp 包时提示 amphp/amp 不兼容 PHP 版本
你执行 composer require amphp/amp 失败，大概率是因为当前 PHP 版本低于 8.0 —— amphp/amp v3 起已强制要求 PHP ≥ 8.0。v2 虽支持 PHP 7.4，但已于 2023 年终止维护，且与现代 amphp 生态（如 amphp/http-server）不兼容。
实操建议：
- 先运行
php -v确认版本；若低于 8.0，必须升级 PHP，不能靠降级 amphp 解决长期问题 - 不要手动指定旧版本如
composer require amphp/amp:^2.6，它无法与amphp/http-client或amphp/mysql协同工作 - 若项目暂无法升 PHP，说明你其实还没到需要 Amp 的阶段：同步模型 + 连接池 + 缓存已能覆盖绝大多数 I/O 场景
require amphp/amp 后运行协程代码却仍是同步阻塞
Amp 不是“装上就自动异步”，它依赖显式使用 Amp\Loop::run() 启动事件循环，且所有异步操作（如 HTTP 请求、数据库查询）必须返回 Promise 并用 Promise\wait() 或 async 函数包裹，否则仍走 PHP 原生同步路径。
常见错误现象：
立即学习“PHP免费学习笔记（深入）”；
- 直接调用
file_get_contents('https://...')—— 这永远阻塞，和 Amp 无关 - 写了
Async\async(fn() => {...})却没在Loop::run()内执行，协程根本没调度 - 混用
sleep(1)或usleep(1000)—— 必须改用Amp\delay(1000)
最小可运行示例：
use Amp\Loop;
use Amp\ByteStream;
Loop::run(function () {
$promise = Amp\Http\Client\request(
new Amp\Http\Client\Request('https://httpbin.org/delay/1')
);
$response = Amp\Promise\wait($promise); // 注意：这是顶层等待，非阻塞
echo $response->getStatus();
});
为什么 amphp/mysql 连接不上 MySQL 8？
MySQL 8 默认启用 caching_sha2_password 认证插件，而 amphp/mysql v3 目前（截至 2024）仅支持 mysql_native_password。连接时抛出类似 Authentication plugin 'caching_sha2_password' is not supported 的错误。
解决路径很窄，只有两个可行选择：
- 修改 MySQL 用户认证方式：
ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'password'; - 或改用
amphp/postgres（如果业务允许换数据库），它对现代认证协议支持更早、更稳定 - 别尝试打补丁或魔改
amphp/mysql源码——握手逻辑耦合深，易引发内存泄漏或连接复用失败
在 Laravel 或 Symfony 中硬塞 Amp 协程会崩
主流 PHP 框架默认基于同步请求生命周期设计，其核心组件（路由分发、中间件栈、DB 查询构建器）都不是协程安全的。你在控制器里写 Async\async(...)，看似跑起来了，但紧接着可能触发：
-
mysqli扩展的连接资源被多个协程并发读写，导致mysqli::query(): Couldn't fetch mysqli - Laravel 的
Container在协程切换时丢失绑定上下文，app(MyService::class)返回 null - Symfony 的
HttpKernel在Loop::run()中被重复调用，Response headers 已发送却还试图输出
真要结合框架用异步，只有一条路：把 Amp 当作独立服务进程，比如用 amphp/http-server 写一个纯异步 API 网关，Laravel 只负责后台管理，两者通过 Redis 或消息队列通信。
复杂点在于：你得自己处理协程生命周期与 HTTP 请求边界的对齐，比如超时取消、错误透传、日志上下文隔离——这些没有现成中间件，每一步都得手写兜底。
