FrankenPHP 入门指南:安装方式、使用命令与文档导航(基于 Caddy 的现代 PHP 应用服务器)
FrankenPHP 入门指南安装方式、使用命令与文档导航基于 Caddy 的现代 PHP 应用服务器【免费下载链接】frankenphp The modern PHP app server项目地址: https://gitcode.com/GitHub_Trending/fr/frankenphp本文以日语版项目首页文档 docs/ja/README.md 为骨架结合仓库源码整理而成介绍 FrankenPHP 的定位、多种安装途径、两种开箱即用的运行命令以及官方文档体系的导航。FrankenPHP 是一个构建在 Caddy Web 服务器之上的现代 PHP 应用服务器核心目标是把 Caddy 的生产级 HTTP 能力与 PHP 运行时深度整合到一个可执行文件中。本文面向初次接触 FrankenPHP 的开发者介绍它的核心特性、六种主流安装方式安装脚本、静态二进制、rpm/deb 包、Docker、Homebrew、基础使用命令php-server与php-cli并给出完整的官方文档导航帮助读者快速选型、安装并启动第一个 PHP 应用。一、FrankenPHP 是什么从仓库根目录的 README.md 与日语版首页 docs/ja/README.md 可以看出FrankenPHP 的核心定位如下基于 CaddyFrankenPHP 直接复用 Caddy Web 服务器作为 HTTP 层因此天然继承自动 HTTPS、HTTP/2、HTTP/3 等生产级能力无需额外配置反向代理。面向 PHP 应用它可以承载任何 PHP 应用通过官方文档所述的 Worker 模式官方集成可以显著加速 Laravel、Symfony 等框架项目。内置高级特性包括 Early Hints103 状态码、Worker 模式、基于 Mercure 的实时功能、自动 HTTPS、HTTP/2、HTTP/3 等。可作为 Go 库嵌入FrankenPHP 同时是一个独立的 Go 库允许你使用标准库net/http将 PHP 嵌入任意 Go 应用。从仓库结构看其 Go 侧实现由根目录的 frankenphp.go、worker.go、threadworker.go、scaling.go 等文件构成PHP 侧桥接代码位于 frankenphp.c、frankenphp.h而 Caddy 模块注册与命令入口位于 caddy 目录最终可执行文件入口为 caddy/frankenphp/main.go。提示Windows 用户请使用 WSL 来运行 FrankenPHP。二、安装方式FrankenPHP 提供多种安装途径覆盖 Linux、macOS 与容器环境。下表汇总了各方式的适用场景安装方式适用系统扩展管理安装脚本Linux/macOS自动检测不可额外安装扩展静态二进制Linux/macOS开发用途不可额外安装扩展rpm 包使用dnf的系统Fedora/RHEL 系dnf或 PIEdeb 包使用apt的系统Debian/Ubuntu 系apt或 PIEDocker任意支持 Docker 的系统自定义镜像构建HomebrewmacOS/LinuxPIE1. 安装脚本在终端执行以下命令脚本会自动检测系统与架构并安装匹配的版本curl https://frankenphp.dev/install.sh | sh仓库根目录的 install.sh 正是该脚本的实现它会通过uname -s/uname -m判断操作系统与架构Linux 的aarch64/x86_64并优先检测dnf、apt-get等包管理器将 FrankenPHP 安装为对应发行版的原生软件包否则回退到直接下载预编译静态二进制到当前目录可通过BIN_DIR环境变量指定安装目录。2. 静态二进制官方为 Linux 与 macOS 提供面向开发用途的静态 FrankenPHP 二进制内置 PHP 8.4 及主要 PHP 扩展下载地址官方 Releases 页面。扩展说明常用扩展已内置在二进制中无法再安装额外的 PHP 扩展静态二进制场景下PHP 扩展必须编译进二进制本体。3. rpm 包dnf 系统面向所有使用dnf的系统安装步骤如下sudo dnf install https://rpm.henderkes.com/static-php-1-0.noarch.rpm sudo dnf module enable php-zts:static-8.4 # 8.2-8.5 可用 sudo dnf install frankenphp扩展安装sudo dnf install php-zts-extension非默认扩展使用 PIE 安装sudo dnf install pie-zts sudo pie-zts install asgrim/example-pie-extension安装后systemd 服务使用的 Caddyfile 位于/etc/frankenphp/Caddyfilephp.ini位于/etc/php-zts/php.ini详见 install.sh 中的安装输出。4. deb 包apt 系统面向所有使用apt的系统先添加官方仓库再安装sudo curl -fsSL https://key.henderkes.com/static-php.gpg -o /usr/share/keyrings/static-php.gpg \ echo deb [signed-by/usr/share/keyrings/static-php.gpg] https://deb.henderkes.com/ stable main | sudo tee /etc/apt/sources.list.d/static-php.list \ sudo apt update sudo apt install frankenphp扩展安装sudo apt install php-zts-extension非默认扩展使用 PIEsudo apt install pie-zts sudo pie-zts install asgrim/example-pie-extension5. Docker官方 Docker 镜像一行即可启动docker run -v .:/app/public \ -p 80:80 -p 443:443 -p 443:443/udp \ dunglas/frankenphp将当前目录挂载到容器的/app/public作为站点根目录映射 80/443 端口443/udp 用于 HTTP/3启动后浏览器访问https://localhost即可看到欢迎页。[!TIP] 请使用https://localhost而非https://127.0.0.1以便接受自签名证书。如需更换域名请设置SERVER_NAME环境变量。6. HomebrewmacOS 与 Linux 均可通过 Homebrew 安装brew install dunglas/frankenphp/frankenphp扩展安装使用 PIE。三、基础使用两个核心命令FrankenPHP 提供两条开箱即用的命令php-server生产可用的 PHP Web 服务器与php-cliCLI 脚本执行器。1. 提供静态与 PHP 文件服务php-server在当前目录提供内容服务frankenphp php-server该命令在 caddy/php-server.go 中注册支持以下参数参数简写作用--domainexample.com-d指定域名同时启用 HTTPS并切换默认监听端口为 443--rootpath-r站点根目录--listenaddr-l自定义监听地址--worker/path/to/worker.php[,nb-workers]-w启用 Worker 模式可多次指定--watch[glob-pattern]—监听文件变化并重启 Worker可重复指定--access-log-a开启访问日志--debug-v开启详细调试日志--mercure-m启用内置 Mercure.rocks hub--no-compress—关闭 Zstandard、Brotli、Gzip 压缩从源码实现可以看到其默认行为未指定--listen时若无域名则监听:80有域名则监听 443HTTPS未指定--root且处于嵌入模式时回退到public/自动构建路由目录请求重定向308→ index 文件重写 →*.php交给 FrankenPHP 处理 → 其余资源交给file_server默认开启 zstd/br/gzip 压缩除非--no-compress。2. 执行命令行脚本php-clifrankenphp php-cli /path/to/your/script.php该命令在 caddy/php-cli.go 中注册行为与 PHP CLI SAPI 类似它会保留argv语义第 0 个参数为程序自身并将脚本执行交给 cli.go 中的ExecuteScriptCLI最终返回脚本的退出状态码。3. 作为系统服务运行通过 deb/rpm 包安装后可用 systemd 管理服务sudo systemctl start frankenphp仓库中的 package/debian/frankenphp.service 与 package/rhel/frankenphp.service 展示了服务配置要点启动前先执行frankenphp validate --config /etc/frankenphp/Caddyfile校验配置以frankenphp专用用户运行工作目录为/var/lib/frankenphp通过AmbientCapabilitiesCAP_NET_BIND_SERVICE仅授予绑定 80/443 端口所需的最小权限配置了ProtectHome、ProtectSystem、PrivateTmp等加固选项热重载sudo systemctl reload frankenphp对应frankenphp reload --config ... --force。Alpine 的 OpenRC 初始化脚本 package/alpine/frankenphp.openrc 提供了等价的启停与重载逻辑。四、快速上手示例安装后在任意包含 PHP 文件的目录启动服务frankenphp php-server打开http://localhost若设置了域名则访问对应 HTTPS 地址即可访问站点。仓库根目录的 testdata/index.php 与 package/content/index.php 可作为最简单的 PHP 入口文件参考。若需要更精细的控制可通过 Caddyfile 配置。仓库提供了两个现成模板简化版示例配置 caddy/frankenphp/Caddyfile包含php_server站点块、SERVER_NAME/SERVER_ROOT等环境变量占位、可选的 Mercure/Vulcain 模块默认注释、以及import Caddyfile.d/*.caddyfile扩展机制发行版安装默认使用的 package/Caddyfile。五、官方文档导航日语版 README 提供了完整的文档索引对应仓库 docs 目录中的同名文档主题文档仓库路径经典模式classicdocs/classic.mdWorker 模式docs/worker.mdEarly Hints103 状态码docs/early-hints.md实时功能Mercuredocs/mercure.md大静态文件高效传输X-Sendfiledocs/x-sendfile.md配置Caddyfile、php.ini、环境变量docs/config.mdDocker 镜像docs/docker.md生产环境部署docs/production.md性能优化docs/performance.md独立可执行 PHP 应用embeddocs/embed.md静态二进制构建docs/static.md从源码编译docs/compile.md监控metricsdocs/metrics.mdLaravel 集成docs/laravel.md已知问题docs/known-issues.md贡献与调试docs/CONTRIBUTING.md此外日语版 README 还列出了社区提供的框架示例与骨架项目Symfony、API Platform、Laravel、Sulu、WordPress、Drupal、Joomla、TYPO3、Magento2 等可作为落地实践的参考起点。六、进阶指引从入门到源码当你已经能成功启动 FrankenPHP 后可按以下路径继续深入了解 Worker 模式阅读 docs/worker.md 与 worker.go理解应用常驻内存、跨请求复用的原理掌握完整配置阅读 docs/config.md掌握 Caddyfile 中php_server/php指令、frankenphp全局块、php_ini、环境变量注入等全部配置手段阅读 Caddy 模块源码caddy/module.go 定义了 FrankenPHP 的 Caddy 模块php_server、php、worker 配置解析caddy/caddy.go 负责模块注册与生命周期探索 Go 库用法若要把 PHP 嵌入自己的 Go 服务可参考 frankenphp.go 的导出 API 与 README.md 中的 Go 库示例。结语FrankenPHP 把 Caddy 的自动 HTTPS、HTTP/2/3、Early Hints 与 PHP 应用运行时合二为一提供了从一行命令php-server/php-cli到完整 Caddyfile 配置的渐进式使用路径。无论你是想在开发环境快速起一个 PHP 站点还是在生产环境部署 Laravel/Symfony 并启用 Worker 模式都可以从本文的安装与启动步骤出发再按文档导航深入对应主题。【免费下载链接】frankenphp The modern PHP app server项目地址: https://gitcode.com/GitHub_Trending/fr/frankenphp创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

