萬盛學電腦網

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

PHP 文件與目錄操作完整指南:核心函數與實戰技巧

一、基礎文件操作詳解

PHP 提供豐富的內建函數來處理文件系統操作,涵蓋文件判斷、屬性讀取、權限檢查與時間戳獲取等核心功能。掌握這些基礎操作是進行文件管理、日誌記錄、緩存處理等開發任務的基石。

核心判斷函數

  • file_exists():檢查文件或目錄是否存在
  • is_file():確認是否為一般文件
  • is_dir():確認是否為目錄
  • is_readable()、is_writable()、is_executable():權限檢查三劍客

屬性獲取函數

  • filesize():獲取文件大小(位元組)
  • filetype():獲取文件類型(file、dir、link 等)
  • filectime()、filemtime()、fileatime():分別獲取建立、修改、存取時間

實戰封裝:文件屬性綜合查看器

以下範例封裝了一個 getFilePro() 函數,可一次性輸出文件的完整屬性資訊,包含人性化的大小格式轉換(B/KB/MB/GB/TB):

<?php
header("Content-Type: text/html; charset=utf-8");

function getFilePro($fileName) {
    if (!file_exists($fileName)) {
        echo "文件不存在<br/>";
        return;
    }

    // 基礎類型判斷
    if (is_file($fileName)) echo $fileName . ' 是一個文件<br/>';
    if (is_dir($fileName)) echo $fileName . ' 是一個目錄<br/>';

    // 詳細屬性
    echo '文件類型:' . getFileType($fileName) . '<br/>';
    echo '文件大小:' . getFileSize(filesize($fileName)) . '<br/>';
    
    // 權限檢查
    if (is_readable($fileName)) echo '文件可讀<br/>';
    if (is_writable($fileName)) echo '文件可寫<br/>';
    if (is_executable($fileName)) echo '文件可執行<br/>';

    // 時間資訊
    echo '建立時間:' . date('Y年m月j日', filectime($fileName)) . '<br/>';
    echo '修改時間:' . date('Y年m月j日', filemtime($fileName)) . '<br/>';
    echo '存取時間:' . date('Y年m月j日', fileatime($fileName)) . '<br/>';
}

function getFileType($fileName) {
    $types = [
        'file' => '普通文件', 'dir' => '目錄文件',
        'block' => '塊設備文件', 'char' => '字符設備文件',
        'fifo' => '管道文件', 'link' => '符號鏈接',
        'unknown' => '未知文件'
    ];
    return $types[filetype($fileName)] ?? '未知類型';
}

function getFileSize($bytes) {
    $units = ['B', 'KB', 'MB', 'GB', 'TB'];
    $pow = floor(($bytes ? log($bytes) : 0) / log(1024));
    $pow = min($pow, count($units) - 1);
    $size = $bytes / pow(1024, $pow);
    return round($size, 2) . ' ' . $units[$pow];
}

// 使用範例
getFilePro('./test/div.html');
?>

文件屬性輸出結果

二、目錄操作進階:遍歷、複製、刪除與統計

目錄操作是構建文件管理系統、自動化部署腳本、日誌輪轉等功能的關鍵。PHP 通過 DirectoryIterator、RecursiveDirectoryIterator 等 SPL 類別,以及傳統的 opendir()/readdir() 函數提供強大的目錄處理能力。

1. 目錄遍歷最佳實踐

現代 PHP 推薦使用 RecursiveDirectoryIterator 配合 RecursiveIteratorIterator 實現遞歸遍歷,代碼簡潔且效能優異:

<?php
$dir = new RecursiveDirectoryIterator('./test', RecursiveDirectoryIterator::SKIP_DOTS);
$iterator = new RecursiveIteratorIterator($dir, RecursiveIteratorIterator::SELF_FIRST);

foreach ($iterator as $file) {
    $prefix = $file->isDir() ? '[DIR] ' : '[FILE] ';
    echo $prefix . $file->getRealPath() . '<br/>';
}
?>

2. 目錄大小統計

遞歸計算目錄總大小的實用函數:

<?php
function getDirSize($path) {
    $size = 0;
    $iterator = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($path));
    foreach ($iterator as $file) {
        if ($file->isFile()) $size += $file->getSize();
    }
    return $size;
}
?>

3. 目錄複製與刪除

PHP 無內建目錄複製/刪除函數,需自行實現遞歸邏輯。以下是健壯的實現:

<?php
// 遞歸複製目錄
function copyDir($src, $dst) {
    if (!is_dir($dst)) mkdir($dst, 0755, true);
    $dir = opendir($src);
    while (($file = readdir($dir)) !== false) {
        if ($file === '.' || $file === '..') continue;
        $srcPath = $src . '/' . $file;
        $dstPath = $dst . '/' . $file;
        if (is_dir($srcPath)) copyDir($srcPath, $dstPath);
        else copy($srcPath, $dstPath);
    }
    closedir($dir);
}

// 遞歸刪除目錄
function deleteDir($path) {
    $iterator = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($path, RecursiveDirectoryIterator::SKIP_DOTS),
        RecursiveIteratorIterator::CHILD_FIRST
    );
    foreach ($iterator as $file) {
        $file->isDir() ? rmdir($file->getRealPath()) : unlink($file->getRealPath());
    }
    rmdir($path);
}
?>

三、效能與安全建議

  • 緩存文件屬性:頻繁調用 file_exists() 等函數會觸發系統調用,高併發場景下建議緩存結果
  • 路徑處理:統一使用 DIRECTORY_SEPARATOR 或 realpath() 處理跨平台路徑
  • 權限最小化:文件上傳目錄設為不可執行,敏感配置文件設為不可讀
  • 大文件處理:超大文件操作使用流式處理(fopen/fread/fwrite)避免記憶體溢出

掌握這些核心操作並結合 SPL 迭代器,能讓你輕鬆構建高效、安全的文件管理功能。

copyright © 萬盛學電腦網 all rights reserved