不能在本地 macos/windows 直接 composer install，因 lambda 运行于 amazon linux，本地构建的 vendor 依赖不同 abi/glibc，导致 exec format error 或 undefined symbol；必须用 aws 官方镜像（如 public.ecr.aws/sam/build-php8.2）docker 构建，确保 php 版本、扩展、架构一致，并严格使用 --no-dev --optimize-autoloader。
为什么不能在本地 macOS/Windows 上直接 composer install？
因为 Lambda 运行在 Amazon Linux 2 或 2023 上，ext-mbstring、ext-curl、ext-zip 等扩展是动态链接的系统库（如 libcurl.so、libicu.so），本地编译的 vendor/ 会依赖 macOS 或 Windows 的 ABI 和 glibc 版本，上传后启动直接报 exec format error 或 undefined symbol 错误。
常见错误现象包括：
-
PHP Fatal error: Uncaught Error: Class 'Monolog\Logger' not found—— autoload_static.php 路径生成错误，因本地 PHP 缺少扩展导致映射失败 -
failed to open stream: No such file or directory in /var/task/vendor/autoload.php——vendor/被打包进子目录（如src/vendor），但入口文件从根目录 require -
Function not found: curl_init()—— 本地没装ext-curl，--ignore-platform-reqs强行通过，但 Lambda 没这个扩展
必须用与 Lambda 完全一致的环境构建：PHP 版本、架构（x86_64 或 arm64）、glibc 版本、已启用扩展列表。
怎么用 Docker 构建兼容的 vendor/ 目录？
AWS 官方提供预配置镜像，例如 public.ecr.aws/sam/build-php8.2，它已预装 zip、git、curl 和所有 Lambda 支持的 PHP 扩展（mbstring、json、xml、pdo 等），无需额外配置。
执行命令要严格：
- 挂载当前目录到
/var/task，保持路径一致性 - 只运行
composer install --no-dev --optimize-autoloader，不执行update（避免污染composer.lock） - 确保
composer.json中未设置"platform": {"php": "8.2"}—— 镜像里 PHP 版本已固定，伪造 platform 会导致 autoloader 生成错误路径
示例：
docker run --rm -v $(pwd):/var/task public.ecr.aws/sam/build-php8.2 \ /bin/sh -c "cd /var/task && composer install --no-dev --optimize-autoloader"
构建完检查 vendor/autoload.php 是否存在，且 vendor/composer/autoload_static.php 中的类映射路径为相对路径（如 __DIR__ . '/..' . '/src/MyClass.php'），而非绝对路径。
部署包 ZIP 结构和入口文件怎么组织？
Lambda 从 ZIP 根目录执行，所以 index.php（或你定义的 handler 文件）必须在 ZIP 顶层，且能直接加载 vendor/autoload.php。
正确结构示例：
function.zip
├── index.php
├── composer.json
├── vendor/
│ ├── autoload.php
│ └── ...
└── src/
└── Handler.php
关键点：
-
index.php中写require __DIR__ . '/vendor/autoload.php';，不是../vendor/autoload.php - 不要把整个项目套进
src/后再 zip —— Serverless Framework 默认只打包当前目录，若用package/include，必须显式写- 'vendor/**'和- 'index.php' - ZIP 不能超过 50MB（直接上传限制），解压后不能超 250MB ——
--no-dev和--optimize-autoloader是硬性要求
打包命令建议（Linux/macOS）：
zip -r function.zip index.php vendor/ src/ -x "*/tests/*" "*/.git/*" "*/node_modules/*"
哪些依赖必须用 Layer 而不能放进 vendor/？
Composer 只能管理纯 PHP 包。以下类型无法通过 composer require 安装，必须走 Lambda Layer：
- 系统级扩展：如
ext-gd（需 libpng/jpeg）、ext-imagick（需 ImageMagick 库）、ext-grpc（需 grpc C 库） - 二进制工具：如
ffmpeg、pdftk、ghostscript - 非 PHP SDK：如 AWS CLI v2（含 Python 运行时）、自定义 OpenSSL 替代
Layer ZIP 必须按运行时路径组织：bin/ 放可执行文件（自动加入 PATH），lib/ 放共享库（自动加入 LD_LIBRARY_PATH），PHP 扩展则放 php/extensions/（Lambda 会自动扫描并加载）。
注意：ext-gd 这类扩展即使通过 PECL 安装，也必须在 Amazon Linux 环境中编译成 .so，再放进 Layer 的 php/extensions/ 下；直接把本地 .so 丢进去会因 glibc 不兼容而 dlopen failed。
Layer 和 ZIP 部署包是正交的：vendor/ 解决 PHP 类加载，Layer 解决底层依赖。两者缺一不可，但混淆边界（比如试图用 Composer 安装 ext-redis）只会浪费时间。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
