php 8.5 彻底移除了 directory 类，应改用 filesystemiterator 替代，它功能明确、兼容性好、默认跳过 . 和 ..，支持过滤与递归；glob() 仅适用于简单通配匹配。
Directory 类在 PHP 8.5 确实被移除了
PHP 8.5 正式废弃并移除了 Directory 类（及其 dir() 函数封装），调用会触发 Deprecated: Directory::__construct(): Calling directory functions on a Directory object is deprecated 或直接报错（取决于 SAPI 和错误报告级别）。这不是临时警告，是彻底移除——你不能再依赖它遍历目录。
用 FilesystemIterator 替代最稳妥
FilesystemIterator 是官方推荐替代方案，功能更明确、行为更可控，且从 PHP 5.3 就存在，兼容性好。它默认跳过 . 和 ..，支持过滤、排序、递归（配合 RecursiveDirectoryIterator）。
常见错误现象：
• 直接把 Directory 对象当数组遍历（foreach ($dir as $file)）失效
• 误以为 scandir() 足够——它只返回文件名列表，不带路径、类型、权限等元信息
- 用
new FilesystemIterator($path)替代dir($path) - 遍历时用
$item->getFilename()取名，$item->isDir()判断类型，$item->getPathname()获取完整路径 - 若需递归，改用
new RecursiveIteratorIterator(new RecursiveDirectoryIterator($path)) - 注意：
FilesystemIterator默认不包含./..，无需手动过滤；而scandir()返回的数组里有，容易漏删
foreach (new FilesystemIterator('/var/log') as $item) {
if ($item->isFile() && $item->getExtension() === 'log') {
echo $item->getFilename() . "\n";
}
}
glob() 适合简单通配匹配，但别用来做复杂逻辑
如果你只是找 *.php 或 config/*.yaml 这类固定模式的文件，glob() 更轻量、写法更短。但它不返回对象，没有文件元数据，也不支持递归（除非加 GLOB_BRACE 和多层通配，但可读性差）。
立即学习“PHP免费学习笔记（深入）”；
-
glob('/path/*.txt')返回字符串数组，不是迭代器，一次性加载全部结果——大目录下内存压力明显 - 不区分文件/目录，需额外调用
is_file()或is_dir() - 路径中含空格或特殊字符时，
glob()行为不稳定，FilesystemIterator更健壮 - Windows 下大小写不敏感，Linux 下敏感，
glob()的行为跨平台不一致
别忽略 open_basedir 和权限变化的影响
迁移后首次运行报 Permission denied 或空结果？不是代码问题，很可能是 open_basedir 限制或 SELinux/AppArmor 拦截了新迭代器的底层 readdir() 调用。旧 Directory 类某些 SAPI（如 Apache mod_php）会静默跳过无权目录，而 FilesystemIterator 默认抛异常。
- 检查
ini_get('open_basedir')是否包含目标路径 - 确认 Web 服务器用户（如
www-data）对目录有rx权限 - 启用
error_reporting(E_ALL)，捕获UnexpectedValueException并 inspect$e->getMessage() - 生产环境别用
@抑制错误——它会掩盖真正的权限问题
真正麻烦的不是换函数，而是旧代码里混着 dir() + 手动 readdir() + scandir() + glob() 多种风格，还穿插了路径拼接和硬编码。逐个替换时，优先统一成 FilesystemIterator，再清理周边逻辑。
