从零搭建PHP项目：Symfony安装及数据库连接配置全流程【指南】-php教程-PHP中文网

从零搭建 symfony 项目须严格遵循环境准备、flex 初始化、database_url 规范配置、doctrine 迁移建表及 symfony server 启动五步；跳过 flex、手写配置、误配 .env 是三大典型错误。

从零搭建php项目：symfony安装及数据库连接配置全流程【指南】

从零开始搭一个 Symfony 项目，关键不是“装完就行”，而是每一步都踩在正确路径上：环境要稳、命令要准、配置要严。跳过 Flex、手写配置、乱改 .env 格式，是新手最常掉的三个坑。

环境准备：PHP + Composer + CLI 三件套必须到位

别急着敲命令，先确认基础链路通：

运行 php -v，确保 PHP ≥ 8.2（Symfony 官方推荐，7.4 已停止维护）；必须启用 mbstring、xml、zip、pdo_sqlite 和 intl 扩展（缺 intl 会导致 Twig 或日期格式报错）
运行 composer -v，确认 Composer 可用；国内用户建议提前设镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
Symfony CLI 不是必须，但强烈推荐装——macOS 用 brew install symfony-cli/tap/symfony-cli，Linux/Windows 见官网。它能自动处理证书、热重载和本地 HTTPS，比 php -S 稳得多

创建项目：只用一条命令，且必须带 Flex

进终端，执行这一条：

composer create-project symfony/website-skeleton myapp

注意：别用 skeleton（太轻量，缺 Twig/Doctrine 默认配置），也别手动 mkdir + composer init——那样不会触发 Flex recipe，config/packages/ 下空空如也，src/Controller/ 不自动生成，后续全靠猜配置。

创建完立刻验证 Flex 是否生效：

cd myapp && php bin/console about → 输出里要有 Flex: enabled

再检查 .env 文件开头两行是否为：

APP_ENV=dev<br>APP_DEBUG=1

数据库连接：DATABASE_URL 是唯一入口，其他全是配角

打开 .env，找到并修改这行（删掉原有 DATABASE_URL）：

DATABASE_URL="mysql://app_user:my%40pass@127.0.0.1:3306/myapp?serverVersion=8.0&charset=utf8mb4"

重点细节不能错：

协议头必须是 mysql://（不是 mysql: 或漏掉 //）
地址写 127.0.0.1，别写 localhost（否则可能走 Unix socket，报 No such file or directory）
serverVersion 必须显式声明，MySQL 8.0 写 ?serverVersion=8.0，5.7 就写 5.7；缺了会导致 JSON 字段、CTE 查询等语法不识别
密码含 @、/、: 要 URL 编码，例如 pass@word → pass%40word
务必加上 &charset=utf8mb4，否则 emoji 和部分中文会存成问号

然后执行：

Symfony Linux版

Symfony Linux版整理 Symfony CLI 5.17.1 官方下载入口和 Symfony 框架安装配置说明。

下载

php bin/console doctrine:database:create
如果报 Access denied，90% 是 MySQL 用户权限不足，不是 URL 写错了。进 MySQL 执行：

CREATE USER 'app_user'@'%' IDENTIFIED BY 'my%40pass';<br>GRANT CREATE, SELECT, INSERT, UPDATE, DELETE ON myapp.* TO 'app_user'@'%';<br>FLUSH PRIVILEGES;