frankenphp 在 macos 上是自包含二进制,仅需 macos 12+ 和 xcode 命令行工具;推荐 homebrew 和 git,无需 php/nginx/apache/php-fpm 等传统组件。

在 macOS 上安装 FrankenPHP 不需要额外安装 PHP、Nginx 或 PHP-FPM 等传统组件,它本身就是一个自包含的二进制程序,内置 PHP 解析器和 Caddy Web 服务器。
必需依赖(仅系统级基础支持)
FrankenPHP 对 macOS 的依赖极轻,仅需以下两项:
- macOS 12(Monterey)或更高版本,推荐 Apple Silicon(ARM64)或 Intel x86_64 架构
-
命令行工具(Xcode Command Line Tools):用于后续可能的 Go 模块编译或扩展开发,运行
xcode-select --install即可安装
推荐但非强制的开发辅助工具
这些不参与 FrankenPHP 运行,但能显著提升开发体验:
-
Homebrew:最便捷的安装方式依赖它(
brew install frankenphp),官网也提供独立二进制包作为备选 - Git:若需克隆示例项目、管理代码或构建嵌入式应用
- Docker Desktop(可选):用于容器化部署或测试多环境兼容性,非本地运行 FrankenPHP 所必需
无需安装的传统组件
FrankenPHP 明确替代了以下常见栈组件,安装时不要手动安装它们:
- PHP(如通过
brew install php安装的独立 PHP CLI)——FrankenPHP 自带完整 PHP 运行时 - Nginx / Apache / PHP-FPM —— 全部由内置 Caddy 和原生 worker 模式接管
- Composer(虽仍用于管理 PHP 项目依赖)——但它属于项目级工具,不是 FrankenPHP 的运行依赖
总结来说,一台干净的 macOS(12+),装好 Xcode 命令行工具,再配个 Homebrew,就能直接运行 brew install frankenphp 完成安装。整个过程不冲突、不冗余、不需配置额外服务进程。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











