萬盛學電腦網

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

PHP fopen 文件讀寫實戰:從基礎操作到計數器與 robots.txt 編輯器

PHP fopen() 是文件操作的基石,支援本地文件與遠程 URL 的多種模式讀寫。本文通過三個實戰案例——文件創建、robots.txt 在線編輯器、訪問計數器——系統講解 fopen 核心模式、讀寫流程與常見陷阱。

fopen 核心模式速查

| 模式 | 說明 | 指針位置 | 文件不存在 | 截斷文件 | |------|------|----------|------------|----------| | r | 唯讀 | 開頭 | 失敗 | 否 | | r+ | 讀寫 | 開頭 | 失敗 | 否 | | w | 唯寫 | 開頭 | 創建 | 是 | | w+ | 讀寫 | 開頭 | 創建 | 是 | | a | 追加寫入 | 結尾 | 創建 | 否 | | a+ | 讀寫追加 | 結尾 | 創建 | 否 |

案例一:安全創建文件

<?php
$file = 'test.txt';
if (!file_exists($file)) {
    $fh = fopen($file, 'w'); // 創建空文件
    fclose($fh);
    echo "文件創建成功";
} else {
    echo "文件已存在";
}
?>

注意:w 模式會清空現有文件,a 模式則保留內容並追加。

案例二:robots.txt 在線編輯器

完整實現讀取、編輯、保存功能:

<?php
// 讀取函數
function read_txt($file) {
    if (!file_exists($file)) return '';
    $fp = fopen($file, 'r');
    $content = '';
    while (!feof($fp)) {
        $content .= fgets($fp, 4096); // 分塊讀取,避免大文件內存溢出
    }
    fclose($fp);
    return $content;
}

// 寫入函數
function write_txt($file, $content) {
    $fp = fopen($file, 'w'); // 截斷重寫
    fwrite($fp, $content);
    fclose($fp);
}

// 業務邏輯
$action = $_GET['action'] ?? 'read';
$file = 'robots.txt';

if ($action === 'write') {
    $content = $_POST['content'] ?? '';
    write_txt($file, $content);
    echo "保存成功 <a href='?action=read'>返回</a>";
} else {
    $content = read_txt($file);
    echo "<form method='post' action='?action=write'>";
    echo "<textarea name='content' rows='20' cols='80'>" . htmlspecialchars($content) . "</textarea><br>";
    echo "<input type='submit' value='保存'></form>";
}
?>

案例三:文本文件訪問計數器

<?php
function hit_counter($file = 'counter.txt') {
    $count = 0;
    if (file_exists($file)) {
        $fp = fopen($file, 'r');
        $count = (int)fgets($fp, 20); // 讀取並強制轉整數
        fclose($fp);
    }
    $count++;
    $fp = fopen($file, 'w');
    fwrite($fp, (string)$count);
    fclose($fp);
    return $count;
}

$hits = hit_counter();
echo "您是第 <b>$hits</b> 位訪客!";
?>

在需顯示統計的頁面引入:<?php include 'counter.php'; ?>

關鍵最佳實踐

  1. 檢查返回值:fopen 失敗返回 false,務必判斷後再操作
  2. 資源釋放:fclose() 釋放文件鎖與系統資源,防止洩漏
  3. 大文件分塊讀取:fgets($fp, 4096) 或 fread($fp, 8192),避免一次性讀入內存
  4. 並發安全:計數器等寫入場景需加文件鎖(flock),詳見「PHP flock 文件鎖詳解」
  5. 路徑處理:使用 __DIR__ 構建絕對路徑,避免相對路徑混淆

現代替代方案

PHP 5.4+ 提供更簡潔的函數:

  • file_get_contents($file):一次性讀取全文(小文件)
  • file_put_contents($file, $data, FILE_APPEND | LOCK_EX):原子寫入,內建鎖定
  • file($file):按行讀入陣列
// 計數器現代寫法
$count = (int)@file_get_contents('counter.txt') + 1;
file_put_contents('counter.txt', $count, LOCK_EX);
echo "您是第 $count 位訪客";

總結

fopen 給予底層控制權,適合流式處理、大文件、需精確控制指針的場景。日常開發中,優先使用 file_get_contents/file_put_contents 簡化代碼;涉及並發寫入時,務必加鎖(flock 或 LOCK_EX)。理解「模式選擇、指針位置、資源釋放」三要素,是文件操作不出 Bug 的關鍵。

copyright © 萬盛學電腦網 all rights reserved