Windows/macOS通用：Symfony安装及多站点虚拟主机配置汇总【汇总】-php教程-PHP中文网

关键是通过统一php版本与扩展、symfony cli工具链及容器化（docker）屏蔽系统差异，配合.env.local和.gitattributes规范配置与换行，实现windows/macos多站点虚拟主机一致运行。

windows/macos通用：symfony安装及多站点虚拟主机配置汇总【汇总】

装 Symfony 本身不难，难点在于让它的底层依赖在 Windows 和 macOS 上都跑得稳、配得一致，尤其要支持多站点虚拟主机这种常见开发场景。关键不是分别折腾两个系统，而是用统一逻辑应对差异——PHP 版本与扩展必须对齐，CLI 工具链统一用 Symfony CLI，Web 服务层则根据宿主系统选合适托管方式（内置 server / Apache / Nginx），虚拟主机配置需绕过系统级权限和路径陷阱。

统一前置：三系统共通的硬性门槛

不管用哪套 Web 托管方案，以下四点必须先验证通过：

PHP ≥ 8.1：运行 php -v 确认版本；低于则重装（Windows 去 windows.php.net 下 NTS 包，macOS 用 brew install php）
必需扩展已启用：intl、mbstring、curl、openssl、xml、zlib；Windows 检查 php.ini 中对应 extension= 行是否取消注释，macOS 可用 php -m | grep intl 快速筛查
Composer 全局可用：执行 composer --version 有输出；国内用户建议立即配置镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
Symfony CLI 已安装并生效：macOS 执行 brew install symfony-cli/tap/symfony-cli，Windows 下载官方 symfony-cli-windows-amd64.exe 放入 PATH 目录；验证用 symfony version

多站点虚拟主机：两种通用落地方式

想在同一台机器跑多个 Symfony 项目（如 site-a.test、site-b.test），不推荐直接改 hosts + 启动多个 symfony server:start（端口易冲突、TLS 证书难管理）。更稳妥的是分场景选型：

Docker Image Puller

使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。

下载

开发阶段首选 Symfony CLI 内置反向代理模式：运行 symfony proxy:start 启动本地代理，再为每个项目单独执行 symfony server:start --no-tls --port=8001（依次换端口），最后在浏览器访问 https://site-a.wip 或 https://site-b.wip ——无需改 hosts，自动解析，跨平台行为一致
需要真实域名或对接 Apache/Nginx 时，走标准虚拟主机配置：Windows 用 XAMPP/WAMP，macOS 用 Homebrew Apache 或原生 Nginx；核心是把每个项目的 public/ 目录设为 DocumentRoot，并启用 mod_rewrite（Apache）或 try_files（Nginx）；域名统一加进 C:\Windows\System32\drivers\etc\hosts（Win）或 /etc/hosts（macOS），格式均为 127.0.0.1 site-a.test

Windows 与 macOS 配置差异避坑要点

同一套虚拟主机配置，在两边容易因细微差异失效。重点关注以下几处：

路径分隔符与大小写：Apache/Nginx 配置中一律用正斜杠 /；避免硬编码 C:\project\public 或 /Users/name/project/public，改用 %kernel.project_dir%/public 或环境变量 ${PROJECT_DIR}/public
PHP 扩展加载路径：Windows 的 extension_dir 在 php.ini 中通常写相对路径 "ext" 即可；macOS Homebrew 安装的 PHP，扩展路径默认为 /opt/homebrew/lib/php/pecl（Apple Silicon）或 /usr/local/lib/php/pecl（Intel），需确认 intl 对应的 .so 文件真实存在
SSL/TLS 证书问题：Windows 上 OpenSSL 配置常出错，启动内置 server 时加 --no-tls 更可靠；macOS 若提示证书不受信任，可在 Safari 中手动信任 localhost 证书，或改用 symfony server:ca:install 重新签发
端口占用排查逻辑不同：macOS 用 lsof -i :8000 查进程，Windows 用 netstat -ano | findstr :8000，杀进程命令也不同（macOS kill -9 PID，Windows taskkill /PID PID /F）

项目级可移植配置建议

让一个 Symfony 项目在 Windows 和 macOS 上都能“开箱即用”，靠的是声明式而非手动配置：

所有 Web 服务器配置（Apache vhost / Nginx server block）存入项目 config/ 目录，附带 README 说明启用步骤
用 .env.local 覆盖环境变量，避免写死数据库路径、缓存目录等；敏感值不提交 Git
在 docker-compose.yml 中定义完整栈（nginx + php-fpm + db），开发时统一 docker-compose up 启动，彻底屏蔽宿主系统差异
Git 提交 composer.lock，并在 .gitattributes 中强制 LF 换行：* text=auto eol=lf，防止 lock 文件校验失败