PHP在AWS Lambda上必须使用自定义运行时，需编译静态php二进制、编写具备超时控制的bootstrap脚本、在Amazon Linux 2环境构建、正确配置日志与Composer依赖，并严格遵循Lambda沙箱约束。
PHP在AWS Lambda上必须用自定义运行时
AWS Lambda官方不提供PHP运行时，所有PHP函数都得自己打包运行时环境。直接上传index.php会报错Cannot find module 'bootstrap'或exec format error——因为Lambda底层只认Node.js/Python/Java等原生支持的语言，PHP得靠bootstrap可执行文件来启动。
核心做法是：编译一个静态链接的php二进制（推荐用php-build或预编译包），配上bootstrap脚本，整个目录打成ZIP上传。注意不能用Mac或Windows本地打包，必须用Amazon Linux 2环境（或Docker模拟）构建，否则会因glibc版本不兼容而崩溃。
- 用
public.ecr.aws/sam/build-php8.2镜像构建最稳妥 -
bootstrap文件权限必须设为755：chmod +x bootstrap - PHP配置要禁用
opcache.enable_cli=1，否则冷启动时可能卡住
bootstrap脚本怎么写才不超时
Lambda要求bootstrap必须持续监听/var/runtime/awslambda/runtime/invocation/next接口并转发请求给PHP，同时处理响应和错误。写错会导致Runtime.ExitError或无限重试。
关键逻辑是循环调用curl -sS http://$RUNTIME_API/2018-06-01/runtime/invocation/next拉取事件，再用php index.php执行，最后用curl -X POST回传结果。不能用sleep轮询，必须用read -t 30之类带超时的阻塞读，否则会触发Lambda 30秒硬超时。
立即学习“PHP免费学习笔记（深入）”；
- 必须捕获PHP的
exit()码：非0退出要发/runtime/invocation/{reqId}/error - 事件体较大时（>1MB），需用
jq -r '.payload'提取，避免bash变量截断 - 不要在
bootstrap里做耗时初始化（如加载Composer autoloader），应移到index.php顶部的static块中
如何让Composer依赖正常工作
本地composer install --no-dev --optimize-autoloader后，vendor目录体积常超50MB，导致部署失败。Lambda解压限制是250MB（未解压ZIP上限50MB），但实际可用空间只有~480MB临时磁盘（/tmp），且vendor里的二进制扩展（如gd.so）在AL2上根本不能用。
解决方案不是“删掉不用的包”，而是分层处理：纯PHP库保留，含C扩展的替换成纯PHP实现（如用intervention/image代替imagick），大体积工具类（如symfony/console）直接删掉——Lambda函数不需要命令行交互。
- 用
composer install --no-dev --classmap-authoritative生成确定性autoload - 把
vendor/autoload.php路径硬编码进index.php，别依赖getcwd() - 如果必须用
ext-zip等扩展，得在构建时用./configure --enable-zip重新编译PHP
日志和错误为什么总看不到
PHP默认把error_log()输出到stderr，但Lambda只捕获stdout作为日志流。直接echo "debug"会被当成响应体返回给调用方，造成Malformed lambda proxy response错误。
正确做法是统一走error_log()，并确保log_errors = On、error_log = /dev/stderr（在php.ini里设）。Lambda会自动把stderr转成CloudWatch Logs中的REPORT和ERROR条目。
- 调试时加
error_log("EVENT: " . json_encode($event), 4)，4代表STDERR - 捕获致命错误要用
register_shutdown_function()配合error_get_last() - 别用
var_dump()裸打，它可能输出HTML格式，在纯文本日志里乱码
真正麻烦的从来不是写几行PHP，而是让PHP在Lambda的沙箱里老老实实交出stdout、不碰/tmp以外的路径、不在100ms内狂建PDO连接。每个bootstrap都是对Linux进程模型的小型压力测试。
