PHP 的 realpath() 函数在遇到权限不足或路径受限时返回 false，而强制转为字符串后显示为空，实际是类型转换导致的假象；根本原因通常是 open_basedir 限制或父目录缺少执行（x）权限。
php 的 `realpath()` 函数在遇到权限不足或路径受限时返回 `false`，而强制转为字符串后显示为空，实际是类型转换导致的假象；根本原因通常是 `open_basedir` 限制或父目录缺少执行（x）权限。
在 Apache + PHP 环境中，realpath('..') 或 realpath(__DIR__ . '/../') 返回空字符串（实为 false），并非路径不存在，而是函数执行失败后的隐式类型转换结果。例如：
var_dump(realpath('..')); // bool(false)
var_dump((string) realpath('..')); // string(0) ""
header('X-Real-Path1: ' . realpath('..')); // 实际输出空值，易被误判为“路径为空”
根据 PHP 官方文档，realpath() 要求当前进程对路径中每一级目录都具有执行权限（x bit）——该权限决定能否 chdir 进入该目录，在 Linux 文件系统中是遍历目录的必要条件。即使 Web 用户（如 www-data）对父目录有读（r）和写（w）权限，若缺少执行权限，realpath() 仍会失败。
更关键的是，你的环境已启用 open_basedir = "/var/www/www-root/data:."。该配置严格限制了 PHP 可访问的文件系统根路径：
✅ 允许访问 /var/www/www-root/data 及其子目录；
❌ 禁止访问其上级目录（如 /var/www/www-root/ 或 /var/www/），即使权限充足；
⚠️ realpath(__DIR__ . '/../') 会尝试解析到 open_basedir 范围之外，直接触发拒绝，返回 false。
✅ 验证与修复步骤：
-
检查 open_basedir 是否覆盖目标路径：
echo "open_basedir: " . ini_get('open_basedir') . "\n"; echo "Current dir: " . __DIR__ . "\n";若父目录不在白名单内，需扩展配置（推荐仅添加必需路径）：
; 在 php.ini 或 Apache VirtualHost 中调整 php_admin_value open_basedir "/var/www/www-root/data:/var/www/www-root"
-
确认目录执行权限（以 www-data 用户身份测试）：
sudo -u www-data ls -ld /var/www/www-root/data/.. # 应显示类似 dr-xr-xr-x —— 关键是其他用户（others）或组（group）有 `x` 权限
若缺失，修复权限（谨慎操作）：
sudo chmod o+x /var/www/www-root # 或 g+x，视所属组而定
-
编码层防御性处理：
永远不要直接拼接字符串调用 realpath()，应先校验返回值：$parent = realpath(__DIR__ . '/../'); if ($parent === false) { error_log('Failed to resolve parent directory: ' . __DIR__ . '/../'); throw new RuntimeException('Parent path inaccessible (check open_basedir & x-permissions)'); }
? 总结：空字符串本质是 false → string 的副作用；真正瓶颈在于 open_basedir 的沙箱策略与 POSIX 目录执行权限的双重约束。调试时优先使用 var_dump(realpath(...)) 查看原始返回值，并结合 getcwd()、ini_get('open_basedir') 和 ls -ld 命令交叉验证，而非依赖字符串输出做逻辑判断。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
