萬盛學電腦網

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

PHP 5 文件與目錄操作完全指南:讀寫、屬性、鎖定、遍歷、權限

目錄操作

1. 遍歷目錄 (傳統 opendir/readdir/closedir)

<?php
$baseDir = __DIR__ . '/filelist';
$handle = opendir($baseDir);
if ($handle) {
    echo "目錄: $baseDir <hr>";
    while (false !== ($entry = readdir($handle))) {
        // 跳過 . 和 ..
        if ($entry !== '.' && $entry !== '..') {
            $fullPath = $baseDir . DIRECTORY_SEPARATOR . $entry;
            $isDir = is_dir($fullPath);
            echo "[$entry] " . ($isDir ? '<b>[目錄]</b>' : '[文件]') . "<br>";
        }
    }
    closedir($handle);
}
?>

2. DirectoryIterator (面向對象,PHP 5+)

<?php
$dir = new DirectoryIterator('/etc/php5');
echo "Handle: {$dir->getPathname()}<br>";
echo "Path: {$dir->getPath()}<br>";
foreach ($dir as $fileinfo) {
    if (!$fileinfo->isDot()) {
        echo $fileinfo->getFilename() . "<br>";
    }
}
// 無需顯式 close,析構函數自動調用
?>

3. 遞歸遍歷 (獲取所有文件路徑)

<?php
function getAllFiles($dir) {
    $files = [];
    $iterator = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS));
    foreach ($iterator as $fileinfo) {
        if ($fileinfo->isFile()) {
            $files[] = $fileinfo->getPathname();
        }
    }
    return $files;
}
print_r(getAllFiles('/var/www/html'));
?>

4. 目錄創建/刪除/信息

<?php
$path = 'data/logs/2024/05';
// 創建多級目錄,權限 0755 (受 umask 影響)
if (!is_dir($path)) {
    mkdir($path, 0755, true); // 第三參數 true 遞歸創建
}
// 刪除空目錄
rmdir($path); // 僅能刪除空目錄
// 遞歸刪除目錄及內容
function rrmdir($dir) {
    if (is_dir($dir)) {
        $items = new RecursiveIteratorIterator(
            new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS),
            RecursiveIteratorIterator::CHILD_FIRST
        );
        foreach ($items as $item) {
            $item->isDir() ? rmdir($item->getPathname()) : unlink($item->getPathname());
        }
        rmdir($dir);
    }
}
// 獲取目錄信息
echo "目錄部分: " . dirname('/var/www/html/index.php') . "<br>"; // /var/www/html
echo "文件名部分: " . basename('/var/www/html/index.php') . "<br>"; // index.php
echo "磁盤剩余空間: " . disk_free_space('/') . " 字節<br>";

文件操作

A. 讀取文件

<?php
$file = 'dirlist.php';

// 1. 檢查可讀性
if (!is_readable($file)) {
    die('文件不存在或不可讀');
}

// 2. 一次性讀取全部內容 (推薦 PHP 5.4+)
$data = file_get_contents($file);
echo htmlspecialchars($data);

// 3. 低版本兼容 / 二進制文件 / 大文件分塊讀取
$fp = fopen($file, 'rb'); // 二進制模式
if ($fp) {
    // 方式 A: fread 指定長度
    $data = fread($fp, filesize($file));
    // 方式 B: 循環讀取 (適合大文件)
    while (!feof($fp)) {
        echo fread($fp, 8192); // 每次 8KB
    }
    fclose($fp);
}

