is_dir()和scandir()需配合使用：先用is_dir()&&is_readable()轻量探测，再用@scandir()避免警告中断；返回非数组或空则表明权限异常、文件系统损坏或存储断开。
PHP怎么用is_dir()和scandir()快速确认文件夹基础状态
单纯判断“文件夹是否存在”或“是否可读”，is_dir()和is_readable()就足够了；但“完整性”不是布尔值，它隐含多个维度：路径存在、权限正常、内容可枚举、无符号链接断裂、无IO错误。别一上来就写递归校验——先做轻量探测。
常见误判场景：scandir()在遇到权限不足或损坏的挂载点时会直接触发警告（Warning），而非返回false；若没开启@抑制或异常捕获，脚本可能中断。
- 先用
is_dir($path) && is_readable($path)筛掉明显异常路径 - 再用
@scandir($path)获取目录项，检查返回值是否为数组且至少含'.'和'..' - 若返回
false或空数组，大概率是权限问题、文件系统损坏，或该路径被FUSE/网络存储临时断开
PHP如何比对文件夹MD5或SHA256快照做完整性验证
所谓“完整性验证”，本质是比对当前文件树与某个可信快照是否一致。PHP本身不内置树哈希，但可用hash_file()逐文件计算+拼接后整体哈希，或用sha1_file()生成文件级摘要再排序合并。
注意：不要对整个目录直接hash_file('sha256', $dir_path)——这会失败，hash_file()只接受普通文件。
立即学习“PHP免费学习笔记（深入）”；
- 推荐方式：递归遍历所有文件（跳过
./..及子目录），按相对路径排序，对每个文件调用hash_file('sha256', $full_path)，拼接成字符串后再哈希一次 - 性能敏感时，可改用
md5_file()（更快但碰撞概率略高），或跳过小文件（如）仅校验核心配置/二进制文件 - 快照需存为纯文本（如JSON），包含时间戳和完整哈希值，否则无法回溯验证依据
为什么RecursiveDirectoryIterator在损坏路径下容易崩溃
RecursiveDirectoryIterator底层依赖系统readdir()，一旦遇到EXT4元数据损坏、NFS超时、或Btrfs checksum失败的目录项，就会抛出UnexpectedValueException，且默认无法跳过——这是最常被忽略的“完整性验证翻车点”。
真实环境里，一个挂载点短暂不可用，或某个inode损坏，就足以让迭代器中断，而你可能只看到“Invalid argument”这种模糊错误。
- 必须用
try/catch包裹每次next()或current()调用，不能只包外层foreach - 捕获
UnexpectedValueException后，记录具体路径并继续，而不是break - 配合
clearstatcache(true)防止因缓存导致重复报错
Linux下PHP验证文件夹完整性前，务必先确认文件系统健康状态
PHP层做的所有校验，都建立在底层文件系统“行为正常”的前提上。如果ext4已出现journal错误、XFS元数据不一致、或NTFS-3G挂载异常，PHP函数返回的true毫无意义——它只是告诉你“此刻系统调用没立即失败”。真正的损坏可能表现为随机stat()超时、opendir()返回空句柄、或readlink()返回乱码。
所以，在PHP脚本中嵌入exec('sudo dumpe2fs -h /dev/sda1 2>/dev/null | grep -i "errors")
- 生产环境禁止用
sudo执行命令，应由运维提前导出smartctl、dmesg | grep -i "ext4\|xfs\|io"等日志供PHP读取 - PHP中
file_exists()返回true，不代表file_get_contents()一定能读——这是两个不同内核路径 - 对关键目录（如
vendor/或storage/），建议搭配inotifywait -m -e create,delete_self做实时监控，而非只靠定时校验
