很多朋友會改模板、調 CSS,但一看到 就頭大。本系列假設你:懂基本 HTML、懂 if/else 邏輯、願意動手敲代碼。不講大理論,直接剖析最簡單的計數器,帶你跨過「能改」到「能寫」的鴻溝。
<?php
// counter.php
$dataFile = 'data.txt'; // 1. 計數檔案路徑
$fp = fopen($dataFile, 'r'); // 2. 以「讀取」模式開啟
$num = fgets($fp, 10); // 3. 讀取最多 10 位元組 (足夠存數字)
$num = trim($num); // 4. 去除換行/空白
fclose($fp); // 5. 關閉檔案
echo "您是第 $num 位訪客"; // 6. 輸出
$fp = fopen($dataFile, 'w'); // 7. 以「寫入」模式開啟 (清空檔案)
$num = $num + 1; // 8. 數字 +1
fputs($fp, $num); // 9. 寫入新數字
fclose($fp); // 10. 關閉
?>
| 行 | 函數/語法 | 通俗解釋 | 關鍵點 |
|---|---|---|---|
| 1 | $dataFile = 'data.txt' | 定義變數存檔案名 | 相對路徑 = 當前腳本同目錄 |
| 2 | fopen($file, 'r') | 打開檔案讀取,返回「檔案指標」 | 失敗返回 false,實務必判斷 |
| 3 | fgets($fp, 10) | 讀取一行或最多 10 字元 | 長度設大一點避免截斷 |
| 4 | trim() | 去頭尾空白/換行 | 檔案讀出常含 \n |
| 5 | fclose() | 關閉檔案,釋放鎖定 | 好習慣:用完即關 |
| 6 | echo "字串 $var" | 雙引號內變數自動解析 | 單引號不解析較快 |
| 7 | fopen($file, 'w') | 寫入模式:**會清空檔案** | 若要追加用 'a' |
| 8 | $num = $num + 1 | 數學運算 | PHP 自動型別轉換 |
| 9 | fputs($fp, $num) | 寫入字串 (同 fwrite) | 需是字串,數字自動轉 |
| 10 | fclose() | 同上 |
上述代碼**併發下會漏計數** (兩請求同時讀到 100,寫回 101)。解決:檔案鎖 flock()。
<?php
function safeCounter(string $file): int
{
$fp = fopen($file, 'c+'); // 讀寫、不截斷、不存在則建立
if (!$fp) throw new RuntimeException("無法開啟 $file");
// 獨佔鎖 (阻塞等待)
if (!flock($fp, LOCK_EX)) {
fclose($fp);
throw new RuntimeException('無法取得鎖');
}
$num = (int)fgets($fp, 20);
rewind($fp); // 指標回開頭
ftruncate($fp, 0); // 清空內容
fwrite($fp, (string)($num + 1));
fflush($fp); // 強制寫入磁碟
flock($fp, LOCK_UN); // 釋放鎖
fclose($fp);
return $num + 1;
}
echo "您是第 " . safeCounter('data.txt') . " 位訪客";
?>
<?php
// Redis 原子遞增 (最推薦)
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
$count = $redis->incr('site:pv'); // 原子操作,無競爭
echo "PV: $count";
// MySQL 原子更新
$pdo->exec("UPDATE counters SET `count` = `count` + 1 WHERE name = 'pv'");
// 讀取
$count = $pdo->query("SELECT `count` FROM counters WHERE name = 'pv'")->fetchColumn();
?>
file_get_contents / file_put_contents 簡化讀寫 (提示:LOCK_EX 旗標)。下一篇將講解:表單處理 ($_GET/$_POST)、資料驗證、防 XSS 輸出、Session 登入狀態。請先動手把計數器跑起來、改壞、再修好,這才是學會的唯一路徑。