简体中文
简体中文
get_include_path() 函数用于返回当前 PHP 配置中的文件包含路径。这些路径是 PHP 在 include、require 等函数中查找文件时所使用的路径。你可以将多个目录添加到文件包含路径中，PHP 会按顺序查找这些目录。
string get_include_path(void)
该函数没有参数，返回一个包含路径的字符串，路径之间由操作系统默认的分隔符（在 UNIX 系统中是冒号 :，在 Windows 系统中是分号 ;）分隔。
为了更好地理解 get_include_path()，我们来看一个简单的示例：
<?php
// 获取当前的文件包含路径
$currentIncludePath = get_include_path();
echo "当前的文件包含路径是：$currentIncludePath";
?>
在这段代码中，我们调用了 get_include_path()，并将返回值保存在 $currentIncludePath 变量中，然后输出到屏幕。执行这段代码后，你将看到当前 PHP 配置中的所有文件包含路径。
我们可以结合 get_include_path() 和 set_include_path() 函数来动态设置文件的包含路径。set_include_path() 函数用于设置新的文件包含路径，它会替换掉之前的路径，或者可以在原有路径的基础上添加新的路径。
<?php
// 获取当前的包含路径
$currentIncludePath = get_include_path();
echo "当前的文件包含路径是：$currentIncludePath\n";
// 设置新的文件包含路径
$newIncludePath = "/var/www/includes";
set_include_path($newIncludePath . PATH_SEPARATOR . $currentIncludePath);
// 输出更新后的包含路径
echo "更新后的文件包含路径是：" . get_include_path() . "\n";
// 现在我们可以在新的路径下包含文件
include('myfile.php');
?>
在这个示例中，我们首先获取了当前的文件包含路径。接着使用 set_include_path() 函数动态添加了一个新的路径 /var/www/includes，并将其与原有路径结合在一起。通过 PATH_SEPARATOR，我们确保了不同操作系统间的路径分隔符差异。
更新后的路径会影响所有后续的 include 或 require 调用，因此我们可以在新的路径下加载 myfile.php 文件。
你还可以将多个路径添加到包含路径中，并使用 get_include_path() 来验证这些路径。PHP 会根据路径的顺序来查找文件，这意味着如果文件在多个路径中都有，那么 PHP 会加载第一个找到的文件。
<?php
// 设置多个路径
$newIncludePath = "/var/www/includes:/usr/local/lib";
set_include_path($newIncludePath);
// 输出新的包含路径
echo "新的文件包含路径是：" . get_include_path() . "\n";
// 现在我们可以在多个路径中查找文件
include('myfile.php');
?>
在这个示例中，我们将两个目录 /var/www/includes 和 /usr/local/lib 添加到文件包含路径中，并通过 set_include_path() 更新了包含路径。通过 get_include_path() 输出的路径，你可以验证文件加载的顺序。
