萬盛學電腦網

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

PHP SPL 標準庫文件操作實戰:SplFileInfo 與 SplFileObject 深度解析

SPL 文件操作雙雄:SplFileInfo (信息) + SplFileObject (操作)

PHP SPL (Standard PHP Library) 提供了面向對象的文件操作類,比傳統過程式函數更優雅、功能更豐富。本文深度解析 SplFileInfo 與 SplFileObject 的核心功能與實戰技巧。

SplFileInfo:文件元信息查詢專家

<?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);
?>

SplFileObject:文件讀寫遍歷利器

繼承 SplFileInfo,實現 Iterator、SeekableIterator、RecursiveIterator 接口。

1. 逐行遍歷 (自動實現 Iterator)

<?php
try {
    $file = new SplFileObject('data.txt');
    foreach ($file as $lineNum => $line) {
        echo "Line $lineNum: $line";
    }
} catch (Exception $e) {
    echo "錯誤: " . $e->getMessage();
}
?>

2. 隨機訪問指定行 (SeekableIterator)

<?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";
?>

3. CSV 讀寫專用支持

<?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); // 直接得到解析後的數組
}
?>

4. 文件寫入與鎖定

<?php
$file = new SplFileObject('log.txt', 'a'); // 追加模式
$file->flock(LOCK_EX); // 獨佔鎖
$file->fwrite("[" . date('c') . "] 用戶登錄\n");
$file->flock(LOCK_UN); // 釋放鎖
// 自動關閉時釋放鎖
?>

SplFileObject 核心 Flags 常量

常量作用
READ_AHEAD預讀下一行 (foreach 必需)
SKIP_EMPTY跳過空行
DROP_NEW_LINE去除行尾換行符
READ_CSV啟用 CSV 解析模式

目錄遍歷:DirectoryIterator 家族

<?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";
}
?>

性能與最佳實踐

  • 大文件處理:SplFileObject 流式讀取,內存常數級,優於 file() 讀入數組
  • CSV 處理:內置 fgetcsv/fputcsv 正確處理引號、轉義、換行符
  • 權限檢查:操作前用 isReadable()/isWritable() 預檢
  • 異常處理:構造函數拋出 RuntimeException (文件不存在/不可讀),需 try-catch
copyright © 萬盛學電腦網 all rights reserved