整理 PHP 檔案/目錄操作高頻函數:路徑解析、存在性檢查、讀寫、資料夾操作,附帶參數說明與常見陷阱。
| 函數 | 用途 | 範例 |
|---|---|---|
basename($path) | 取得檔名 | basename('/a/b.txt') → 'b.txt' |
dirname($path) | 取得目錄路徑 | dirname('/a/b.txt') → '/a' |
pathinfo($path) | 回傳關聯陣列 | ['dirname'=>'/a', 'basename'=>'b.txt', 'extension'=>'txt', 'filename'=>'b'] |
realpath($path) | 解析絕對路徑 (解析符號連結、相對路徑) | 檔案必須存在 |
is_file($path); // 是否為檔案
is_dir($path); // 是否為目錄
file_exists($path); // 檔案或目錄存在
// 全部讀入字串 (記憶體)
$content = file_get_contents($file);
// 全部讀入陣列 (每行一元素)
$lines = file($file, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
// 逐行讀取 (大檔案省記憶體)
$fp = fopen($file, 'r');
while (($line = fgets($fp)) !== false) { /* 處理 */ }
fclose($fp);
// CSV 解析
while (($row = fgetcsv($fp)) !== false) { /* $row 為陣列 */ }
// 過濾 HTML 標籤讀取
while (($line = fgetss($fp)) !== false) { /* ... */ }
// 讀取指定長度
$data = fread($fp, $length);
$fp = fopen($file, 'w'); // 'w' 覆寫, 'a' 追加, 'x' 獨佔建立
fwrite($fp, $data);
fclose($fp);
// 簡易單行寫入 (PHP 5+)
file_put_contents($file, $data); // 等同 fopen+fwrite+fclose
file_put_contents($file, $data, FILE_APPEND | LOCK_EX); // 追加+鎖定
mkdir($path, 0755, true); // true 遞迴建立
rmdir($path); // 僅刪除空目錄
scandir($path); // 列出目錄內容 (含 . 和 ..)
glob('*.php'); // 模式匹配列出檔案
\ 需雙重跳脫或用 / 通用。fopen() 失敗回傳 false,**必須用 === 判斷**。file_get_contents()/file() 避免記憶體爆炸。is_writable(),目錄需 is_writable(dirname($file))。LOCK_EX (獨佔鎖) 或資料庫替代。