迁移至Nginx后PHP中Glob函数无法返回搜索结果

最近踩了个坑：我自己编写了一个依赖glob()函数的PHP文件搜索类，在Apache服务器上运行完全正常，但迁移到Nginx环境后，每次搜索都返回0条结果。我已经反复确认代码逻辑没有问题，如果你需要在PHP中实现文件系统搜索功能，可以直接使用下面的代码片段：

可用的文件搜索代码片段 #

public static function search($path, $find, $caseSensitive = false) { 
    if ($path[strlen($path) - 1] !== '/') $path .= '/'; 
    $path = '../'.$path; 
    $pathLen = strlen($path); 
    // 后续搜索逻辑代码省略...
}

为什么Nginx下会失效？常见原因与解决方法 #

虽然代码本身没问题，但Nginx和Apache在运行环境、路径解析上的差异，很可能导致glob()无法正确读取目标目录：

1. 相对路径解析差异 #

Apache和Nginx的工作目录（Document Root）配置不同，代码里用../拼接的相对路径，在Apache下能正确指向目标目录，但到了Nginx环境可能就跑偏了。

解决方法：改用绝对路径来定位，比如结合__DIR__（当前脚本所在目录）来生成可靠的绝对路径：

$path = realpath(__DIR__ . '/../' . $path);
if (!$path) {
    // 路径不存在的处理逻辑
    return [];
}

2. 运行用户权限问题 #

Nginx通常以www-data（部分系统是nginx）用户运行，而Apache可能使用apache或其他用户账号。如果目标目录/文件对Nginx的运行用户没有读取权限，glob()自然拿不到任何结果。

解决方法：调整目标目录的权限和所属用户：

# 把目录所有者改为Nginx运行用户
chown -R www-data:www-data /path/to/your/target/folder
# 赋予目录可读可执行权限，文件可读权限
chmod -R 755 /path/to/your/target/folder

3. PHP的open_basedir限制 #

如果PHP配置了open_basedir，它会限制PHP只能访问指定范围内的目录。如果你的目标路径不在允许列表里，glob()会被禁止访问。

解决方法：修改php.ini文件，或者在Nginx的站点配置中添加允许的路径：

location ~ \.php$ {
    # 追加允许访问的目录到open_basedir
    php_admin_value open_basedir "/var/www/html:/path/to/your/target/folder";
}

内容的提问来源于stack exchange，提问作者Dan Bray