核心是统一doctrine配置、规避路径与网络解析差异、严控字符集和php扩展；需用php 5.4–5.6（如5.6.40），确保pdo_mysql、intl、mbstring扩展启用，database_host设为127.0.0.1，优先使用.env配置database_url并显式声明utf8mb4字符集。
Win 和 Mac 下搭建 Symfony2 数据库查询环境，核心不是换系统重装，而是统一 Doctrine 配置、规避平台路径与网络解析差异、严控字符集和 PHP 扩展。多数报错看似是“连接失败”，实则是 host 解析、编码未设、扩展缺失或命令行终端不兼容导致的。
PHP 与扩展必须严格对齐
Symfony 2.x（如 2.8）只兼容 PHP 5.4–5.6，用 PHP 7+ 或 8.x 反而会因函数废弃或反射变更直接报致命错误。务必确认：
- 运行 php -v，版本显示为 5.6.40 最稳妥（XAMPP/PHPStudy 推荐选含此版本的包）
- 执行 php -m | findstr "pdo_mysql intl mbstring"（Windows）或 php -m | grep -E "(pdo_mysql|intl|mbstring)"（macOS），确保三项全在列表中
- 若缺 intl，项目创建会中断；缺 pdo_mysql，则任何数据库命令都提示“Driver not found”
数据库连接配置别写 localhost
Windows 下 localhost 默认尝试走 IPv6 或 Unix socket，macOS 则可能因 hosts 解析顺序异常；两者都容易触发 Connection refused 或 No such file or directory 错误。
- 统一改用 127.0.0.1：在 app/config/parameters.yml 中设 database_host: 127.0.0.1
- macOS 用户若用 Homebrew MySQL，检查 my.cnf 是否绑定了 bind-address = 127.0.0.1（而非 skip-networking 或 ::1）
- Windows 用户若用 ZIP 版 MySQL，首次启动前必须先执行 mysqld --initialize-insecure 初始化 data 目录，否则服务无法启动
.env 文件优先于 parameters.yml
Symfony 2.8+ 已支持 .env 文件接管数据库参数，比 parameters.yml 更轻量、更跨平台，且避免 Windows 反斜杠路径干扰。
- 在项目根目录新建或编辑 .env，写入：
DATABASE_URL="mysql://root:password@127.0.0.1:3306/symfony_db?serverVersion=5.7&charset=utf8mb4" - 密码含 @ / : 等符号时，必须 URL 编码（如 pass@word → pass%40word）
- 务必带上 &charset=utf8mb4，否则中文、emoji 存入后变问号，且该设置在 Win/macOS 上行为一致
终端与命令行行为要适配
同一条 doctrine 命令，在 Windows CMD、Git Bash、macOS Terminal 下表现可能不同，根源是编码和交互模式。
- Windows 用户禁用 CMD 的“快速编辑模式”（右键标题栏 → 属性 → 编辑选项 → 取消勾选），否则 doctrine:generate:entity 类交互命令会卡住
- 终端执行含中文字段的命令前，先运行 chcp 65001（Windows）或确认 macOS 终端设为 UTF-8 编码
- 避免用 Windows 记事本编辑 .env 或 YAML 文件——它默认保存为 ANSI 或带 BOM 的 UTF-8，会导致 Symfony 解析失败；推荐 VS Code 或 Sublime Text，并保存为 UTF-8 无 BOM
