必须使用symfony cli或正确配置的php内置服务器启动项目,否则twig不渲染、.env不加载、web profiler不显示;推荐执行symfony server:start,访问https://127.0.0.1:8000并验证/_profiler和web debug toolbar是否正常。

要让刚创建的 Symfony 项目立刻响应浏览器请求,必须启动一个能正确解析路由和环境变量的开发服务器,不能直接用 PHP 的 php -S 简单起服务——否则 Twig 模板不渲染、.env 变量不加载、Web Profiler 不显示。
使用 Symfony CLI 启动(推荐)
第一步:确保已安装 Symfony CLI 工具。若未安装,执行 curl -sS https://get.symfony.com/cli/installer | bash(Linux/macOS),Windows 用户请下载 exe 安装包并加入 PATH。
第二步:进入项目根目录,运行 symfony server:start。
第三步:终端输出类似 Web server listening on https://127.0.0.1:8000 后,打开浏览器访问 https://127.0.0.1:8000 即可看到欢迎页。注意:默认启用 HTTPS,若浏览器报证书警告,点击“高级→继续访问”即可(这是本地自签名证书,安全)。
用 PHP 内置服务器启动(仅限调试或无 CLI 环境)
方法一:适用于 website-skeleton 或 flex 项目
在项目根目录执行:php -S localhost:8000 -t public。这一步必须指定 -t public,否则会找不到 index.php 入口,404 报错。
方法二:手动加载环境变量(避免 .env 未生效)
先运行 export $(grep ^SYMFONY_ENV= .env | xargs)(Linux/macOS),再执行 php -S localhost:8000 -t public;Windows 用户需改用 set SYMFONY_ENV=dev && php -S localhost:8000 -t public。
验证服务器是否真正就绪
① 访问 https://127.0.0.1:8000/_profiler,能看到 Web Profiler 界面,说明调试工具已激活。
② 在欢迎页右下角检查 Web Debug Toolbar 是否出现——它只在 dev 环境且 APP_ENV=dev 时显示。如果没看到,运行 APP_ENV=dev php bin/console about 确认输出中 Environment: dev 和 Flex: enabled 均为 true。
③ 打开浏览器开发者工具 → Network 标签,刷新页面,观察是否有 profiler/xxx 请求成功返回 200 —— 这是 Profiler 正常工作的关键信号。











