零基础学 Symfony 的核心是环境配对、项目建好、页面跑通;5 分钟内用 website-skeleton 模板创建项目,启动服务后访问欢迎页,再通过 make:controller 快速实现首个动态 MVC 页面。

零基础学 Symfony,核心就三件事:环境配对、项目建好、页面跑通。不用改配置文件、不碰 XML、不手动下载包,5 分钟内从空白终端看到自己的第一个页面。
确认 PHP 和 Composer 已就绪
打开终端,运行以下命令检查基础环境:
- php -v —— 必须显示 PHP 8.0 或更高版本(推荐 8.1+)
- php -m | grep -E "(mbstring|xml|curl|intl|fileinfo)"(macOS/Linux)或在 Windows 上执行 php -m 后人工核对 —— 确保这 5 个扩展已启用
- composer --version —— 有输出即表示 Composer 已安装并加入系统 PATH
若缺扩展,Windows 用户可直接装 XAMPP;macOS 推荐 brew install php;Ubuntu/Debian 执行:
sudo apt install php-cli php-mbstring php-xml php-curl php-intl php-fileinfo php-zip
国内用户建议提前设 Composer 镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
创建一个开箱即用的项目
新手别用 skeleton(太精简),也别手动初始化,直接用带完整 Web 堆栈的模板:
- 运行命令:composer create-project symfony/website-skeleton myapp
- 进入目录:cd myapp
- 验证 Flex 是否生效:php bin/console about → 输出中必须含 Flex: enabled
这个命令自动集成 Twig、Doctrine、MakerBundle、WebProfilerBundle 和 Flex 配置中枢,省去后续大量手动配置。
启动服务并访问欢迎页
确保你在项目根目录,任选一种方式启动:
- 已装 Symfony CLI:symfony server:start → 浏览器打开 https://www.php.cn/link/5804a7bec176070ba227bdeaa23c5913
- 未装 CLI:php -S 127.0.0.1:8000 -t public → 浏览器打开 https://www.php.cn/link/f0838b2ebfc6440a474eabdc326bf31a
看到绿色 “Welcome to Symfony” 页面,且右下角显示 “Your application is ready”,说明安装成功。
快速写出你的第一个动态页面
欢迎页是静态的,下一步让页面“活”起来:
- 生成控制器:php bin/console make:controller HomepageController
- 编辑 src/Controller/HomepageController.php,将
index()方法改为:
return $this->render('homepage/index.html.twig', ['name' => '张三']); - 在 templates/homepage/index.html.twig 中写:
<h1>你好,{{ name }}!</h1> - 清除缓存(首次访问前建议):php bin/console cache:clear
- 访问 https://www.php.cn/link/f0838b2ebfc6440a474eabdc326bf31a/homepage,看到带名字的标题,MVC 就走通了
整个流程无需改路由配置、不写 XML、不碰 .env 数据库设置——先跑通逻辑,再逐步深入。


















