学完这篇，你能用 PHP 安全地读写几百 MB 的大文件、把任意目录树遍历干净、并把权限配到「能写但不能被当成脚本执行」——三者都是上传目录、附件目录最容易出事的地方。
第一步：先确认三个环境前提
在写任何文件代码前，先搞清楚这三件事，否则后面全是玄学问题：
- 内存上限：`memory_limit`，`php -i | grep memory_limit` 或 `phpinfo()` 里看。一次性读大文件超限就是在这里爆的。
- 执行时限：`max_execution_time`，Web 请求里默认常见 30 秒。处理大文件时脚本开头写 `set_time_limit(0);` 解除。
- 运行用户：PHP-FPM 通常以 `www` / `www-data` 跑。谁运行，谁就是新建文件的所有者。用 `ps aux | grep php-fpm` 确认。
注意：`set_time_limit(0)` 只对当前脚本生效。真正耗时几分钟以上的任务（批量转码、全站索引）应该交给计划任务或 CLI，别挂在 Web 请求里。
第二步：读大文件——永远别用 file_get_contents
`file_get_contents()` 会把整个文件塞进内存，读 500MB 文件基本等于自杀。三种替代方案按场景选：
逐行读（日志、文本）：
$fp = fopen($path, 'rb');
if (!$fp) { exit('无法打开'); }
while (($line = fgets($fp)) !== false) {
// 处理 $line
}
fclose($fp);
定长块读（二进制、任意大小）：
$fp = fopen($path, 'rb');
while (!feof($fp)) {
$chunk = fread($fp, 1024 * 64); // 64KB 一块
// 处理 $chunk
}
fclose($fp);
下载大文件（避免撑爆内存）：
while (ob_get_level()) { ob_end_clean(); } // 关掉所有输出缓冲
header('Content-Type: application/octet-stream');
header('Content-Length: ' . filesize($path));
readfile($path); // 或 fpassthru($fp)
写大文件同理：用 `fopen($path, 'ab')` + 循环 `fwrite()` + `fflush()`，不要用字符串一路 `file_put_contents($path, $str, FILE_APPEND)` 拼几十万次。
第三步：目录遍历——三种写法别用混
只看一层、要全部条目 → `scandir()`，记住必须过滤 `.` 和 `..`：
foreach (scandir($dir) as $name) {
if ($name === '.' || $name === '..') continue;
$full = $dir . DIRECTORY_SEPARATOR . $name;
if (is_file($full)) { /* ... */ }
}
按扩展名筛选一层 → `glob($dir . '/*.jpg')`。
递归整棵树 → `RecursiveDirectoryIterator` + `RecursiveIteratorIterator`：
$it = new RecursiveIteratorIterator(
new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS),
RecursiveIteratorIterator::SELF_FIRST
);
foreach ($it as $file) {
if ($file->isFile()) {
echo $file->getPathname(), ' ', $file->getSize(), " bytes\n";
}
}
要跳过某些目录（比如缓存、`.git`），用 `RecursiveCallbackFilterIterator` 在回调里 `return false`。
注意：遍历路径如果来自用户输入，先用 `realpath()` 解析并确认它在你允许的根目录之内，否则 `../../` 就能把整台服务器读一遍。永远不要直接拼接用户传来的路径。
第四步：权限管理——属主、模式、可写性
- 先判断再操作：`is_writable()` / `is_readable()` 比直接 fopen 报错友好。
- 模式选择：普通文件 `0644`，目录 `0755`；需要同组写入的上传目录用 `0775`。不要用 `0777`。
- 目录的执行位：目录的 `x` 表示「可进入」，少了它连 `cd` 都进不去，遍历直接失败。
- 改属主：`chown($path, 'www')` 需要 root 权限，PHP 里通常做不到，得在面板或命令行处理。
注意：用 root 解压或上传的文件，属主是 root，PHP-FPM 的 www 用户写不进去。这是「上传提示目录不可写」最常见的原因——改成 `chown -R www:www uploads` 即可。同时上传目录应关闭脚本执行（Nginx 里对该目录 `location` 禁止 `.php`），防止有人传个伪装图片当后门跑。
第五步：两个能直接抄的组合函数
// 递归算目录总大小
function dir_size(string $dir): int {
$total = 0;
$it = new RecursiveIteratorIterator(
new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS)
);
foreach ($it as $f) {
if ($f->isFile()) $total += $f->getSize();
}
return $total;
}
// 安全删除目录（先确认在允许范围内）
function rm_dir(string $dir, string $allowRoot): bool {
$real = realpath($dir);
if ($real === false || strpos($real, realpath($allowRoot)) !== 0) return false;
$it = new RecursiveIteratorIterator(
new RecursiveDirectoryIterator($real, FilesystemIterator::SKIP_DOTS),
RecursiveIteratorIterator::CHILD_FIRST
);
foreach ($it as $f) {
$f->isDir() ? rmdir($f->getPathname()) : unlink($f->getPathname());
}
return rmdir($real);
}
`CHILD_FIRST` 确保先删子项再删父目录，否则 `rmdir` 一定报「目录非空」。
小结
- 大文件一律 `fopen` + 分块/逐行，禁用 `file_get_contents`；输出用 `readfile()` 并先清空输出缓冲。
- 一层用 `scandir`/`glob`，递归用 `RecursiveIteratorIterator`，记得 `SKIP_DOTS`。
- 权限三要素：属主是运行用户、文件 `0644` 目录 `0755`、目录必须有执行位。
- 所有用户提供的路径先 `realpath()` 再校验前缀，防目录穿越。
- 上传目录「可写但不可执行」，这是安全底线。
见习用户
正式会员
认证极客
