在macOS 13 Ventura上手动安装FrankenPHP v1.3需绕过Homebrew版本滞后限制，直接下载官方预编译二进制，验证校验和后复制至/opt/homebrew/bin（Apple Silicon）或/usr/local/bin（Intel），赋权并配置PATH，最后通过frankenphp version和简易服务测试验证成功。
在 macOS 13 Ventura 上手动安装 FrankenPHP v1.3，需绕过 Homebrew 未同步新版本的限制，直接下载官方预编译二进制并配置可执行权限与系统路径，避免源码编译带来的 OpenSSL 路径冲突和扩展缺失问题。
确认系统环境与基础依赖
运行 xcode-select --install 确保命令行工具已就绪；若未装 Homebrew，执行 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 安装。Apple Silicon（M1/M2/M3）用户注意：Homebrew 默认根路径为 【/opt/homebrew】，后续所有路径引用必须与此一致，否则 shell 找不到 brew 命令。
执行 brew install openssl@3 curl webp libpng libjpeg-turbo freetype 补齐图像与加密底层依赖——FrankenPHP v1.3 内置 PHP 8.5，其 GD 扩展编译时强依赖这些库的头文件，缺一则构建失败或运行时报“Unable to load dynamic library 'gd.so'”。
下载并验证 FrankenPHP v1.3 二进制
访问 GitHub Releases 页面，定位到 frankenphp_1.3.0_macOS_arm64.tar.gz（M系列芯片）或 frankenphp_1.3.0_macOS_amd64.tar.gz（Intel 芯片），用 curl 下载：curl -L -o frankenphp-v1.3.tar.gz https://github.com/dunglas/frankenphp/releases/download/v1.3.0/frankenphp_1.3.0_macOS_arm64.tar.gz。
立即学习“PHP免费学习笔记（深入）”；
解压后进入目录，检查文件完整性：shasum -a 256 frankenphp 输出值须与 Release 页面下方 “Checksums.txt” 中对应条目完全一致；不匹配说明下载中断或被篡改，【必须删除重下】，否则执行时会 panic 并退出。
安装到系统并加入 PATH
第一步：将解压出的 frankenphp 二进制复制到 /opt/homebrew/bin/（Apple Silicon）或 /usr/local/bin/（Intel）：sudo cp frankenphp /opt/homebrew/bin/。
第二步：赋予可执行权限：sudo chmod +x /opt/homebrew/bin/frankenphp。
第三步：验证 PATH 是否生效——打开新终端窗口，执行 echo $PATH，确认输出中包含 /opt/homebrew/bin；若无，需在 ~/.zshrc 末尾追加 export PATH="/opt/homebrew/bin:$PATH" 并执行 source ~/.zshrc。
快速验证安装结果
方法一：运行版本检查：frankenphp version，正确输出应为 v1.3.0，且无 “command not found” 或 “dyld: Library not loaded” 错误。
方法二：启动最小服务测试：frankenphp server --document-root /tmp --router /tmp/router.php，同时在 /tmp/router.php 中写入：<?php return ['index' => 'index.php'];，再创建 /tmp/index.php 输出 <?php echo 'OK';；访问 http://localhost:8080 应返回纯文本 OK。
若浏览器报 ERR_CONNECTION_REFUSED，说明 frankenphp 进程未启动成功，立即查看终端是否打印 “failed to bind to :8080”——这通常因端口被占用，换用 --addr :8081 即可。
