如何在 XAMPP 中为不同的虚拟主机配置独立的 PHP 版本-php教程-PHP中文网

不能在 httpd-vhosts.conf 的 virtualhost 中配置 phpinidir，因为该指令和 loadmodule php_module 是全局指令，仅允许在服务器级（如 httpd.conf）出现一次；在虚拟主机中使用会报错，必须改用 mod_fcgid + fcgidwrapper 实现 per-vhost 多版本 php。

如何在 xampp 中为不同的虚拟主机配置独立的 php 版本

为什么不能直接在 `httpd-vhosts.conf` 里写 `PHPIniDir`

因为 Apache 的 PHPIniDir 和 LoadModule php_module 指令是**全局生效**的，只允许出现一次。你在 <virtualhost></virtualhost> 块里加这些指令，Apache 启动时会直接报错：Invalid command 'PHPIniDir', perhaps misspelled or defined by a module not included in the server configuration。这不是配置顺序问题，而是模块设计限制——mod_php 是服务器级模块，不支持 per-vhost 切换。

必须用 FastCGI 模式（`mod_fcgid`）才能按站点分 PHP 版本

核心思路是绕过 Apache 内置的 mod_php，改用外部 CGI 进程管理不同 PHP 版本的 php-cgi.exe。每个虚拟主机绑定一个独立的 ScriptAlias 和 FcgidWrapper，由 Apache 把请求转发给对应版本的 CGI 进程。

先启用 mod_fcgid：在 httpd.conf 中取消注释这一行：LoadModule fcgid_module modules/mod_fcgid.so

添加基础配置（放在 httpd.conf 末尾）：

 <ifmodule fcgid_module>
    FcgidInitialEnv PHPRC "C:/xampp/php74"
    FcgidMaxRequestsPerProcess 1000
    FcgidMaxProcesses 50
    FcgidIOTimeout 60
    FcgidIdleTimeout 60
</ifmodule>

为每个站点单独配置 wrapper 路径，例如 PHP 7.4 站点：

<virtualhost>
    ServerName site74.local
    DocumentRoot "C:/xampp/htdocs/site74"
    <directory>
        Options Indexes FollowSymLinks ExecCGI
        AllowOverride All
        Require all granted
        AddHandler fcgid-script .php
        FcgidWrapper "C:/php/php-7.4.33/php-cgi.exe" .php
    </directory></virtualhost>

对应 PHP 8.2 站点就换路径：FcgidWrapper "C:/php/php-8.2.12/php-cgi.exe" .php
别忘了在 C:\Windows\System32\drivers\etc\hosts 加解析：127.0.0.1 site74.local site82.local

PHP 二进制包必须匹配 Apache 的 VC 和线程模型

Windows 下出错最常见原因不是配置，而是二进制不兼容。XAMPP 2025 年后默认用 VC16 编译的 Apache，所以你下载的 PHP 必须是：Thread Safe (TS) + VC16 + x64（与你的 XAMPP 架构一致）。从 windows.php.net/downloads/releases/ 下载时看清楚文件名，比如 php-8.2.12-Win32-vs16-x64.zip 才能用；vc15 或 Non-Thread Safe (NTS) 版本会启动失败，错误日志里常出现 Cannot load module 或 entry point not found。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

解压后必须复制一份 php.ini 到该目录（用 php.ini-development 改名即可）
php-cgi.exe 所在目录要确保有完整扩展 DLL（如 php_mysqli.dll），否则运行时报 undefined function mysqli_connect
如果某个站点提示 Primary script unknown，大概率是 FcgidWrapper 路径写错了，或 php-cgi.exe 权限被系统拦截（右键属性 → 解除锁定）

CLI 和 Web 的 PHP 版本是两套体系，别混着切

上面所有配置只影响 Apache 处理 HTTP 请求时的 PHP 版本。你在命令行敲 php -v 或运行 composer install，走的是系统 PATH 里的 php.exe，和 Web 完全无关。想让终端也切版本，得另配脚本或改环境变量 —— 但千万别直接改系统 PATH，否则 Composer 可能因扩展缺失而崩溃。更稳妥的做法是：每个项目根目录放一个 .php-version 文件，再用工具（如 phpenv 或自写批处理）读取并临时注入 PATH。

真正容易被忽略的是：不同 PHP 版本的扩展 ABI 不兼容。比如你在 PHP 8.2 下编译的 sqlsrv 扩展，绝对不能扔进 PHP 7.4 目录里用 —— 即使文件存在，Apache 启动时也不会加载，也不会报错，只会静默跳过。确认方式是访问 phpinfo() 页面，看 Loaded Extensions 列表是否真包含你要的扩展名。