vendor/bin/bref 无反应因缺少可执行头，须用 php vendor/bin/bref package 调用；runtime: 'provided.al2' 是 AWS 自定义运行时标准命名，Bref 依赖此精确匹配；PHP handler 中禁用 $_SERVER 和 echo，应通过 $event/$context 输入及 error_log 输出。
composer require bref/bref 之后为什么 vendor/bin/bref 没反应？
因为 bref/bref 是开发时用的工具包，不是命令行可执行二进制——它本身不提供全局 bref 命令。你看到的 vendor/bin/bref 实际是 Composer 自动生成的符号链接，指向 src/Console/BrefApplication.php，但这个文件没有 #!/usr/bin/env php 魔法头，也不能直接执行。
真正要用 Bref 的 CLI 功能（比如打包、本地测试），得靠 php vendor/bin/bref 显式调用：
- ✅ 正确：
php vendor/bin/bref package - ❌ 错误：
vendor/bin/bref package（报错：Permission denied 或 command not found） - ⚠️ 注意：某些终端会缓存命令路径，改完
vendor/bin后建议运行hash -d bref清缓存
serverless.yml 里 runtime: 'provided.al2' 是什么意思？
这是 AWS Lambda 官方对“自定义运行时”的命名规范，不是 Bref 自创的。Bref 的 PHP 运行时本质是一个兼容 provided.al2 ABI 的引导层（bootstrap），所以必须严格匹配。填错会直接导致部署失败或冷启动超时。
常见错误写法和后果：
立即学习“PHP免费学习笔记（深入）”；
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
runtime: 'php-8.2'→ CloudFormation 报错：InvalidParameterValueException: The runtime parameter of nodejs18.x is not supported（Lambda 不认识这个值） -
runtime: 'provided'→ 部署成功但函数执行时报错：Cannot find module '/var/task/bootstrap'（旧版provided不支持 AL2 环境） - ✅ 正确写法只有：
runtime: 'provided.al2'，且必须配合 Bref v1.5+ 和layer配置
PHP 函数 handler() 为什么不能用 $_SERVER 或 echo？
Lambda 不是传统 Web 服务器，没有 CGI 环境变量，也没有 stdout 输出通道。Bref 的运行时接管了整个生命周期，所有输入输出都走它的封装逻辑。
典型误用和对应解法：
-
echo "hello"→ 输出被丢弃，日志里看不到（除非用error_log()） -
$_SERVER['REQUEST_URI']→ 总是空或不存在，HTTP 请求信息在事件参数里 - ✅ 正确做法：handler 接收两个参数 ——
$event（原始触发数据）和$context（Lambda 上下文），返回值会被自动序列化为响应 - ✅ 日志请用
error_log('msg')，它会出现在 CloudWatch Logs 中
示例：
return function ($event, $context) {
return [
'statusCode' => 200,
'body' => json_encode(['message' => 'Hello from Lambda']),
];
};
部署后函数超时或内存溢出，是不是该调大 memorySize？
不一定。Bref 默认用的是 Amazon Linux 2，而很多 PHP 扩展（尤其是 GD、Imagick、XMLWriter）在 AL2 上默认未启用或需额外编译。盲目加内存只会让账单变高，问题还在。
先检查这几个点：
- 运行
php -m查看实际加载的扩展 —— 在 Lambda 中要靠extensions配置显式开启，比如gd、opcache、zip - 确认
php.ini设置是否生效：Bref 不读取项目根目录下的php.ini，得用php-ini层或phpSettings配置项 - 如果用了 Composer autoload classmap，注意
composer dump-autoload --optimize会生成大文件，可能撑爆 50MB 的 deployment package 限制 - ✅ 推荐做法：用
bref cli本地模拟运行一次：php vendor/bin/bref local:invoke index.php --event event.json，比盲调参数快得多
AL2 环境里 PHP 扩展的可用性比本地开发机低不少，这点最容易被忽略。