// 4. 讀取為數組 (每行一個元素)
$lines = file($file, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
print_r($lines);
?>

B. 寫入文件

<?php
$file = 'dirlist.php';
$data = "新內容\n第二行\n";

// 1. 檢查可寫性
if (!is_writable($file)) {
    die("文件不可寫");
}

// 2. 一次性寫入 (PHP 5+ 推薦,原子性較好)
if (file_put_contents($file, $data, LOCK_EX) === false) {
    die("寫入失敗");
}

// 3. 低版本兼容 / 需精確控制鎖
$fp = fopen($file, 'wb');
if ($fp) {
    if (flock($fp, LOCK_EX)) { // 獨佔鎖
        fwrite($fp, $data);
        flock($fp, LOCK_UN); // 釋放鎖
    } else {
        die("無法獲取鎖");
    }
    fclose($fp);
}

// 4. 追加寫入
file_put_contents($file, "追加行\n", FILE_APPEND | LOCK_EX);
?>

C. 文件鎖定機制詳解 (flock)

<?php
function cachePage($file, $data) {
    $fp = fopen($file, 'wb');
    if (!$fp) return false;

    // 非阻塞獨佔鎖 (立即返回失敗)
    if (!flock($fp, LOCK_EX | LOCK_NB)) {
        fclose($fp);
        return false; // 正在被寫入
    }

    // 寫入
    $written = fwrite($fp, $data);
    if ($written === false) {
        flock($fp, LOCK_UN);
        fclose($fp);
        return false;
    }

    flock($fp, LOCK_UN);
    fclose($fp);
    return true;
}

// 共享鎖 (讀取時使用,允許並發讀)
$fp = fopen($file, 'rb');
flock($fp, LOCK_SH);
// ... 讀取 ...
flock($fp, LOCK_UN);
fclose($fp);
?>

D. 複制、刪除、重命名

<?php
// 複制
copy('source.txt', 'dest.txt') or die('復制失敗');
// 刪除
unlink('temp.txt') or die('刪除失敗');
// 重命名/移動
rename('oldname.txt', 'newname.txt') or die('重命名失敗');
// 獲取文件屬性
$file = 'test.txt';
echo "大小: " . filesize($file) . " 字節<br>";
echo "修改時間: " . date('Y-m-d H:i:s', filemtime($file)) . "<br>";
echo "訪問時間: " . date('Y-m-d H:i:s', fileatime($file)) . "<br>";
echo "狀態改變時間: " . date('Y-m-d H:i:s', filectime($file)) . "<br>";
echo "權限: " . substr(sprintf('%o', fileperms($file)), -4) . "<br>";
// 獲取所有屬性數組
print_r(stat($file));
/*
Array
(
    [0] => 2050   // dev
    [1] => 123456 // ino
    [2] => 33188  // mode (權限+類型)
    [3] => 1      // nlink
    [4] => 1000   // uid
    [5] => 1000   // gid
    [6] => 0      // rdev
    [7] => 1024   // size
    [8] => 1716200000 // atime
    [9] => 1716200000 // mtime
    [10] => 1716200000 // ctime
    [11] => 4096  // blksize
    [12] => 8     // blocks
)
*/
?>

文件上傳處理 (HTTP POST)

<?php
// 表單需 enctype="multipart/form-data"
if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['upfile'])) {
    $file = $_FILES['upfile'];
    // 錯誤碼檢查
    if ($file['error'] !== UPLOAD_ERR_OK) {
        die("上傳錯誤代碼: {$file['error']}");
    }
    // 類型/大小驗證
    $allowedMimes = ['image/jpeg', 'image/png', 'image/gif'];
    $maxSize = 2 * 1024 * 1024; // 2MB
    if (!in_array($file['type'], $allowedMimes)) die('類型不允許');
    if ($file['size'] > $maxSize) die('文件過大');

    // 安全文件名
    $ext = pathinfo($file['name'], PATHINFO_EXTENSION);
    $newName = uniqid('upload_', true) . ".$ext";
    $dest = __DIR__ . "/uploads/$newName";

    // 移動上傳文件 (必須使用 move_uploaded_file)
    if (move_uploaded_file($file['tmp_name'], $dest)) {
        echo "上傳成功: $newName";
    } else {
        echo "移動失敗";
    }
}
?>

最佳實踐總結

  1. 路徑處理:始終使用 DIRECTORY_SEPARATOR、realpath()、__DIR__ 構建絕對路徑,避免相對路徑混淆。
  2. 錯誤處理:文件操作函數返回 false 表示失敗,務必檢查返回值,使用 error_get_last() 獲取詳細信息。
  3. 併發安全:寫入必須使用 LOCK_EX,讀取建議 LOCK_SH,避免臟讀/數據損壞。
  4. 資源管理:fopen 后必須 fclose,推薦使用 try/finally 或封裝為類實現 RAII。
  5. 大文件處理:流式讀寫 (fread/fwrite 循環)、生成器逐行處理、避免 file_get_contents 一次性載入內存。
  6. 安全:上傳文件重命名、類型驗證 (MIME + 擴展名 + 內容檢測)、存放於 Web 根目錄外、禁用腳本執行權限。

結語

文件系統操作是後端開發的基石。從簡單的配置文件讀寫到複雜的日誌分析、文件同步、大數據導入導出,扎實掌握 PHP 文件操作 API、流控制、鎖機制、錯誤處理,是構建穩健系統的關鍵。

copyright © 萬盛學電腦網 all rights reserved