PHP chmod 默认不处理隐藏文件并非因函数限制，而是开发者常误用 $file[0] === '.' 过滤逻辑跳过 .htaccess 等关键文件；实际需显式过滤以点开头的条目并结合 is_file() 安全操作。
PHP chmod 为什么默认不处理隐藏文件
因为 PHP 的 scandir()、glob() 和大多数文件遍历函数（包括 RecursiveDirectoryIterator）在 Unix/Linux 系统下默认会把以 . 开头的文件/目录当作普通条目返回，但很多开发者手动过滤时写了类似 if ($file[0] === '.') 这样的逻辑，误把 .htaccess、.env 等关键隐藏文件也跳过了。真正的“忽略”往往来自人为判断，而非 PHP 本身限制。
用 RecursiveIteratorIterator 安全跳过隐藏项
这是最可控的方式：显式排除以 . 开头的条目，同时保留对符号链接、权限、深度的控制。注意不能只依赖 SkipDots 标志——它只跳 . 和 ..，不跳 .git 或 .DS_Store。
实操建议：
- 用
RecursiveDirectoryIterator构造迭代器时传入FilesystemIterator::SKIP_DOTS - 在循环中用
substr($item->getFilename(), 0, 1) === '.'显式过滤 - 调用
chmod()前先用is_file()判定，避免对目录误操作
$iter = new RecursiveIteratorIterator(
new RecursiveDirectoryIterator('/path/to/dir', FilesystemIterator::SKIP_DOTS)
);
foreach ($iter as $item) {
if ($item->isFile() && $item->getFilename()[0] !== '.') {
chmod($item->getPathname(), 0644);
}
}
glob() + array_filter() 快速批量处理
适合简单场景，比如只改当前目录下所有非隐藏的 .php 文件权限。注意 glob() 在不同系统对隐藏文件支持不一致：Linux 下 glob('*') 默认不匹配隐藏文件；但 glob('.*') 才能拿到它们——所以只要不用 .*，天然就跳过了。
立即学习“PHP免费学习笔记（深入）”；
常见错误：
- 写成
glob('/path/*') . glob('/path/.*')拼接，结果把.和..也混进去了 - 没加
GLOB_NOSORT，导致顺序不可控，影响调试 - 忘记用
is_file()排除目录，chmod()对目录设0644会出问题
$files = array_filter(glob('/var/www/*.php'), 'is_file');
foreach ($files as $file) {
if (basename($file)[0] !== '.') {
chmod($file, 0644);
}
}
为什么 chmod -R 命令行更“省事”但 PHP 里要小心
Shell 的 chmod -R 本身也不跳隐藏文件——它照常递归进去。所谓“省事”，是因为你通常用 find /path ! -name ".*" -type f -exec chmod 644 {} \; 这类组合命令主动排除，而 PHP 没有现成的 ! -name 语法，必须自己写逻辑。
真正容易被忽略的点：
-
chmod()返回false时不报错，得用error_get_last()检查是否因权限不足失败 - Web 服务器用户（如
www-data）可能无权修改某些文件，尤其是被root创建的.env - Windows 下隐藏文件概念不同（靠属性位），
[0] === '.'判断在 Windows 无效，需额外兼容
