在macos上为frankenphp v1.2.1安装zip扩展需区分容器与本地二进制模式：容器（dunglas/frankenphp）用install-php-extensions zip并重启；本地二进制须构建时通过--php-extensions zip静态编译，运行时无法动态加载。
在macOS上为FrankenPHP v1.2.1安装zip扩展，需先确认你使用的是FrankenPHP官方Docker镜像还是本地二进制；若用dunglas/frankenphp容器，扩展可直接通过install-php-extensions命令启用；若用本地frankenphp二进制（如frankenphp-linux-amd64或frankenphp-darwin-arm64），则必须在构建阶段静态编译zip，无法运行时动态加载——因为单二进制不含PHP扩展管理器，也不支持dl()或extension_dir动态挂载。
确认当前运行模式
执行docker ps查看是否正在运行FrankenPHP容器；若看到dunglas/frankenphp镜像名，说明你走的是容器路线；若你直接下载了frankenphp二进制并./frankenphp server启动，则属于本地二进制模式——这两种路径安装zip的方式完全不兼容，不能混用。
运行docker inspect your-frankenphp-container | grep Image，确认输出含"Image": "dunglas/frankenphp:..."；若无输出或报错，你大概率没在用容器，跳过下一节，直奔“本地二进制构建”部分。
容器内安装zip扩展（仅限dunglas/frankenphp官方镜像）
方法一：进入容器后一键安装
执行docker exec -it your-frankenphp-container bash进入交互式shell；这一步失败说明容器未运行或名称错误，请先docker ps核对容器名。
运行install-php-extensions zip；该命令会自动检测PHP版本、下载预编译的zip.so、写入ini并验证模块加载状态。
【必须重启容器】：安装完成后执行exit退出，再运行docker restart your-frankenphp-container；不重启会导致ZipArchive类不可用，因为PHP进程未重读扩展配置。
验证是否生效：在容器内执行php -m | grep zip，输出zip即成功；若为空，检查是否用了:static-builder这类精简镜像——它不含install-php-extensions工具，此方法失效。
本地二进制构建时启用zip（适用于frankenphp darwin-arm64/amd64）
FrankenPHP本地二进制不支持运行时安装扩展，zip必须在frankenphp build阶段嵌入。你无法后期补加，也不能靠修改php.ini启用。
第一步：确保项目已按生产标准清理
删除.git、tests/、storage/logs、vendor/bin；这些文件会被打包进最终二进制，zip扩展若未提前声明，构建时不会包含其依赖库。
第二步：显式声明zip扩展参与构建
在项目根目录执行构建命令时，必须传入--php-extensions参数：frankenphp build --output myapp --server-name localhost --php-extensions zip；注意不是install-php-extensions，也不是改php.ini，这是唯一生效方式。
第三步：检查构建日志关键词
构建过程中终端应出现Building PHP extension: zip和Embedding extension zip.so两行；若只看到Skipping extension zip (not found)，说明你的FrankenPHP CLI版本低于v1.2.1或未识别到系统zip开发头文件（macOS需先brew install libzip）。
第四步：验证生成二进制中的zip
运行./myapp --php-info | grep -A5 "zip"；若输出含zip support => enabled和Extension Version => 1.20（或更高），表示zip已静态链接成功；此时new ZipArchive()可在Laravel或原生PHP中直接调用。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
