萬盛學電腦網

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

PHP 常用檔案操作函數完整指南:存在檢查、讀取、寫入、CSV、資源管理

檔案/目錄存在檢查

<?php
$file = 'C:/data/hello.txt';
$dir  = 'C:/data';

if (file_exists($file)) {
    echo "檔案存在";
} else {
    echo "檔案不存在";
}

// 檢查目錄
if (is_dir($dir)) {
    echo "目錄存在";
}

// 檢查是否為檔案 (非目錄/連結)
if (is_file($file)) {
    echo "是一般檔案";
}
?>

讀取整個檔案內容

file_get_contents() - 最簡單、最常用

<?php
$content = file_get_contents('C:/data/hello.txt');
if ($content !== false) {
    echo $content;
} else {
    echo "讀取失敗";
}
?>
  • 回傳字串 (含換行),失敗回傳 false。
  • 適合小~中型檔案 (記憶體允許下)。
  • 支援 URL (需 allow_url_fopen=On):file_get_contents('https://example.com')。

開啟檔案資源:fopen()

模式完整表

模式讀/寫指標建立截斷備註
r唯讀開頭否否檔案必須存在
r+讀寫開頭否否
w唯寫開頭是是清空現有內容
w+讀寫開頭是是
a唯寫結尾是否追加模式
a+讀寫結尾是否追加可讀
x唯寫開頭僅不存在否獨佔建立,存在失敗
x+讀寫開頭僅不存在否獨佔建立
b----二進位模式,建議搭配 (rb, wb)
t----文字模式 (Windows 換行轉換),預設

開啟範例

<?php
$fp = fopen('c:/data/info.txt', 'r');     // 唯讀
$fp = fopen('c:/data/101.txt', 'w');      // 建立/清空寫入
$fp = fopen('c:/data/102.txt', 'a');      // 追加寫入
$fp = fopen('c:/data/103.txt', 'x');      // 獨佔建立
?>

逐行讀取:fgets() + feof()

<?php
$fp = fopen('C:/data/sites.txt', 'r');
if ($fp) {
    while (($line = fgets($fp)) !== false) {
        echo 'site: ' . htmlspecialchars($line) . '<br>';
    }
    fclose($fp);
}
?>

檔案內容:

woyouxian.com
blabla.cn
google.com

輸出:

site: woyouxian.com
site: blabla.cn
site: google.com

關閉檔案:fclose()

<?php
$fp = fopen('c:/data/info.txt', 'r');
// ...操作...
fclose($fp); // 釋放資源,回傳 bool
?>

寫入檔案

fwrite() - 逐段寫入

<?php
$fp = fopen('C:/data/write.txt', 'w');
fwrite($fp, 'It is awesome.');
fclose($fp);
// 檔案內容:It is awesome.
?>

追加模式:fopen('file', 'a') 指標自動在末尾。

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

<?php
// 覆蓋寫入
file_put_contents('C:/data/one.txt', 'one for all');

// 追加寫入
file_put_contents('C:/data/one.txt', ' all for one', FILE_APPEND);
// 檔案變成:one for all all for one

// 陣列自動用換行連接 (僅一維)
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);
?>

其他實用讀取函數

函數用途回傳
file()整檔讀成陣列 (每行一元素,含換行)array/false
readfile()直接輸出到瀏覽器 (下載、圖片輸出)位元組數/false
fpassthru()從目前指標輸出到 EOF位元組數/false
file_get_contents()整檔讀成字串 (可指定 offset/length)string/false

路徑處理最佳實務

  • 使用 __DIR__ 建立相對腳本的絕對路徑:__DIR__ . '/data/file.txt'。
  • 跨平台路徑分隔符:DIRECTORY_SEPARATOR (Windows \、Linux/Unix /)。
  • Windows 路徑雙引號字串需雙反斜線 C:\\data\\file.txt 或改用正斜線 C:/data/file.txt (PHP 支援)。

錯誤處理模式

<?php
$fp = @fopen($file, 'r'); // @ 抑制警告
if ($fp === false) {
    error_log("Failed to open $file");
    return;
}
try {
    // 操作...
} finally {
    fclose($fp); // 確保關閉
}
?>
copyright © 萬盛學電腦網 all rights reserved