萬盛學電腦網

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

PHP 面向對象文件系統操作類 IO 實現詳解

類設計目標

封裝文件/目錄的常用操作:列表、屬性獲取、遞歸搜索、刪除、複製、移動、讀寫、編碼轉換、註釋去除等,提供統一錯誤處理與緩存清理機制。

核心屬性

class IO extends SnkClass {
    var $result;        // 操作結果
    var $exec_cmd;      // 執行命令(預留)
    var $exist_dir;     // 最後存在的目錄(複製/移動用)
    var $buffer_size = 8192; // 讀寫緩衝區大小
}

主要方法詳解

1. list_dir($path = '.') — 列出目錄內容

  • 參數:目錄路徑,默認當前目錄。
  • 返回:二維數組 [['name'=>..., 'location'=>..., 'type'=>文件1/目錄0/其他-1], ...]。
  • 特性:自動補全路徑分隔符、忽略 . ..、使用 !== false 防 0 值誤判、調用 clearstatcache() 清除統計緩存。

2. file_info($path = '.') — 獲取文件/目錄詳細屬性

  • 返回:包含 name、location、type、size、access、modify、change、read、write 的關聯數組。
  • 利用 realpath 獲取絕對路徑,fileatime/mtime/ctime 獲取三時間,is_readable/writeable 判權限。

3. seek_file($pattern, $path, $seek_type, $sub_dir_level, $limit) — 正則遞歸搜索

  • $pattern:PCRE 正則,自動包裹 /^...$/。
  • $seek_type:1 只搜文件,0 只搜目錄,-1 全搜。
  • $sub_dir_level:遞歸深度(建議 ≤5)。
  • $limit:結果上限(默認 100),防資源耗盡。
  • 內部調用 list_dir,合併子目錄結果,超限即截斷。

4. delete($path) — 遞歸刪除(含非空目錄)

  • 文件直接 unlink;目錄先 list_dir 遞歸刪除子項,最後 rmdir。
  • 全程錯誤捕獲,失敗拋出錯誤代碼。

5. 其他實用方法

  • copy($src, $dst)、move($src, $dst):大文件分塊讀寫($buffer_size),自動創建目標目錄。
  • read_file($path)、write_file($path, $data, $mode='w'):二進制安全讀寫。
  • no_comment($str):移除 C 風格註釋(/* ... */、// ...),狀態機實現,處理字符串/字符字面量不誤刪。
  • generate_path($path):遞歸創建多級目錄,返回最後存在的目錄路徑。

使用示例

$io = new IO();
$files = $io->list_dir('/var/www/html');
$info = $io->file_info('/var/www/html/index.php');
$found = $io->seek_file('config\.php$', '/var/www', 1, 3, 50);
$io->delete('/tmp/old_cache');

該類結構清晰、錯誤處理完善,適合作為項目基礎設施組件。現代項目可考慮改用 SPL FilesystemIterator、RecursiveDirectoryIterator 或 Symfony Finder 組件。

copyright © 萬盛學電腦網 all rights reserved