Windows 11 安装 Symfony 的关键是三步:配稳 PHP 环境(≥8.1、启用 intl/mbstring/curl/xml/fileinfo)、设置 date.timezone = "Asia/Shanghai"、用 Composer 或 Symfony CLI 创建项目(如 composer create-project symfony/skeleton:^7.0),最后 php -S 启动即可访问欢迎页。

在 Windows 11 上装 Symfony 不难,关键在三步:PHP 环境配稳、时区和扩展不漏、用对命令建项目。全程不用改复杂配置,10 分钟内就能看到欢迎页。
确认并配置 PHP 环境
打开 PowerShell 或 CMD,依次运行:
- php -v —— 确保输出 ≥ 8.1(Symfony 6+ 要求)
- php -m | findstr "intl mbstring curl xml fileinfo" —— 检查这 5 个扩展是否已启用(intl 尤其重要)
- php --ini —— 查看当前 CLI 模式使用的 php.ini 路径
若缺扩展:用记事本打开上面查到的 php.ini,取消对应行前的分号,例如:;extension=mbstring → 改为 extension=mbstring
改完保存,重启终端再验证。
立即学习“PHP免费学习笔记(深入)”;
在 Windows 11 上"直接发声"的 TTS(从 WSL2/TUI 调用 powershell.exe + System.Speech)。适用于用户说"说出来/读出来/语音播报/用TTS",或反馈"没声音/tts 生成的 mp3 是空的/播不出来",以及需要中文语音但 OpenClaw 内置 tts 不可用时。
必须设置默认时区(解决常见报错)
这是 Windows 下最常卡住的一步。不设时区,后续所有命令(composer、bin/console)都会报 Warning:
- 在同一个 php.ini 文件中,找到
[Date]区块,添加或修改这一行:date.timezone = "Asia/Shanghai" - 保存后运行:
php -r "echo date_default_timezone_get();"
输出必须是Asia/Shanghai才算生效
如果仍报错,请检查是否编辑了错误的 php.ini(CLI 和 Apache/Nginx 可能用不同配置文件)。
安装 Composer 并配置国内镜像
Composer 是目前唯一推荐的安装方式(旧版 symfony.phar 已下线,页面 404):
- 从 getcomposer.org 下载 Windows 安装程序,一路下一步
- 安装完运行:composer -V,有版本号即成功
- 为加速依赖下载,立即配置阿里云镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
创建并启动 Symfony 项目
两种方式任选其一:
-
推荐新手:用 Symfony CLI(更稳定、自带 HTTPS)
去 symfony.com/download 下载 Windows 安装包,安装后运行:
symfony new my_project --webapp
进入目录:cd my_project,启动:symfony server:start -
通用方式(无需额外工具)
直接运行:
composer create-project symfony/skeleton:^7.0 my_project
(^7.0 表示最新 7.x LTS 版本)
进目录后启动:php -S 127.0.0.1:8000 -t public
浏览器访问 https://www.php.cn/link/f0838b2ebfc6440a474eabdc326bf31a,看到绿色 “Welcome to Symfony” 页面,右下角显示 “Your application is ready”,就表示成功了。


















