frankenphp 1.1 可免 docker、免编译、免系统 php,仅靠静态二进制即可运行本地 php 环境;支持纯 php 脚本直启及 laravel/symfony 等框架路由,提供端口、日志、域名模拟和 opcache 等调试配置。

用 FrankenPHP 1.1 搭建本地 PHP 开发环境,核心是“免 Docker、免编译、免系统 PHP”,靠一个静态二进制就能跑起来。它不依赖宿主机的 PHP 环境,也不需要配置 Nginx 或 Apache,适合快速验证、调试或轻量项目启动。
下载并准备 FrankenPHP 二进制
去 GitHub Releases 页面 找到 v1.1.x 版本(如 frankenphp_1.1.3_linux_amd64.tar.gz 或对应 macOS/Windows 的包),下载解压后确保有执行权限:
- Linux/macOS:运行
chmod +x frankenphp - Windows:直接双击或命令行运行
frankenphp.exe
启动最简 PHP 服务(纯 PHP 文件)
新建一个空目录,放一个 index.php:
<?php echo "FrankenPHP 1.1 is running ✅\n"; echo "PHP version: " . PHP_VERSION; ?>
在该目录下执行:
./frankenphp server --document-root .
默认监听 http://localhost:8080,浏览器访问即可看到输出。注意:不需要 .frankenphp.router.php,纯 PHP 脚本可直接响应。
支持 Laravel/Symfony 等框架的路由入口
若项目含 public/ 目录(如 Laravel),需指定文档根和路由文件:
- 进入项目根目录(含
public/) - 创建
public/.frankenphp.router.php,内容为:
<?php return [ 'index' => 'index.php', ];
然后运行:
./frankenphp server --document-root public/ --router ./public/.frankenphp.router.php
此时请求会正确转发到 public/index.php,Laravel 的路由、静态资源(CSS/JS)均可正常加载。
常用调试与配置技巧
开发中几个实用小技巧:
- 改端口:加
--addr :3000(监听:3000) - 看日志:默认输出到终端;加
--log-level debug查请求细节 - 模拟域名:用
--env SERVER_NAME=myapp.test配合 hosts 绑定,方便测试多租户或 APP_URL - 临时启用 OpCache:加
--env OPCACHE_ENABLE=1(FrankenPHP 1.1 已内置,无需额外扩展)
不复杂但容易忽略。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











