用 Bref 将 PHP/Symfony 应用部署到…

在 AWS Lambda 上部署 PHP 或 Symfony 应用（含 API Gateway、SQS/SNS 触发、冷启动优化）时使用。

适用场景

解决思路

1. 选择方案：Bref 框架（冷启动 < 2s，适合 Symfony 应用和全功能 API，复杂度中等）或 Raw PHP（冷启动 < 500ms，适合简单 handler 和最大控制，复杂度低）
2. 按方案组织项目结构：Symfony + Bref 使用 composer.json、serverless.yml、public/index.php（Lambda 入口）、src/Kernel.php、config/（bundles.php、routes.yaml、services.yaml）、templates/；Raw PHP 使用 public/index.php（handler 入口）、composer.json、serverless.yml、src/Services/
3. Symfony + Bref 入口：在 public/index.php 中 require vendor/autoload.php，用 $_SERVER['APP_ENV'] 和 $_SERVER['APP_DEBUG'] 实例化 Kernel 并 boot()，再 new Bref($kernel) 并 return $bref->run($event, $context)
4. Raw PHP handler：在 public/index.php 中 use function Bref\Lambda\main，调用 main(function ($event) {...})，从 $event['path'] 和 $event['httpMethod'] 取请求信息，返回含 statusCode 和 body（json_encode 结果）的数组
5. 冷启动优化：延迟加载重型服务；关闭未使用的 Symfony 功能（validation、annotations）；生产环境用 classmap 优化 composer autoload；使用 Bref 优化过的 runtime 以利用 PHP 8.x 优化
6. 连接管理：在类中用 private static ?DynamoDbClient $client = null 缓存 AWS 客户端，getClient() 中仅在 null 时用 getenv('AWS_REGION') 和 version 'latest' 创建客户端并复用
7. 内存与超时配置：Symfony 起始 512MB、超时 10-30s 留冷启动缓冲；Raw PHP 起始 256MB、超时 3-10s
8. 依赖配置：composer.json 中 require php ^8.2、bref/bref ^2.0、symfony/framework-bundle ^6.0，config 中设置 optimize-autoloader: true 和 preferred-install: dist
9. 错误处理：用 try/catch 包裹请求处理，ValidationException 返回 statusCode 400 和错误信息，其他 Exception 用 error_log 记录后返回 statusCode 500 和通用错误信息
10. 日志：用 error_log(json_encode([...])) 输出结构化日志，包含 level、message、request_id（$context->getAwsRequestId()）、path 等字段
11. serverless.yml 基础配置：provider 指定 name: aws、runtime: php-82、memorySize、timeout；package 设置 individually: true 并 exclude node_modules 和 .git；functions 中 handler 指向 public/index.php，events 用 http path /{proxy+} method ANY
12. 部署与验证流程：composer require bref/bref --dev 安装 Bref；sam local invoke -e event.json 本地测试；vendor/bin/bref deploy 部署；aws lambda invoke --function-name <name> --payload '{"path": "/", "httpMethod": "GET"}' /dev/stdout 验证
13. Symfony 完整 serverless.yml：provider 配置 stage、region、environment（APP_ENV、APP_DEBUG）、iam role statements（如 dynamodb:GetItem/PutItem）；functions 中 web handler 为 public/index.php（timeout 30、memorySize 1024、http /{proxy+} ANY），console handler 为 bin/console（timeout 300、schedule rate(1 day)）；plugins 引入 ./vendor/bref/bref；custom 定义 stage、region、isLocal
14. 注意 Lambda 限制：部署包解压后最大 250MB（压缩 50MB）、内存 128MB-10GB、API Gateway 超时 29s、异步 15 分钟、默认并发 1000
15. PHP 特定注意事项：PHP 冷启动中等，用 Bref 优化 runtime；保持 composer.json 精简，共享依赖用 Lambda Layers；使用 PHP 8.2+；Lambda 容器是临时的，持久化用 S3/DynamoDB
16. 规避常见陷阱：用 --no-dev 排除 dev 依赖避免 vendor 过大；会话存储不要用本地文件，改用 DynamoDB；长时运行进程不适合 Lambda，改用 ECS；WebSocket 用 API Gateway WebSockets 或 AppSync
17. 安全实践：不要硬编码凭证，使用 IAM roles 和 SSM Parameter Store；校验所有输入；使用最小权限 IAM 策略；启用 CloudTrail 审计日志；设置正确的 CORS 头
18. 创建 Symfony Lambda API 的流程：composer create-project 初始化 Symfony；composer require bref/bref 安装 Bref；配置 serverless.yml；在 config/routes.yaml 设置路由；sam local invoke 本地测试；vendor/bin/bref deploy 部署；aws lambda invoke 验证
19. 优化 Symfony 冷启动的流程：分析启动时加载的服务；关闭未使用的 Symfony 功能（validation、annotations）；对重型服务使用延迟加载；优化 composer autoload；部署并调用以验证冷启动 < 2s
20. 配置 GitHub Actions CI/CD：创建 workflow；用 composer 搭建 PHP 环境；运行 PHPUnit 测试；用 Serverless Framework 部署；验证 Lambda 函数存在并能响应

适用边界 · 注意事项

• 需要长时运行进程的场景（Lambda 不适合，应改用 ECS）
• 需要 WebSocket 的场景（应改用 API Gateway WebSockets 或 AppSync）
• 需要本地持久化存储的场景（Lambda 容器是临时的，应改用 S3/DynamoDB）