realpath() 返回空字符串通常是因为 PHP 进程缺少父目录的执行（x）权限，或受 open_basedir 限制；需确保路径中每个目录对 Web 服务器用户（如 www-data）具备可执行权限，并检查 open_basedir 是否显式禁止访问上级路径。
`realpath()` 返回空字符串通常是因为 php 进程缺少父目录的执行（x）权限，或受 `open_basedir` 限制；需确保路径中每个目录对 web 服务器用户（如 www-data）具备可执行权限，并检查 `open_basedir` 是否显式禁止访问上级路径。
在 PHP 中，realpath() 不仅解析路径，还执行严格的权限校验：它要求从当前目录向上回溯到根路径（即每一级父目录）都必须对运行 PHP 的用户（通常是 www-data）具有「执行」（x）权限。执行权限在 Unix/Linux 系统中并非仅用于运行文件，而是访问目录内容（如 cd 进入或 ls 列出）所必需的。若任意一级缺失 x 权限（例如 /var/www 或 /var 目录权限为 750 且组不包含 www-data），realpath() 就会失败并返回 false——而当你用 . 强制转为字符串时，false 被隐式转换为空字符串，导致看似“不可见”。
此外，你的 open_basedir 设置为 /var/www/www-root/data:., 这明确限定了 PHP 只能访问该目录及其子目录。__DIR__. '/../' 试图跳出 /var/www/www-root/data，直接违反了 open_basedir 策略，因此即使权限无误，realpath() 也会因安全限制返回 false。
✅ 正确调试与修复步骤：
-
验证 open_basedir 是否允许上级访问
若需访问同级或上级目录，请扩展配置（例如在 php.ini 或 Apache 的块中）： php_admin_value open_basedir "/var/www/www-root/data:/var/www/www-root"
或更宽松（生产环境慎用）：
立即学习“PHP免费学习笔记（深入）”；
php_admin_value open_basedir "/var/www"
-
检查目录执行权限链
以 Web 用户身份测试访问权限（推荐使用 sudo -u www-data）：sudo -u www-data ls -ld /var/www/www-root/data sudo -u www-data ls -ld /var/www/www-root sudo -u www-data ls -ld /var/www sudo -u www-data ls -ld /var
确保每级目录至少对 www-data 用户或其所属组拥有 x 权限（如 drwxr-x--- 中的 x）。
-
安全地获取上级路径（避免 realpath() 失败）
若 open_basedir 无法放宽，建议用 dirname(__DIR__) 替代 realpath(__DIR__ . '/../')，再结合 is_dir() 和 is_readable() 显式校验：$parent = dirname(__DIR__); if (is_dir($parent) && is_readable($parent)) { echo "Parent exists and is readable: " . $parent; } else { error_log("Cannot access parent directory: {$parent}"); throw new RuntimeException("Insufficient permissions or open_basedir restriction"); }
⚠️ 注意事项：
- 永远不要移除关键系统目录（如 /var、/）的权限限制；
- 生产环境应遵循最小权限原则，open_basedir 宜精确限定必要路径；
- realpath() 的返回值务必显式判断：if (false === realpath($path)) { /* handle error */ }，避免依赖字符串转换掩盖逻辑错误。
通过权限校验与 open_basedir 合理配置，即可稳定、安全地实现跨目录操作。
