使用 symfony cli 启动 symfony 8.1.9 内置服务器:先确保 php ≥ 8.1 及扩展就绪、安装 symfony cli 5.10+,再用 composer create-project 创建 website-skeleton 项目,执行 symfony server:start 并访问 https://www.php.cn/link/5804a7bec176070ba227bdeaa23c5913 验证欢迎页,最后通过 make:controller 添加 homecontroller 实现动态页面与调试栏联动。

要基于 Symfony 8.1.9 搭建一个可运行的应用并启动内置 Web 服务,关键不是堆砌配置,而是走通“创建 → 验证 → 启动 → 访问”这四步闭环。当前版本(2026年10月)已完全移除 WebServerBundle,官方唯一推荐且开箱即用的方式是使用 Symfony CLI 启动本地服务器。
确保基础环境就绪
Symfony 8.1.9 要求明确:
- PHP ≥ 8.1,且启用
mbstring、xml、curl、fileinfo、intl扩展(运行php -v && php -m | grep -E "(mbstring|xml|curl|intl)"快速确认) - 已安装 Composer 2.5+ 和 Symfony CLI 5.10+(执行
symfony -V应返回版本号;未安装请从 symfony.com/download 获取) - 项目必须使用
website-skeleton(含 Twig、Profiler、MakerBundle 等),而非精简版skeleton
创建并初始化 Symfony 8.1.9 项目
在终端中执行:
composer create-project symfony/website-skeleton myapp cd myapp
接着验证 Flex 是否生效:
php bin/console about
看到输出中包含 Flex: enabled,说明项目结构和自动配置已就位。此时 .env 默认已是 APP_ENV=dev 和 APP_DEBUG=1,无需手动修改。
启动 Symfony 内置 Web 服务
在项目根目录下直接运行:
symfony server:start
成功后终端会显示类似:
打开浏览器访问 https://www.php.cn/link/5804a7bec176070ba227bdeaa23c5913,看到 Symfony 欢迎页即表示服务已正常运行。
如需后台运行或查看日志,可用:
-
symfony server:stop—— 停止服务 -
symfony server:log—— 实时查看请求与错误日志(阻塞式) -
symfony server:status—— 查看当前服务状态
添加第一个动态页面(验证流程完整)
运行命令生成控制器:
php bin/console make:controller HomeController
编辑 src/Controller/HomeController.php,将 index() 方法改为:
return $this->render('home/index.html.twig', ['name' => '王五']);
创建模板文件 templates/home/index.html.twig,内容为:
<h1>你好,{{ name }}!</h1>
访问 https://www.php.cn/link/5804a7bec176070ba227bdeaa23c5913/home,页面显示“你好,王五!”,说明路由、控制器、模板三者已联动成功。
页面右下角的紫色调试栏会同步出现,点击可查看本次请求的路由匹配、Twig 变量、数据库查询(如有)等详情——这是开发阶段最直接的反馈入口。











