arm64架构Docker中PHP realpath识别挂载目录返回false怎么办

这个问题和x86_64/arm64的CPU架构差异没有直接关系，核心原因是两边PHP运行环境的路径访问权限或配置不一致，按以下步骤排查即可定位：

• 先确认PHP进程的实际运行身份：在两个架构的容器内分别执行ps aux | grep php-fpm（FPM运行模式）或ps aux | grep apache（Apache mod_php模式），对比两边PHP进程的运行用户、用户组是否完全一致。你手动在容器shell里执行系统自带realpath命令时，使用的是当前登录shell的用户（通常是root），和PHP实际运行进程的用户不是同一个，这也是为什么系统命令能正常返回、但PHP函数返回false的最常见原因。
• 对比两边目标路径的权限配置：在两个容器内分别执行ls -ld /var/www/html/tmp以及路径每一级父目录的权限查询（ls -ld /var/www、ls -ld /var/www/html），确认arm64容器内的所有路径层级都给PHP运行用户分配了可执行（进入目录）、可读权限。注意：PHP的realpath()函数要求运行进程对路径经过的每一级目录都持有可执行权限，任意一级权限缺失都会直接返回false。
• 核对PHP的路径访问限制配置：在两个容器内分别打印phpinfo()，搜索open_basedir配置项，确认arm64环境下该配置是否将/var/www/html/tmp路径纳入了允许访问的范围，配置不匹配会直接导致realpath()访问受限返回false。
• 检查Docker挂载的实际生效状态：在arm64架构的EC2宿主机上执行mount | grep tmp目录对应的挂载路径，确认挂载时没有添加noexec、ro等异常限制参数，同时确认宿主机上被挂载的tmp目录本身权限正常，容器内可正常读取目录下的文件。

快速定位脚本 #

在arm64容器的/var/www/html/public目录下新建测试PHP文件，内容如下：

<?php
var_dump('PHP运行用户ID: ' . posix_getuid());
var_dump('tmp路径stat信息:');
var_dump(@stat('../tmp'));
var_dump('realpath返回结果:');
var_dump(realpath('../tmp'));
var_dump('最后一条报错信息:');
var_dump(error_get_last());

访问该测试脚本即可直接定位问题：

• 如果stat('../tmp')返回false，error_get_last()会明确提示是权限不足还是路径不存在
• 如果stat返回正常但realpath返回false，优先检查open_basedir配置是否正确
• 如果确认是权限问题，将/var/www/html路径下所有相关目录的属主调整为PHP运行用户，或给目录分配其他用户可读、可进入的权限即可修复。

内容的提问来源于stack exchange，提问作者Dmitriy Antonenko