symfony 5.4本地开发需先满足php 7.2.5+（推荐8.0+）及mbstring、intl、xml、curl、pdo等扩展，再安装composer 2.x和symfony cli，用symfony new my_project --version=5.4创建项目，运行symfony server:start启动服务，并配置.env中app_env=dev、database_url后执行doctrine:database:create验证连接。
开始本地开发前，得把环境搭稳、基础配置理清。Symfony 5.4 不是装完就能直接写业务的，几个关键准备步骤跳过容易后续卡住。
安装 PHP 和扩展依赖
Symfony 5.4 要求 PHP 7.2.5 或更高版本（推荐 PHP 8.0+），且必须启用以下扩展：
- mbstring：处理多字节字符串（如中文、UTF-8）
- intl：国际化支持（日期、数字、时区等格式化）
- xml 和 curl：组件通信与 HTTP 请求必需
- pdo 及对应数据库驱动（如 pdo_pgsql 或 pdo_mysql）
Windows 用户建议用 XAMPP/WAMP 或直接安装 PHP 官方二进制包；macOS 推荐 Homebrew + php@8.1；Linux 用户可用 apt/yum 启用对应扩展。运行 php -m | grep -E "(mbstring|intl|curl)" 确认已加载。
安装 Composer 和 Symfony CLI
Composer 是 PHP 的包管理器，必须先装好：
- 从 getcomposer.org 下载并全局安装
- 验证：
composer --version（应显示 2.x 版本）
Symfony CLI 是官方推荐的本地开发工具，比原生 PHP 内置服务器更贴近生产行为：
- 下载地址：symfony.com/download（含 Linux/macOS/Windows 二进制）
- 放入 PATH，运行
symfony version确认 - 它会自动检测项目、启动 Web 服务器、管理环境变量、甚至跑测试
创建项目并校验基础服务
用 Symfony CLI 创建新项目最稳妥：
symfony new my_project --version=5.4- 进入目录：
cd my_project - 启动服务：
symfony server:start（不是php -S）
访问 https://127.0.0.1:8000（首次会提示信任自签名证书），看到 Symfony 欢迎页即表示成功。注意检查控制台是否提示 “Web Server listening on https://127.0.0.1:8000” —— 若只监听 HTTP 或报错，说明 OpenSSL 或 TLS 配置未就绪。
配置 .env 和数据库连接
所有敏感配置统一走 .env 文件，不要硬编码：
- 打开
.env，确认APP_ENV=dev和APP_DEBUG=1已启用（开发必需） - 数据库配置示例（以 SQLite 快速起步）：
DATABASE_URL=sqlite:///%kernel.project_dir%/var/data.db - 若用 MySQL，改写为：
DATABASE_URL=mysql://db_user:db_pass@127.0.0.1:3306/db_name?serverVersion=5.7
执行 php bin/console doctrine:database:create 测试连接是否通。失败常见原因：MySQL 未运行、用户无权限、密码含特殊字符未 URL 编码（需用 %40 代替 @ 等）。
