frankenphp本地开发遇跨域因默认不处理cors，根源在symfony未配置nelmiocorsbundle：需安装该包、启用bundle、配置nelmio_cors.yaml中allow_origin为具体域名数组（禁用*）、确保options请求进入symfony内核，prod环境还需清除缓存并确认app_env=prod生效。
FrankenPHP 本地开发时为什么还会遇到跨域？
因为 FrankenPHP 默认不处理 CORS，它只是把请求原样转发给 Symfony 应用——而 Symfony 自身若没配好 CORS，浏览器照样拦截。你看到的 Access-Control-Allow-Origin 缺失、405 Method Not Allowed 或 OPTIONS 请求无响应，根源不在 FrankenPHP，而在 Symfony 的响应头没发出来。
别在 PHP 脚本里手动加 header()，改用 NelmioCorsBundle
手动在控制器或中间件里写 header() 容易漏掉预检逻辑、无法覆盖 CLI 请求、且和 Symfony 的事件生命周期冲突。正确做法是统一交给 NelmioCorsBundle 管理：
- 确保已安装：
composer require nelmio/cors-bundle - 确认
config/bundles.php中启用：Nelmio\CorsBundle\NelmioCorsBundle::class => ['all' => true] -
config/packages/nelmio_cors.yaml至少包含这些显式项：
nelmio_cors:
defaults:
allow_credentials: true
allow_origin: ['http://localhost:3000', 'http://127.0.0.1:3000']
allow_methods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS']
allow_headers: ['Content-Type', 'Authorization', 'X-Requested-With']
expose_headers: ['Link']
max_age: 3600
注意：allow_origin 必须是数组，不能写 ['*']；否则搭配 allow_credentials: true 会触发浏览器静默丢弃响应。
FrankenPHP + Symfony 开发时 OPTIONS 请求仍失败？检查路由是否被跳过
FrankenPHP 启动 Symfony 时默认走 public/index.php 入口，但如果你用了 FrankenPHP 的 worker mode 或自定义路由规则，可能绕过了 Symfony 的内核事件（比如 CorsListener 没执行）。验证方法：
- 在
src/EventListener/CorsDebugListener.php中加一行：dump('cors listener hit');，注册为kernel.request事件监听器 - 发起一个
OPTIONS /api/users请求，看终端是否输出 - 如果没输出，说明请求根本没进 Symfony —— 此时需检查 FrankenPHP 的
Caddyfile是否把OPTIONS转发给了index.php，而不是被 Caddy 自己响应了
典型错误配置：respond * 200 或 reverse_proxy 规则没覆盖 OPTIONS 方法。
dev 环境正常、prod 下跨域失效？缓存和环境变量是关键
FrankenPHP 在 prod 模式下运行时，Symfony 缓存不会自动刷新，旧的 CORS 配置可能还在容器里：
- 每次改完
nelmio_cors.yaml，必须运行：php bin/console cache:clear --env=prod - 确认
.env中APP_ENV=prod和APP_DEBUG=0已生效（FrankenPHP 会读取它们） - 如果用
frankenphp serve启动，它默认加载dev环境；生产部署要用frankenphp run并指定--env=prod
最容易被忽略的是：FrankenPHP 的静态文件服务（如 public/ 下的 JS/CSS）不经过 Symfony，所以对这些资源的跨域请求，得靠 Caddy 的 header 指令单独配，和 NelmioCorsBundle 无关。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
