CodeIgniter目录函数使用教程

CodeIgniter 的 `directory_map()` 函数表面简单，实则暗藏多重陷阱：它只认绝对路径、对中文目录名极易乱码或跳过、`$depth` 参数并非层级限制而是非零即递归的布尔开关，且返回的嵌套数组以 basename 为键、丢失完整路径信息，导致结构难解析、同名文件冲突、隐藏文件被忽略。这些问题常让开发者误以为是代码逻辑错误，实则是函数设计与底层 PHP 文件系统行为耦合过紧所致；真正可靠的方案往往是绕过它，改用 SPL 迭代器或 `glob()` 等更可控的原生方式——理解这些“坑”，才能避开调试黑洞，高效构建稳定文件扫描功能。

directory_map() 返回空数组？检查路径是否为相对路径

CodeIgniter 的 directory_map() 默认只接受服务器绝对路径，传入像 "assets/images" 这种相对路径会静默失败，返回空数组。它不是按当前工作目录拼接的，而是直接交给 PHP 的 scandir() 处理，而 scandir() 对相对路径的解析依赖于执行脚本所在位置（比如 CLI 下是入口文件路径，Web 下可能是 index.php 所在目录），极易不一致。

实操建议：

• 始终用 FCPATH 或 APPPATH 等常量拼出绝对路径，例如：directory_map(FCPATH . 'uploads/')
• 传入前加一层判断：if (! is_dir($path)) { log_message('error', "Path not found: $path"); }
• Windows 下注意反斜杠问题，统一用正斜杠或 str_replace('\\', '/', $path) 预处理

中文目录名乱码或跳过？PHP 文件系统编码没对齐

directory_map() 底层调用 scandir()，而该函数在 Linux/macOS 上默认按字节读取目录项，在 Windows 上受当前 ANSI 代码页影响。如果目录含中文但文件系统编码是 UTF-8（现代 Linux/macOS 默认），而 PHP 运行环境 locale 不支持 UTF-8（如某些旧 Docker 镜像设为 C 或 en_US），就会出现跳过、乱码或 Warning: scandir(): failed to open dir。

实操建议：

• 确认 PHP 所在系统 locale：运行 locale 命令，确保 LANG 和 LC_ALL 包含 UTF-8
• Docker 中需在 Dockerfile 加：ENV LANG=C.UTF-8 LC_ALL=C.UTF-8
• 避免依赖 directory_map() 直接处理含中文路径，可先用 glob(FCPATH . 'uploads/*') + basename() 替代

递归层级被截断？$depth 参数不是深度限制而是“是否递归”开关

很多人以为 $depth = 2 表示最多遍历两层子目录，实际 directory_map($path, $depth) 的 $depth 是布尔型语义：0 表示不递归（只列一级），非 0（如 1、99、-1）都表示**完全递归**，没有中间档位。官方文档没写清楚，源码里就是 if ($depth !== 0) 判断。

实操建议：

• 需要控制层级时，不能靠 $depth，得自己封装递归逻辑，用 iterator_count(new RecursiveIteratorIterator(new RecursiveDirectoryIterator($path))) 辅助计数
• 若只是想排除某类子目录（如 .git、node_modules），应在回调中过滤，directory_map() 不支持 exclude 参数
• 大目录下慎用无限递归，容易超内存或超时，建议加 set_time_limit(30) 和 ini_set('memory_limit', '64M')

返回结果结构难处理？数组键名不是文件名而是带斜杠的路径片段

directory_map() 返回的是嵌套关联数组，键名是目录/文件的 basename，但值可能是子数组（目录）或字符串（文件）。关键点在于：**它把路径分段后，用每一段的 basename 当键，而不是完整路径**。比如 uploads/2023/photo.jpg 会变成 ['uploads' => ['2023' => ['photo.jpg' => 'photo.jpg']]] —— 这导致你无法直接知道 photo.jpg 的真实路径，也无法区分同名文件在不同子目录下的冲突。

实操建议：

• 不要直接 foreach 输出，先用 array_keys_recursive()（需自定义）扁平化提取所有文件路径
• 更可靠的做法是绕过 directory_map()，改用 SPL：$it = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($path)); foreach ($it as $file) { if ($file->isFile()) echo $file->getRealPath(); }
• 若必须用 directory_map()，记得它对隐藏文件（以 . 开头）默认忽略，要包含需修改源码或提前 chmod +r 目录

真正麻烦的不是怎么调用这个函数，而是它把路径语义和数据结构耦合得太紧——你拿到的不是“文件列表”，而是一棵被强制按目录树展开的、键名不可靠的数组。很多项目卡在这里，其实是没意识到 CI 这个 Helper 本质是个轻量胶水，不是通用文件扫描器。

到这里，我们也就讲完了《CodeIgniter目录函数使用教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！