PHP fopen() 是文件操作的基石,支援本地文件與遠程 URL 的多種模式讀寫。本文通過三個實戰案例——文件創建、robots.txt 在線編輯器、訪問計數器——系統講解 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 模式則保留內容並追加。
完整實現讀取、編輯、保存功能:
<?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'; ?>
fopen 失敗返回 false,務必判斷後再操作fclose() 釋放文件鎖與系統資源,防止洩漏fgets($fp, 4096) 或 fread($fp, 8192),避免一次性讀入內存flock),詳見「PHP flock 文件鎖詳解」__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 的關鍵。