Amp\Http\Server 必须显式调用 Amp\Loop::run() 启动事件循环才能持续运行，不能用 php -S 启动；需用 Router 注册路由、返回 Promise 响应、监听 0.0.0.0 地址，并异步处理日志、文件上传与数据库连接。
为什么 Amp\Http\Server 不能直接用 php -S 启动
Amp HTTP Server 是基于事件循环的异步服务，它不依赖 PHP 内置服务器（php -S），也不兼容 CGI/FPM 模式。你写完 new Amp\Http\Server\Server(...) 后直接运行脚本，进程会启动但立刻退出——因为没手动驱动事件循环。
常见错误现象：PHP Fatal error: Uncaught Amp\Loop\UnsupportedDriverError: No supported event loop driver available，或脚本静默结束、端口根本没监听。
- 必须显式调用
Amp\Loop::run()启动事件循环，否则服务器不会持续运行 - 不能在 Laravel/Symfony 的普通请求生命周期里初始化它——那是同步上下文，Amp 要独占整个进程
- 推荐用
composer require amphp/http-server amphp/loop，避免混用不同 Loop 驱动（如 ext-ev 和 ext-uv 冲突）
如何正确启动一个基础 Amp HTTP Server
最简可用示例只做三件事：定义路由、构造 Server 实例、交由 Loop::run() 驱动。没有中间件、没有 DI 容器、不复用已有框架逻辑。
典型使用场景：内部工具接口、实时日志接收端、轻量 API 网关、CLI 启动的调试服务。
立即学习“PHP免费学习笔记（深入）”；
-
Server构造函数第一个参数是Router实例，别传闭包或数组——要用Amp\Http\Server\Router - 响应必须返回
Promise（比如new Response(...)本身不是 Promise，得包一层Success::of(...)或用call()返回 Promise） - 监听地址写成
0.0.0.0:8080而非localhost:8080，后者在某些系统下无法被外部访问
use Amp\Http\Server\Server;
use Amp\Http\Server\Request;
use Amp\Http\Server\Response;
use Amp\Http\Server\Router;
use Amp\Success;
$router = new Router();
$router->addRoute('GET', '/', function (Request $request) {
return new Success(new Response(200, [], 'Hello Amp!'));
});
$server = new Server([$router], ['127.0.0.1:8080']);
Amp\Loop::run(function () use ($server) {
yield $server->start();
});
文件上传和 POST 数据怎么取
Amp 不自动解析 application/x-www-form-urlencoded 或 multipart/form-data，它把原始请求体当二进制流暴露出来。想拿 $_POST 那种效果？得自己 parse。
容易踩的坑：直接读 $request->getBody()->buffer() 会吃光内存——大文件上传时尤其危险；用 stream 接口又容易漏掉边界处理。
- 表单数据优先用
Amp\Http\Server\FormParser，它能按 Content-Type 自动分发解析逻辑 - 上传文件必须配合
Amp\Http\Server\Uploads，否则只能拿到原始字节流，没法知道文件名、类型、临时路径 -
FormParser::parse()返回的是Promise<array></array>，不能直接foreach，得yield或用wait()（仅限 CLI 调试）
为什么日志写到一半就停了，或者并发请求变慢
Amp 的 I/O 全部异步，但如果你在请求处理中用了 file_put_contents(..., FILE_APPEND) 或 error_log()，这些是同步阻塞调用，会拖垮整个事件循环。
性能影响明显：10 个并发请求，其中 1 个写日志卡住 100ms，其余 9 个全得等——这不是“慢”，是“假死”。
- 日志必须走异步驱动：用
Amp\ByteStream\WritableResourceStream包装文件句柄，再用write()发送 - 不要在
Server启动前初始化 PDO 连接——Amp 不支持同步 MySQL 扩展，要用amphp/mysql - 所有第三方 SDK（比如 Redis 客户端）必须确认支持 Amp 原生 Promise，否则得用
Amp\Sync\LocalSemaphore加锁隔离，代价很高
异步不是加个 async 关键字就行的事，整个依赖链都得对齐。漏掉一个同步调用，整条流水线就退回阻塞模型。
