文件系統操作是PHP後端開發核心技能。本文系統整理文件/目錄屬性獲取、目錄遍歷、遞歸大小計算、創建刪除、權限管理等高頻操作,提供生產級封裝函數與最佳實踐。
function getFileInfo(string $path): array {
if (!file_exists($path)) throw new RuntimeException("文件不存在: $path");
$stat = stat($path);
$perms = substr(sprintf('%o', $stat['mode']), -4);
return [
'name' => basename($path),
'type' => filetype($path), // file, dir, link 等
'size' => $stat['size'],
'size_human' => human_filesize($stat['size']),
'readable' => is_readable($path),
'writable' => is_writable($path),
'executable' => is_executable($path),
'ctime' => date('Y-m-d H:i:s', $stat['ctime']), // inode變更時間
'mtime' => date('Y-m-d H:i:s', $stat['mtime']), // 內容修改時間
'atime' => date('Y-m-d H:i:s', $stat['atime']), // 訪問時間
'owner' => $stat['uid'],
'group' => $stat['gid'],
'perms' => $perms,
'is_link' => is_link($path),
'realpath' => realpath($path),
];
}
function human_filesize(int $bytes, int $decimals = 2): string {
$units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB'];
$factor = floor((strlen((string)$bytes) - 1) / 3);
return sprintf("%.{$decimals}f %s", $bytes / (1024 ** $factor), $units[$factor]);
}
// 非遞歸:僅當前目錄
function list_dir(string $dir): array {
$files = [];
$dh = opendir($dir);
if (!$dh) throw new RuntimeException("無法打開目錄: $dir");
while (($entry = readdir($dh)) !== false) {
if ($entry === '.' || $entry === '..') continue;
$full = $dir . '/' . $entry;
$files[] = [
'name' => $entry,
'path' => $full,
'type' => filetype($full),
'size' => is_file($full) ? filesize($full) : null,
'mtime' => date('Y-m-d H:i:s', filemtime($full)),
];
}
closedir($dh);
return $files;
}
// 遞歸:使用RecursiveIteratorIterator(推薦)
function list_dir_recursive(string $dir): Generator {
$it = new RecursiveIteratorIterator(
new RecursiveDirectoryIterator($dir, RecursiveDirectoryIterator::SKIP_DOTS),
RecursiveIteratorIterator::SELF_FIRST
);
foreach ($it as $file) {
yield $file->getPathname() => [
'name' => $file->getFilename(),
'type' => $file->getType(),
'size' => $file->isFile() ? $file->getSize() : null,
'mtime' => $file->getMTime(),
];
}
}
function dir_size(string $dir): int {
$size = 0;
$it = new RecursiveIteratorIterator(
new RecursiveDirectoryIterator($dir, RecursiveDirectoryIterator::SKIP_DOTS)
);
foreach ($it as $file) {
if ($file->isFile()) $size += $file->getSize();
}
return $size;
}
// 使用
echo human_filesize(dir_size('/var/www/html'));
// 安全創建(避免競態)
function ensure_dir(string $path, int $mode = 0755): bool {
return is_dir($path) || @mkdir($path, $mode, true);
}
// 遞歸刪除非空目錄
function remove_dir(string $dir): bool {
$dir = rtrim($dir, '/\\');
if (!is_dir($dir)) return false;
$items = new RecursiveIteratorIterator(
new RecursiveDirectoryIterator($dir, RecursiveDirectoryIterator::SKIP_DOTS),
RecursiveIteratorIterator::CHILD_FIRST
);
foreach ($items as $item) {
$item->isDir() ? @rmdir($item->getPathname()) : @unlink($item->getPathname());
}
return @rmdir($dir);
}
0755(擁有者寫,組/其他讀執行)。0644(擁有者寫,組/其他讀)。0775 + 設置setgid(chmod g+s)保證組繼承。0600(僅擁有者讀寫)。chown/chgrp匹配PHP-FPM運行用戶/組(如www-data)。filesize緩存:同一腳本多次調用返回緩存值,需clearstatcache(true, $path)。filectime為創建時間,Linux為inode變更時間;跨平台用filemtime判斷內容修改。opendir/readdir性能差,改用glob()或scandir()(一次性讀入內存)。fopen('ssh2.sftp://...')、zip://、phar://等統一API操作遠程/壓縮文件。封裝通用文件系統工具類,統一異常處理、日誌記錄、權限審計,提升開發效率與系統穩定性。