PHP没有文件夹索引机制，所谓“索引失效”实为opcache缓存、scandir/glob路径解析问题或Web服务器目录浏览配置错误所致。
PHP里没有“文件夹索引”这个东西，别被误导了
PHP 本身不维护任何文件系统层面的“目录索引”。你看到的所谓“索引失效”“需要重建”，通常是以下情况之一：opcache 缓存了过期的文件列表、glob() 或 scandir() 返回结果被意外缓存、或者 Web 服务器（如 Nginx/Apache）启用了目录浏览但配置出错。根本不存在 PHP 原生的“重建索引”命令或函数。
scandir() 和 glob() 返回结果不准？检查 realpath 和 open_basedir
常见现象：明明新增了文件，scandir() 却没返回；或者删了文件，结果还在列表里。这往往不是 PHP 的 bug，而是路径解析或权限问题：
-
scandir()对相对路径敏感，建议统一用realpath($dir)规范路径再传入 - 如果启用了
open_basedir，而目标目录不在白名单内，scandir()会静默失败（返回false），不是空数组 -
glob("*.php")可能受safe_mode（已废弃）或disable_functions影响——检查phpinfo()中disable_functions是否含glob - Linux 下注意大小写，
glob("*.PHP")不会匹配index.php
opcache 导致 include/require 找不到新文件？关掉 opcache.revalidate_freq 或重启
这不是目录索引问题，但最容易被误认为“索引没更新”：启用 opcache 后，PHP 默认每 2 秒检查一次脚本是否修改（由 opcache.revalidate_freq 控制）。如果你刚上传新文件就立刻 require，它可能还在缓存里读旧的文件列表或报 failed to open stream：
- 开发环境建议设
opcache.revalidate_freq=0（每次请求都校验） - 线上环境不能频繁改代码，所以不要设为 0；改完文件后可调用
opcache_invalidate($file, true)或opcache_reset() - 注意：
opcache_reset()会清空全部缓存，有性能抖动，别放在高频接口里
Web 服务器显示“403 Forbidden”或空白目录？不是 PHP 问题，是配置没开目录浏览
用户搜“重建文件夹索引”，有时其实是想让 Nginx/Apache 显示目录下所有文件（类似旧版 Apache 默认行为）。PHP 完全不参与这事：
立即学习“PHP免费学习笔记（深入）”；
- Nginx 需在 location 块加
autoindex on;，并确保autoindex_exact_size off;等配套项合理 - Apache 需启用
mod_autoindex，且对应目录有Options +Indexes - 两者都默认禁止目录浏览（安全考虑），不会因为“PHP 重建索引”就突然生效
- 如果开了但还是 403，请检查文件系统权限（
ls -ld /path/to/dir）和 SELinux/AppArmor 等强制访问控制
真正要“刷新”的，从来不是 PHP，而是你的路径处理逻辑、opcache 策略、或 Web 服务器配置。别在 PHP 里找不存在的开关。
