安装symfony关键在环境就绪、命令选对、验证及时:需php≥7.4(推荐8.1+)并启用intl等扩展,composer配好镜像源;推荐用symfony new my_project --full创建完整项目,启动后访问http://localhost:8000见欢迎页即成功。

安装 Symfony 不是单纯敲一条命令的事,关键在环境是否就绪、命令是否选对、验证是否及时。只要 PHP 版本够、扩展开了、Composer 能用,后续几步基本不会卡住。
一、先确认 PHP 环境是否达标
这是最容易出问题的环节,别跳过检查:
- 运行 php -v,确保版本 ≥ 7.4(推荐 8.1+)
- 必须启用的扩展包括:intl、mbstring、xml、curl、fileinfo、tokenizer、openssl
- Windows 用户建议用 XAMPP/WAMP;macOS 用 Homebrew(brew install php);Linux 用户可用 apt install php 或 dnf install php
- 改完 php.ini 后记得重启终端或服务,再执行 php --ini 确认配置生效
二、装好 Composer 并配好镜像源
Composer 是 Symfony 依赖管理的唯一入口,国内用户不换源大概率会卡在下载环节:
- 运行 composer -v 验证是否安装成功
- 执行以下命令切换阿里云镜像(推荐):
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 如果已有旧项目或全局配置冲突,可加 --global 强制覆盖
三、选择一种方式创建项目(新手推荐 CLI)
两种主流方式,区别在于“开箱即用”程度:
-
用 Symfony CLI(推荐新手):
先安装 CLI(macOS: brew install symfony-cli/tap/symfony-cli;Windows 下载 exe;Linux 用脚本安装)
再执行:symfony new my_project --full → 自动生成含 Doctrine、Twig、Webpack Encore 的完整栈 -
用 Composer(适合轻量或微服务):
composer create-project symfony/skeleton my_project
之后按需执行 composer require webapp 或 composer require orm 补充功能
四、启动服务并验证欢迎页
项目生成后,立刻验证是否跑得起来:
- 进入目录:cd my_project
- 启动开发服务器:
有 CLI: symfony server:start
无 CLI: php bin/console server:run - 打开浏览器访问 http://localhost:8000(不是 https),看到 Symfony 欢迎页即表示安装成功
- 如遇端口占用,CLI 可加参数指定:symfony server:start --port=8080
装完别急着写业务,先跑通 php bin/console make:controller TestController,再访问 /test 看页面是否渲染出来——这一步能同时验证路由、控制器、模板三者连通性。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











