萬盛學電腦網

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

PHP 讀寫文件基礎操作與進階封裝

基礎檔案操作函數

1. 讀取整個檔案到字串

<?php
// 方式一:fopen + fread + fclose (經典、可控緩衝)
$fp = fopen('file.txt', 'r');
$contents = fread($fp, filesize('file.txt'));
fclose($fp);

// 方式二:file_get_contents (PHP 4.3+,最簡潔、內建優化)
$contents = file_get_contents('file.txt');

// 方式三:file() 返回陣列 (逐行)
$lines = file('file.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);

2. 寫入字串到檔案

<?php
$content = "需要寫入的內容\n多行支援";

// 方式一:fopen + fwrite + fclose (可控模式、追加/鎖定)
$fp = fopen('file.txt', 'wb+'); // w:截斷/建立, b:二進位安全, +:讀寫
fwrite($fp, $content);
fclose($fp);

// 方式二:file_put_contents (PHP 5+, 原子性寫入支援)
file_put_contents('file.txt', $content);           // 覆蓋
file_put_contents('file.txt', $content, FILE_APPEND); // 追加
file_put_contents('file.txt', $content, LOCK_EX);     // 獨佔鎖防併發衝突

進階封裝:安全、可測試的檔案操作類

<?php
class FileUtil
{
    /**
     * 安全讀取檔案 (支援大檔案流式讀取)
     * @param string $path
     * @param int    $maxSize 最大讀取位元組 (0=無限制)
     * @return string|false
     */
    public static function read(string $path, int $maxSize = 0)
    {
        if (!is_readable($path)) {
            return false;
        }

        if ($maxSize > 0) {
            $fp = fopen($path, 'rb');
            $data = fread($fp, $maxSize);
            fclose($fp);
            return $data;
        }

        return file_get_contents($path);
    }

    /**
     * 原子性寫入 (臨時檔 + rename,防止部分寫入被讀取)
     * @param string $path
     * @param string $data
     * @param int    $flags FILE_APPEND | LOCK_EX
     * @return int|false 寫入位元組數
     */
    public static function write(string $path, string $data, int $flags = 0): int|false
    {
        $dir = dirname($path);
        if (!is_dir($dir) && !mkdir($dir, 0755, true)) {
            return false;
        }

        $tmpPath = $path . '.tmp.' . uniqid('', true);
        $bytes = @file_put_contents($tmpPath, $data, LOCK_EX);

        if ($bytes === false) {
            @unlink($tmpPath);
            return false;
        }

        // rename 在同檔案系統上是原子操作
        if (!@rename($tmpPath, $path)) {
            @unlink($tmpPath);
            return false;
        }

        return $bytes;
    }

    /**
     * 追加寫入 (自動加鎖)
     */
    public static function append(string $path, string $data): int|false
    {
        return self::write($path, $data, FILE_APPEND | LOCK_EX);
    }

    /**
     * 獲取檔案 MIME 類型 (需 fileinfo 擴展)
     */
    public static function mimeType(string $path): ?string
    {
        $finfo = new finfo(FILEINFO_MIME_TYPE);
        return $finfo->file($path) ?: null;
    }
}

// 使用範例
FileUtil::write('logs/app.log', date('c') . " Request started\n", FILE_APPEND);
$config = json_decode(FileUtil::read('config/app.json'), true);

大檔案處理最佳實踐

  • 逐行處理:foreach (new SplFileObject('huge.log') as $line) { ... } — 記憶體常數級佔用。
  • CSV 解析:SplFileObject::setFlags(SplFileObject::READ_CSV) 內建 CSV 解析器。
  • JSON 流式解析:使用 halaxa/json-stream 或 salsify/json-streaming-parser 避免全量載入。

權限與安全檢查清單

  1. 上傳目錄設定 open_basedir 限制存取範圍。
  2. 用戶上傳檔案:重命名 (UUID)、移除執行權限、驗證 MIME、病毒掃描。
  3. 日誌/快取目錄:設定 chmod 750、屬主為 PHP-FPM 用戶、定期清理策略。
  4. 避免在 Web 根目錄下執行 include $_GET['file'] 等動態包含。
copyright © 萬盛學電腦網 all rights reserved