萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP文件與目錄操作大全:屬性獲取、遍歷、大小計算、創建刪除、權限管理

文件系統操作是PHP後端開發核心技能。本文系統整理文件/目錄屬性獲取、目錄遍歷、遞歸大小計算、創建刪除、權限管理等高頻操作,提供生產級封裝函數與最佳實踐。

1. 文件屬性信息獲取

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]);
}

2. 目錄遍歷(遞歸/非遞歸)

// 非遞歸:僅當前目錄
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(),
        ];
    }
}

3. 目錄大小計算(遞歸)

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'));

4. 目錄創建與刪除

// 安全創建(避免競態)
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);
}

5. 權限管理最佳實踐

  • 目錄:0755(擁有者寫,組/其他讀執行)。
  • 文件:0644(擁有者寫,組/其他讀)。
  • 上傳/緩存目錄:0775 + 設置setgid(chmod g+s)保證組繼承。
  • 敏感配置文件:0600(僅擁有者讀寫)。
  • 使用chown/chgrp匹配PHP-FPM運行用戶/組(如www-data)。

6. 常見坑點

  • filesize緩存:同一腳本多次調用返回緩存值,需clearstatcache(true, $path)。
  • Windows下filectime為創建時間,Linux為inode變更時間;跨平台用filemtime判斷內容修改。
  • 大量文件目錄opendir/readdir性能差,改用glob()或scandir()(一次性讀入內存)。
  • 流包裝器支持:fopen('ssh2.sftp://...')、zip://、phar://等統一API操作遠程/壓縮文件。

封裝通用文件系統工具類,統一異常處理、日誌記錄、權限審計,提升開發效率與系統穩定性。

copyright © 萬盛學電腦網 all rights reserved