PHP文件包含路径由PHP引擎控制，需配置include_path选项；可通过修改php.ini、Apache虚拟主机/.htaccess中php_value指令或PHP代码中set_include_path()/ini_set()三种方式设置，并用get_include_path()验证。

Apache本身不直接管理PHP的“文件包含路径”，这个功能由PHP引擎控制。所谓设置PHP文件包含路径，实质是配置PHP的 include_path 选项，让 include、require 等语句能自动在指定目录中查找文件，无需写冗长的相对或绝对路径。

修改php.ini中的include_path

这是最常用、最推荐的方式：

• 找到你正在使用的 php.ini 文件（可通过 phpinfo() 页面确认路径，或检查 Apache 配置中 PHPIniDir 指向的位置）
• 搜索 include_path，它通常默认类似：
  ;include_path = ".:/php/includes"
• 取消注释（删掉开头的分号），并按需添加自定义目录，多个路径用英文分号（Windows）或冒号（Linux/macOS）分隔。例如：
  include_path = ".;D:\mylib;D:\project\shared"
• 保存后重启 Apache，使 PHP 配置生效

在Apache虚拟主机或目录级配置中动态设置

若需为某个站点单独设定包含路径，可在 httpd-vhosts.conf 或 .htaccess 中使用 php_value（需启用 mod_php 且 AllowOverride 允许）：

• 在 或 块内添加：
  php_value include_path ".:/var/www/site/lib:/var/www/common"
• 注意：该方式在 PHP 运行于 FPM 模式（如通过 proxy_fcgi）时无效，仅适用于模块模式（libphp.so）
• 确保 Apache 配置中未禁用 php_value 指令（检查 AllowOverride 和 php_admin_flag 设置）

运行时用PHP代码临时追加路径

适合开发调试或条件性加载场景，不影响全局配置：

btpanel phpsite 宝塔面板PHP网站

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

下载

• 在脚本开头使用：
  set_include_path(get_include_path() . PATH_SEPARATOR . '/path/to/my/libs');
• 也可用 ini_set()：
  ini_set('include_path', '.:/custom/path');
• 这种方式只对当前请求有效，不涉及 Apache 配置文件修改

验证是否生效

创建一个测试文件（如 test_inc.php），内容如下：

echo get_include_path();
?>

访问该文件，输出结果应包含你设置的路径。再尝试 require 'somefile.php';（把 somefile.php 放在你设的路径下），成功执行即表示配置正确。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！