FrankenPHP v1.4可在macOS本地直接运行Laravel 12项目：下载对应架构二进制，放入/usr/local/bin并赋权；执行frankenphp serve --worker=public/index.php --addr=127.0.0.1:8080启动，需先生成APP_KEY并修复storage权限。
在macOS上用FrankenPHP v1.4本地运行Laravel 12项目，无需安装PHP、Composer或Apache/Nginx，直接通过二进制启动PHP应用服务器即可加载Laravel的public目录并响应HTTP请求。
下载并配置FrankenPHP v1.4二进制
访问 https://github.com/dunglas/frankenphp/releases/tag/v1.4.0，下载 frankenphp_darwin_arm64.tar.gz（Apple Silicon）或 frankenphp_darwin_amd64.tar.gz（Intel），解压后将 frankenphp 文件放入 /usr/local/bin 并赋予可执行权限：sudo chmod +x /usr/local/bin/frankenphp。
执行 frankenphp version 确认输出包含 v1.4.0 字样；若提示“command not found”，请检查PATH是否包含 /usr/local/bin。
准备Laravel 12项目环境
确保已通过 laravel new myapp --git 或 composer create-project laravel/laravel myapp "12.*" 创建项目，且项目根目录下存在 public/index.php 和 artisan 文件。
立即学习“PHP免费学习笔记（深入）”；
进入项目根目录，运行 php artisan key:generate --no-interaction 生成APP_KEY；这一步不可跳过，否则FrankenPHP启动后访问首页会报500错误。
执行 chmod -R 755 storage bootstrap/cache，避免FrankenPHP因权限不足无法写入日志和缓存。
启动FrankenPHP服务
方法一：使用内置Web服务器模式（推荐快速验证）
在Laravel项目根目录下执行：frankenphp serve --worker=public/index.php --addr=127.0.0.1:8080。该命令会自动监听8080端口，将所有请求路由到Laravel的public入口。
方法二：使用自定义frankenphp.yaml配置（适合调试或启用HTTPS）
在项目根目录创建 frankenphp.yaml，内容为：
server:
http:
address: 127.0.0.1:8080
apps:
- name: laravel-app
entrypoint: public/index.php
然后运行 frankenphp run 启动。
打开浏览器访问 http://127.0.0.1:8080，看到Laravel 12欢迎页即表示成功。
