PHP SPL (Standard PHP Library) 提供了面向對象的文件操作類,比傳統過程式函數更優雅、功能更豐富。本文深度解析 SplFileInfo 與 SplFileObject 的核心功能與實戰技巧。
<?php
$file = new SplFileInfo('foo-bar.txt');
// 批量獲取屬性
$info = [
'basename' => $file->getBasename(), // 文件名
'filename' => $file->getFilename(), // 同 basename
'extension' => $file->getExtension(), // 擴展名
'path' => $file->getPath(), // 目錄路徑
'pathname' => $file->getPathname(), // 完整路徑
'realpath' => $file->getRealPath(), // 絕對路徑(解析鏈接)
'size' => $file->getSize(), // 字節大小
'perms' => $file->getPerms(), // 權限 (oct)
'atime' => $file->getATime(), // 最後訪問時間
'mtime' => $file->getMTime(), // 最後修改時間
'ctime' => $file->getCTime(), // inode 修改時間
'type' => $file->getType(), // file/dir/link
'is_file' => $file->isFile(),
'is_dir' => $file->isDir(),
'is_link' => $file->isLink(),
'is_readable' => $file->isReadable(),
'is_writable' => $file->isWritable(),
'is_executable' => $file->isExecutable(),
'owner' => $file->getOwner(), // 擁有者 UID
'group' => $file->getGroup(), // 群組 GID
'inode' => $file->getInode(), // inode 號
'link_target' => $file->getLinkTarget(), // 鏈接目標
];
print_r($info);
?>
繼承 SplFileInfo,實現 Iterator、SeekableIterator、RecursiveIterator 接口。
<?php
try {
$file = new SplFileObject('data.txt');
foreach ($file as $lineNum => $line) {
echo "Line $lineNum: $line";
}
} catch (Exception $e) {
echo "錯誤: " . $e->getMessage();
}
?>
<?php
$file = new SplFileObject('large_log.txt');
$file->seek(1000); // 直接跳到第 1001 行 (0-based)
echo "第 1001 行: " . $file->current();
// 獲取總行數
$file->seek(PHP_INT_MAX); // 移至末尾
$totalLines = $file->key() + 1;
echo "總行數: $totalLines";
?>
<?php
// 寫入 CSV
$list = [
['姓名', '年齡', '城市'],
['張三', 25, '北京'],
['李四', 30, '上海'],
];
$file = new SplFileObject('users.csv', 'w');
$file->setFlags(SplFileObject::READ_CSV); // 設置 CSV 模式
foreach ($list as $fields) {
$file->fputcsv($fields);
}
// 讀取 CSV
$file = new SplFileObject('users.csv', 'r');
$file->setFlags(SplFileObject::READ_CSV | SplFileObject::READ_AHEAD | SplFileObject::SKIP_EMPTY);
foreach ($file as $row) {
print_r($row); // 直接得到解析後的數組
}
?>
<?php
$file = new SplFileObject('log.txt', 'a'); // 追加模式
$file->flock(LOCK_EX); // 獨佔鎖
$file->fwrite("[" . date('c') . "] 用戶登錄\n");
$file->flock(LOCK_UN); // 釋放鎖
// 自動關閉時釋放鎖
?>
| 常量 | 作用 |
|---|---|
| READ_AHEAD | 預讀下一行 (foreach 必需) |
| SKIP_EMPTY | 跳過空行 |
| DROP_NEW_LINE | 去除行尾換行符 |
| READ_CSV | 啟用 CSV 解析模式 |
<?php
// 非遞歸遍歷
$dir = new DirectoryIterator('/var/www/html');
foreach ($dir as $fileinfo) {
if ($fileinfo->isDot()) continue; // 跳過 . 和 ..
echo $fileinfo->getFilename() . " (" . $fileinfo->getSize() . " bytes)\n";
}
// 遞歸遍歷 (RecursiveDirectoryIterator + RecursiveIteratorIterator)
$rdi = new RecursiveDirectoryIterator('/var/www/html');
$rii = new RecursiveIteratorIterator($rdi);
foreach ($rii as $fileinfo) {
if ($fileinfo->isFile() && $fileinfo->getExtension() === 'php') {
echo $fileinfo->getPathname() . "\n";
}
}
// 過濾器模式
$filter = new RegexIterator($rii, '/\.php$/i');
foreach ($filter as $file) {
echo $file->getPathname() . "\n";
}
?>
file() 讀入數組fgetcsv/fputcsv 正確處理引號、轉義、換行符isReadable()/isWritable() 預檢RuntimeException (文件不存在/不可讀),需 try-catch