Flutter与HarmonyOS 6.0跨平台文件管理实战

Flutter与HarmonyOS 6.0跨平台文件管理实战

1. 项目概述:Flutter与HarmonyOS 6.0的跨平台文件管理方案在移动应用开发领域,文件管理功能一直是刚需但实现复杂度高的模块。最近我用Flutter结合HarmonyOS 6.0(鸿蒙)完成了一个文件管理系统原型,实测在Android和Harm…

2026/11/9 20:25:08 阅读更多 →
Flutter性能优化:微服务网关限流熔断下的客户端降级与重试策略

Flutter性能优化:微服务网关限流熔断下的客户端降级与重试策略

前阵子做Flutter性能专项,遇到一个挺有意思的场景:后端微服务已经上了网关限流熔断,Sentinel配置也做得挺规范,结果大促那会儿移动端反而成了最先崩的一环。一开始以为是后端被打爆了,翻监控发现网关层面拒绝了大量请求…

2026/11/10 11:11:40 阅读更多 →
基于Java springboot招投标管理系统-附源码

基于Java springboot招投标管理系统-附源码

温馨提示:本人主页置顶文章(点我)开头有 CSDN 平台官方提供的学长联系方式的名片! 温馨提示:本人主页置顶文章(点我)开头有 CSDN 平台官方提供的学长联系方式的名片! 温馨提示:本人主页置顶文章(点我)开头有 CSDN 平台…

2026/10/21 8:29:00 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/21 23:27:35 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/21 23:27:35 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/21 23:27:35 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/21 23:27:35 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/21 23:27:36 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/21 23:27:37 阅读更多 →

日新闻

周新闻

月新闻