基礎檔案操作函數
1. 讀取整個檔案到字串
<?php
// 方式一:fopen + fread + fclose (經典、可控緩衝)
$fp = fopen('file.txt', 'r');
$contents = fread($fp, filesize('file.txt'));
fclose($fp);
// 方式二:file_get_contents (PHP 4.3+,最簡潔、內建優化)
$contents = file_get_contents('file.txt');
// 方式三:file() 返回陣列 (逐行)
$lines = file('file.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
2. 寫入字串到檔案
<?php
$content = "需要寫入的內容\n多行支援";
// 方式一:fopen + fwrite + fclose (可控模式、追加/鎖定)
$fp = fopen('file.txt', 'wb+'); // w:截斷/建立, b:二進位安全, +:讀寫
fwrite($fp, $content);
fclose($fp);
// 方式二:file_put_contents (PHP 5+, 原子性寫入支援)
file_put_contents('file.txt', $content); // 覆蓋
file_put_contents('file.txt', $content, FILE_APPEND); // 追加
file_put_contents('file.txt', $content, LOCK_EX); // 獨佔鎖防併發衝突
進階封裝:安全、可測試的檔案操作類
<?php
class FileUtil
{
/**
* 安全讀取檔案 (支援大檔案流式讀取)
* @param string $path
* @param int $maxSize 最大讀取位元組 (0=無限制)
* @return string|false
*/
public static function read(string $path, int $maxSize = 0)
{
if (!is_readable($path)) {
return false;
}
if ($maxSize > 0) {
$fp = fopen($path, 'rb');
$data = fread($fp, $maxSize);
fclose($fp);
return $data;
}
return file_get_contents($path);
}
/**
* 原子性寫入 (臨時檔 + rename,防止部分寫入被讀取)
* @param string $path
* @param string $data
* @param int $flags FILE_APPEND | LOCK_EX
* @return int|false 寫入位元組數
*/
public static function write(string $path, string $data, int $flags = 0): int|false
{
$dir = dirname($path);
if (!is_dir($dir) && !mkdir($dir, 0755, true)) {
return false;
}
$tmpPath = $path . '.tmp.' . uniqid('', true);
$bytes = @file_put_contents($tmpPath, $data, LOCK_EX);
if ($bytes === false) {
@unlink($tmpPath);
return false;
}
// rename 在同檔案系統上是原子操作
if (!@rename($tmpPath, $path)) {
@unlink($tmpPath);
return false;
}
return $bytes;
}
/**
* 追加寫入 (自動加鎖)
*/
public static function append(string $path, string $data): int|false
{
return self::write($path, $data, FILE_APPEND | LOCK_EX);
}
/**
* 獲取檔案 MIME 類型 (需 fileinfo 擴展)
*/
public static function mimeType(string $path): ?string
{
$finfo = new finfo(FILEINFO_MIME_TYPE);
return $finfo->file($path) ?: null;
}
}
// 使用範例
FileUtil::write('logs/app.log', date('c') . " Request started\n", FILE_APPEND);
$config = json_decode(FileUtil::read('config/app.json'), true);
大檔案處理最佳實踐
- 逐行處理:
foreach (new SplFileObject('huge.log') as $line) { ... } — 記憶體常數級佔用。
- CSV 解析:
SplFileObject::setFlags(SplFileObject::READ_CSV) 內建 CSV 解析器。
- JSON 流式解析:使用
halaxa/json-stream 或 salsify/json-streaming-parser 避免全量載入。
權限與安全檢查清單
- 上傳目錄設定
open_basedir 限制存取範圍。
- 用戶上傳檔案:重命名 (UUID)、移除執行權限、驗證 MIME、病毒掃描。
- 日誌/快取目錄:設定
chmod 750、屬主為 PHP-FPM 用戶、定期清理策略。
- 避免在 Web 根目錄下執行
include $_GET['file'] 等動態包含。