虚拟域名配置完成Symfony新项目访问设置-php教程-PHP中文网

Symfony新项目需Web服务器指向public目录并配置信任域名：root或DocumentRoot必须为project/public，.env设APP_URL，framework.yaml加trusted_hosts，再清缓存验证。

虚拟域名配置完成symfony新项目访问设置

虚拟域名配好后，Symfony 新项目不能直接访问，得配合 Web 服务器（Apache 或 Nginx）和 Symfony 路由机制一起调通。核心不是“配完域名就自动能用”，而是确保请求能正确落到 public/index.php 入口，并被 Symfony 内核识别和分发。

虚拟域名的根目录必须设为项目 public/ 子目录，不是项目根目录。否则会暴露敏感文件（如 .env、config/），也导致 index.php 不被执行。

Apache：在虚拟主机配置中检查 DocumentRoot 是否为 /path/to/your/project/public
Nginx：检查 root 指令是否指向 /path/to/your/project/public，且 location ~ ^/(?:index|app|index\.php|app\.php) { ... } 转发规则存在
本地开发常用方式：用 symfony server:start --no-tls 启动内置服务器，它自动处理路由和 public 入口，无需额外配 Web 服务器

Symfony 默认只响应 localhost 和 127.0.0.1 的请求。若用自定义域名（如 myapp.test），需显式加入信任列表，否则返回 400 Bad Request。

Symfony Linux版

Symfony Linux版整理 Symfony CLI 5.17.1 官方下载入口和 Symfony 框架安装配置说明。

下载

编辑 .env，设置 APP_URL=https://myapp.test（协议、域名、端口要与实际一致）
在 config/packages/framework.yaml 中添加或修改：
trusted_hosts: ['^myapp\.test$']（正则写法，末尾 $ 防止子域名误匹配）
多个域名用数组：trusted_hosts: ['^myapp\.test$', '^staging\.myapp\.com$']

即使域名解析和 Web 服务都对了，也可能因环境或路由问题返回 404 或空白页。

运行 php bin/console debug:router 确认主页路由（如 app_home）存在且路径正确
检查 config/routes.yaml 是否有默认路由映射，例如：
controller:
path: /
controller: App\Controller\HomeController::index
确认当前环境是 dev（查看 .env 中 APP_ENV=dev），避免因 prod 缓存未更新导致页面不刷新

配置变更后，旧缓存可能掩盖真实状态，尤其在 prod 环境下更明显。

开发环境：运行 php bin/console cache:clear
生产环境：加 --env=prod 并确保有写权限：php bin/console cache:clear --env=prod
浏览器访问前，清空本地 DNS 缓存（ipconfig /flushdns on Windows，sudo dscacheutil -flushcache on macOS）
用 curl -I http://myapp.test 查看 HTTP 状态码和响应头，确认返回 200 而非 500 或 404