如何调整XAMPP中的PHP包含路径设置？
- 内容介绍
- 文章标签
- 相关推荐
本文共计1161个文字，预计阅读时间需要5分钟。
直接修改 `php.ini` 中的 `include_path` 配置项，但必须确认你修改的是 Apache 实际加载的那个文件——即不是随意一个叫做 `php.ini` 的副本。
先用 phpinfo() 确认路径：在 C:\xampp\htdocs\（Windows）或 /Applications/XAMPP/xamppfiles/htdocs/（macOS）下建个 info.php，内容为 <?php phpinfo(); ?>，浏览器访问 http://localhost/info.php，搜索 “include_path” 这一行，同时记下 “Loaded Configuration File” 的值。如果这行显示 “none”，说明当前没生效的 php.ini，任何修改都白搭。
- Windows 常见真实路径：
C:\xampp\php\php.ini - macOS 常见真实路径：
/Applications/XAMPP/xamppfiles/etc/php.ini - 找到后打开，搜索
include_path =，默认可能是注释掉的（前面有分号），去掉分号，改成类似这样：include_path = ".;C:\xampp\php\pear"（Windows）或include_path = ".:/Applications/XAMPP/xamppfiles/lib/php"（macOS） - 多个路径用分号（Windows）或冒号（macOS）分隔，开头加
.表示当前脚本所在目录，别漏掉
改完不生效？八成是没重启 Apache 或路径写错了
include_path 是 PHP 启动时读入内存的，运行中改 php.ini 完全无效。XAMPP 控制面板上点 “Restart” 不一定可靠——有些版本的 Restart 不会真正重载 PHP 配置，必须 Stop 再 Start。
- Windows 命令行强制重载：
C:\xampp\apache\bin\httpd.exe -k stop→ 等几秒 →C:\xampp\apache\bin\httpd.exe -k start - macOS 终端：
sudo /Applications/XAMPP/xamppfiles/bin/apachectl stop→sudo /Applications/XAMPP/xamppfiles/bin/apachectl start - 改完务必再刷一次
info.php，确认 “include_path” 值已更新，且 “Loaded Configuration File” 路径没变（说明还是同一个文件被加载） - 路径里含空格或中文？Windows 下建议用短路径（如
C:\xampp）；macOS 下注意权限，避免用~/这类用户路径，Apache 进程通常不以你的用户身份运行
include_path 和 require_once 的实际行为差异
设 include_path = ".:/var/www/libs"，执行 require_once "vendor/autoload.php" 时，PHP 会按顺序查找：
立即学习“PHP免费学习笔记（深入）”；
当前脚本所在目录/vendor/autoload.php/var/www/libs/vendor/autoload.php
但不会自动扫描子目录，也不会递归匹配。如果你希望加载 mylib/Helper.php，必须明确写 require_once "mylib/Helper.php"，而不是只写 Helper.php。
- 相对路径（如
../config/db.php）不受include_path影响，它始终按当前文件位置解析 -
get_include_path()可在代码里检查当前值；set_include_path()可临时覆盖，但仅对当前请求有效 - Composer 自动加载机制（
vendor/autoload.php）不依赖include_path，它是通过绝对路径注册的 autoload 函数，所以一般不用动这里
为什么有时候改了 include_path 还报 “failed to open stream”？
错误信息里出现 failed to open stream: No such file or directory，未必是路径错，更常见的是权限或符号链接问题。
- Windows 上从 Git Bash 或 VS Code 终端启动 Apache？可能导致路径解析异常，一律用 XAMPP 控制面板操作最稳
- macOS 上路径用了
~或$HOME？Apache 进程的$HOME是/var/empty，不是你的用户目录 - 路径末尾多了一个斜杠（如
/var/www/libs/）？PHP 不会自动忽略，它会严格按字面拼接，可能变成/var/www/libs//vendor/autoload.php—— 多数情况不影响，但某些 NFS 或容器环境会失败 - 用
realpath()手动验证路径是否存在：var_dump(realpath('/var/www/libs'));，返回false就说明路径根本不可达
真正容易被忽略的点：XAMPP 的 Apache 和 CLI PHP 可能加载不同的 php.ini。你在浏览器里看到的 include_path，和你在终端执行 php -r "echo get_include_path();" 输出的，经常不一样。调试时务必分清上下文。
本文共计1161个文字，预计阅读时间需要5分钟。
直接修改 `php.ini` 中的 `include_path` 配置项，但必须确认你修改的是 Apache 实际加载的那个文件——即不是随意一个叫做 `php.ini` 的副本。
先用 phpinfo() 确认路径：在 C:\xampp\htdocs\（Windows）或 /Applications/XAMPP/xamppfiles/htdocs/（macOS）下建个 info.php，内容为 <?php phpinfo(); ?>，浏览器访问 http://localhost/info.php，搜索 “include_path” 这一行，同时记下 “Loaded Configuration File” 的值。如果这行显示 “none”，说明当前没生效的 php.ini，任何修改都白搭。
- Windows 常见真实路径：
C:\xampp\php\php.ini - macOS 常见真实路径：
/Applications/XAMPP/xamppfiles/etc/php.ini - 找到后打开，搜索
include_path =，默认可能是注释掉的（前面有分号），去掉分号，改成类似这样：include_path = ".;C:\xampp\php\pear"（Windows）或include_path = ".:/Applications/XAMPP/xamppfiles/lib/php"（macOS） - 多个路径用分号（Windows）或冒号（macOS）分隔，开头加
.表示当前脚本所在目录，别漏掉
改完不生效？八成是没重启 Apache 或路径写错了
include_path 是 PHP 启动时读入内存的，运行中改 php.ini 完全无效。XAMPP 控制面板上点 “Restart” 不一定可靠——有些版本的 Restart 不会真正重载 PHP 配置，必须 Stop 再 Start。
- Windows 命令行强制重载：
C:\xampp\apache\bin\httpd.exe -k stop→ 等几秒 →C:\xampp\apache\bin\httpd.exe -k start - macOS 终端：
sudo /Applications/XAMPP/xamppfiles/bin/apachectl stop→sudo /Applications/XAMPP/xamppfiles/bin/apachectl start - 改完务必再刷一次
info.php，确认 “include_path” 值已更新，且 “Loaded Configuration File” 路径没变（说明还是同一个文件被加载） - 路径里含空格或中文？Windows 下建议用短路径（如
C:\xampp）；macOS 下注意权限，避免用~/这类用户路径，Apache 进程通常不以你的用户身份运行
include_path 和 require_once 的实际行为差异
设 include_path = ".:/var/www/libs"，执行 require_once "vendor/autoload.php" 时，PHP 会按顺序查找：
立即学习“PHP免费学习笔记（深入）”；
当前脚本所在目录/vendor/autoload.php/var/www/libs/vendor/autoload.php
但不会自动扫描子目录，也不会递归匹配。如果你希望加载 mylib/Helper.php，必须明确写 require_once "mylib/Helper.php"，而不是只写 Helper.php。
- 相对路径（如
../config/db.php）不受include_path影响，它始终按当前文件位置解析 -
get_include_path()可在代码里检查当前值；set_include_path()可临时覆盖，但仅对当前请求有效 - Composer 自动加载机制（
vendor/autoload.php）不依赖include_path，它是通过绝对路径注册的 autoload 函数，所以一般不用动这里
为什么有时候改了 include_path 还报 “failed to open stream”？
错误信息里出现 failed to open stream: No such file or directory，未必是路径错，更常见的是权限或符号链接问题。
- Windows 上从 Git Bash 或 VS Code 终端启动 Apache？可能导致路径解析异常，一律用 XAMPP 控制面板操作最稳
- macOS 上路径用了
~或$HOME？Apache 进程的$HOME是/var/empty，不是你的用户目录 - 路径末尾多了一个斜杠（如
/var/www/libs/）？PHP 不会自动忽略，它会严格按字面拼接，可能变成/var/www/libs//vendor/autoload.php—— 多数情况不影响，但某些 NFS 或容器环境会失败 - 用
realpath()手动验证路径是否存在：var_dump(realpath('/var/www/libs'));，返回false就说明路径根本不可达
真正容易被忽略的点：XAMPP 的 Apache 和 CLI PHP 可能加载不同的 php.ini。你在浏览器里看到的 include_path，和你在终端执行 php -r "echo get_include_path();" 输出的，经常不一样。调试时务必分清上下文。