PHP 8.0.30目录读取函数无法识别新增文件求助

可能的原因及排查步骤 #

1. 检查SELinux上下文标签 #

Fedora默认启用SELinux，即便文件权限、归属完全匹配，上下文标签不兼容也会导致PHP进程无法访问文件。

• 查看目录内所有文件的SELinux上下文：

  ls -Z ../COMMON/TESTS_SOURCE_FILES/
  

• 对比新旧文件的上下文，正常文件通常带有httpd_sys_content_t标签（若PHP由Apache运行），新文件可能被标记为user_home_t或其他非兼容标签。
• 修复上下文：

  restorecon -Rv ../COMMON/TESTS_SOURCE_FILES/
  

  该命令会自动恢复目录及文件的默认SELinux上下文。

2. 排查文件名特殊/不可见字符 #

新文件名可能包含空格、全角字符、控制字符（如换行符），或存在编码不匹配问题：

• 用以下命令查看文件原始名称（转义显示不可见字符）：

  ls -b ../COMMON/TESTS_SOURCE_FILES/
  

• 临时修改PHP脚本，输出所有读取到的条目（包括.和..），确认是否真的未读取到新文件：

  if ($handle = opendir('../COMMON/TESTS_SOURCE_FILES/'))
  {
    while (false !== ($entry = readdir($handle))) 
    {
      var_dump($entry); // 输出原始条目，含特殊字符转义形式
    }
    closedir($handle);
  }
  

  若能看到新文件条目，说明是后续过滤或处理逻辑问题；若看不到，继续排查其他原因。

3. 验证目录及父目录权限 #

• 检查目标目录权限：

  ls -ld ../COMMON/TESTS_SOURCE_FILES/
  

  确保运行PHP的用户（通常为apache、nginx或php-fpm用户）对该目录拥有执行权限（x，允许进入目录）和读取权限（r，允许读取目录内容）。
• 检查父目录../COMMON/的权限，同样需保证PHP运行用户有执行权限。

4. 检查PHP open_basedir限制 #

查看PHP配置是否启用open_basedir，限制了PHP可访问的目录范围：

• 在脚本中添加以下代码输出配置：

  echo ini_get('open_basedir');
  

  若输出不为空，确认../COMMON/TESTS_SOURCE_FILES/在允许的路径列表内。

5. 确认文件类型与隐藏属性 #

• 新文件名是否以.开头？你的代码过滤了.和..，但.test.txt这类隐藏文件也会被过滤，可临时注释过滤代码验证。
• 用ls -l查看文件类型，确认新文件是普通文件（开头字符为-），而非设备、管道等特殊类型。

快速测试方案 #

创建极简测试脚本，排除原有脚本的逻辑干扰：

$dir = '../COMMON/TESTS_SOURCE_FILES/';
$files = scandir($dir);
var_dump($files);

scandir会返回目录内所有条目（包括.和..），可快速确认PHP是否能识别新文件。

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