如何在共享 cPanel 环境中为不同子目录指定独立 PHP 版本-php教程-PHP中文网

如何在共享 cPanel 环境中为不同子目录指定独立 PHP 版本

在不更改全局 php 设置的前提下，可通过 cpanel 的 multi-php 功能为特定子目录（如 laravel 项目）绑定更高版本的 php（如 8.0+），而保留其他目录（如 codeigniter）继续使用默认的 php 7.4。

在不更改全局 php 设置的前提下，可通过 cpanel 的 multi-php 功能为特定子目录（如 laravel 项目）绑定更高版本的 php（如 8.0+），而保留其他目录（如 codeigniter）继续使用默认的 php 7.4。

cPanel 提供的 Multi-PHP Manager 是解决多版本共存问题的标准方案，尤其适用于同一域名下运行多个框架（如 CodeIgniter + Laravel）且版本依赖冲突的场景。该功能无需 root 权限，也无需修改系统级 PHP 配置，仅需在目标子目录中部署对应的 .htaccess 规则即可生效。

✅ 操作步骤（以 Laravel 9 项目为例）

登录 cPanel → 进入 MultiPHP Manager（通常位于「Software」区域）；
找到你的主域名（如 example.com），点击右侧「Manage」；
在目录树中定位 Laravel 项目所在路径（例如 /public_html/laravel9/）；
从下拉菜单中选择 PHP 8.0（或更高兼容版本，如 8.1/8.2）；
点击「Apply」——cPanel 将自动在该目录下生成或更新 .htaccess 文件，并插入如下类似规则：

# php -- BEGIN cPanel-generated handler, do not edit
# Set the “ea-php80” package as the default “PHP” programming language.
<ifmodule mime_module>
  AddHandler application/x-httpd-ea-php80 .php .php8 .phtml
</ifmodule>
# php -- END cPanel-generated handler, do not edit

⚠️ 注意：ea-php80 是 EasyApache 4 中 PHP 8.0 的标准 Handler 名称；若服务器启用的是 PHP 8.1，则对应为 ea-php81。请勿手动修改 Handler 名称，应始终通过 cPanel UI 设置，避免语法错误导致 500 错误。

? 验证是否生效

在 Laravel 目录下创建一个临时 info.php 文件：

btpanel phpsite 宝塔面板PHP网站

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

下载

<?php phpinfo(); ?>

访问 https://example.com/laravel9/info.php，确认顶部显示的 PHP Version 为 8.0.x，且 Server API 显示为 Apache 2.0 Handler（表明 .htaccess 规则已正确加载）。

? 重要提醒

此方案仅对 Apache + mod_mpm_prefork + suPHP/LSAPI 环境有效；若您的 GoDaddy 服务器使用的是 LiteSpeed 或 Nginx（无 Apache 兼容模式），.htaccess 方式将不生效，需改用 lsapi 配置或联系主机商启用 PHP Selector；
CodeIgniter 所在目录（如 /public_html/ 根目录）保持默认设置，其 .htaccess 中不得包含任何覆盖 PHP 版本的 AddHandler 指令，否则可能意外影响子目录；
修改后若页面报错 500 Internal Server Error，请检查 .htaccess 是否存在语法冲突（如重复 IfModule 块），建议备份后删除自定义规则，重新通过 cPanel 生成。