萬盛學電腦網

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

PHP 檔案與目錄操作函數完整參考(上):目錄管理、檔案開關、讀寫、CSV 處理

目錄操作

建立與刪除目錄

<?php
// 建立目錄,權限 0700(僅擁有者可讀寫執行)
if (mkdir('./path', 0700, true)) {  // true 允許遞迴建立
    echo '建立成功';
}
?>

rmdir() 只能刪除空目錄;刪除非空目錄需遞迴刪除檔案後再刪目錄。

取得與切換工作目錄

  • getcwd():取得目前工作目錄
  • chdir('/new/path'):切換工作目錄

開啟/關閉目錄控制代碼

<?php
$handle = opendir('./path');
if ($handle) {
    while (($entry = readdir($handle)) !== false) {
        echo $entry . '<br>';
    }
    closedir($handle);
}
?>

scandir() 一次取得所有檔案/目錄

<?php
$files = scandir('/path', SCANDIR_SORT_ASCENDING); // 或 SCANDIR_SORT_DESCENDING
print_r($files);
// 回傳陣列包含 . 和 ..,需自行過濾
?>

檔案開啟模式詳解

模式說明指標位置建立檔案截斷檔案
r唯讀開頭否否
r+讀寫開頭否否
w唯寫開頭是是
w+讀寫開頭是是
a唯寫結尾是否
a+讀寫結尾是否
x唯寫(獨佔建立)開頭僅不存在時否
x+讀寫(獨佔建立)開頭僅不存在時否
b二進位模式(建議搭配使用,如 'rb', 'wb')---

檔案寫入函數比較

fwrite() - 逐行/分塊寫入

<?php
$fp = fopen('log.txt', 'a');
fwrite($fp, 'Log entry ' . date('Y-m-d H:i:s') . PHP_EOL);
fclose($fp);
?>

file_put_contents() - 一次性寫入(PHP 5+)

<?php
// 覆蓋寫入
file_put_contents('data.txt', 'Hello World');

// 追加寫入
file_put_contents('data.txt', 'Append line' . PHP_EOL, FILE_APPEND);

// 陣列自動用換行連接(僅一維)
file_put_contents('lines.txt', ['line1', 'line2', 'line3']);
?>

fputcsv() - CSV 格式寫入

<?php
$fp = fopen('export.csv', 'w');
$data = [
    ['ID', 'Name', 'Email'],
    [1, 'John', 'john@example.com'],
    [2, 'Jane', 'jane@example.com']
];
foreach ($data as $row) {
    fputcsv($fp, $row); // 預設逗號分隔、雙引號包裹
}
fclose($fp);
?>

檔案讀取函數比較

函數用途回傳值適用場景
fread($fp, $len)讀取指定位元組字串/false二進位檔、大檔分塊讀取
fgets($fp)讀取一行字串/false文字檔逐行處理
file($path)整檔讀成陣列陣列/false小檔案、需逐行處理
readfile($path)直接輸出到瀏覽器位元組數/false圖片/檔案下載輸出
fpassthru($fp)從目前指標輸出到 EOF位元組數/false已開啟檔案輸出
file_get_contents($path)整檔讀成字串字串/false小檔案、API 回應、模板讀取

實務範例:大檔案逐行處理

<?php
$fp = fopen('huge.log', 'r');
if ($fp) {
    while (($line = fgets($fp)) !== false) {
        // 處理每一行,記憶體不會暴增
        if (strpos($line, 'ERROR') !== false) {
            error_log($line);
        }
    }
    fclose($fp);
}
?>

路徑處理提醒

  • Windows 路徑在雙引號字串中需雙反斜線 C:\\data\\file.txt 或用正斜線 C:/data/file.txt。
  • 使用 DIRECTORY_SEPARATOR 常數撰寫跨平台路徑。
  • realpath() 可解析相對路徑為絕對路徑。

(本文為上集,下集將介紹檔案資訊函數、權限、鎖定、串流操作等進階主題)

copyright © 萬盛學電腦網 all rights reserved