萬盛學電腦網

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

PHP 讀取 CSV 檔案並輸出 HTML 表格完整實作

前言

將 CSV 資料以 HTML 表格顯示是常見的後台管理、報表預覽需求。本文提供完整、安全、可擴充的實作方案。

基礎實作

<?php
function csvToHtmlTable(string $filename, array $options = []): string {
    $defaults = [
        'delimiter' => ',',
        'enclosure' => '"',
        'escape' => '\\',
        'hasHeader' => true,
        'tableClass' => 'csv-table',
        'headerClass' => 'csv-header',
        'rowClasses' => ['csv-row-even', 'csv-row-odd'],
        'maxRows' => 0, // 0 = 無限制
        'encoding' => 'UTF-8',
    ];
    $opts = array_merge($defaults, $options);
    
    if (!file_exists($filename) || !is_readable($filename)) {
        throw new RuntimeException("檔案不存在或不可讀: $filename");
    }
    
    $handle = fopen($filename, 'r');
    if (!$handle) {
        throw new RuntimeException("無法開啟檔案: $filename");
    }
    
    $html = "\n";
    $rowNum = 0;
    
    while (($row = fgetcsv($handle, 0, $opts['delimiter'], $opts['enclosure'], $opts['escape'])) !== false) {
        if ($opts['maxRows'] > 0 && $rowNum >= $opts['maxRows']) break;
        
        $isHeader = $opts['hasHeader'] && $rowNum === 0;
        $tag = $isHeader ? 'th' : 'td';
        $rowClass = $isHeader ? $opts['headerClass'] : $opts['rowClasses'][$rowNum % 2];
        
        $html .= "  \n";
        foreach ($row as $cell) {
            // 編碼轉換
            if ($opts['encoding'] !== 'UTF-8') {
                $cell = mb_convert_encoding($cell, 'UTF-8', $opts['encoding']);
            }
            // HTML 跳脫防 XSS
            $cell = htmlspecialchars($cell, ENT_QUOTES, 'UTF-8');
            // 保留空白顯示
            $cell = $cell === '' ? ' ' : nl2br($cell);
            
            $html .= "    <$tag>$cell\n";
        }
        $html .= "  \n";
        $rowNum++;
    }
    
    fclose($handle);
    $html .= "
"; return $html; } // 使用範例 try { echo csvToHtmlTable('sample.csv', [ 'tableClass' => 'table table-striped table-bordered', 'maxRows' => 100, ]); } catch (Exception $e) { echo "
錯誤: {$e->getMessage()}
"; } ?>

進階功能:分頁、排序、搜尋

<?php
class CsvTableRenderer {
    private array $data = [];
    private array $headers = [];
    
    public function __construct(string $filename, array $options = []) {
        $this->loadCsv($filename, $options);
    }
    
    private function loadCsv(string $filename, array $options): void {
        $handle = fopen($filename, 'r');
        $headers = fgetcsv($handle, 0, $options['delimiter'] ?? ',');
        $this->headers = $headers ?: [];
        
        while (($row = fgetcsv($handle, 0, $options['delimiter'] ?? ',')) !== false) {
            $this->data[] = array_combine($this->headers, $row);
        }
        fclose($handle);
    }
    
    public function render(array $params = []): string {
        $page = max(1, (int)($params['page'] ?? 1));
        $perPage = (int)($params['perPage'] ?? 20);
        $sort = $params['sort'] ?? '';
        $order = $params['order'] ?? 'asc';
        $search = $params['search'] ?? '';
        
        $filtered = $this->filterData($search);
        if ($sort && isset($this->headers[$sort])) {
            usort($filtered, fn($a, $b) => $order === 'asc' 
                ? strcmp($a[$sort] ?? '', $b[$sort] ?? '')
                : strcmp($b[$sort] ?? '', $a[$sort] ?? ''));
        }
        
        $total = count($filtered);
        $totalPages = ceil($total / $perPage);
        $offset = ($page - 1) * $perPage;
        $pageData = array_slice($filtered, $offset, $perPage);
        
        return $this->buildTable($pageData, $page, $totalPages, $sort, $order, $search);
    }
    
    private function filterData(string $search): array {
        if (!$search) return $this->data;
        $search = mb_strtolower($search);
        return array_filter($this->data, function($row) use ($search) {
            return array_reduce($row, function($carry, $val) use ($search) {
                return $carry || str_contains(mb_strtolower((string)$val), $search);
            }, false);
        });
    }
    
    private function buildTable(array $data, int $page, int $totalPages, string $sort, string $order, string $search): string {
        // 建構包含分頁、排序連結、搜尋表單的完整 HTML
        // 略...
    }
}
?>

前端整合:DataTables.js 客戶端增強

<!-- HTML -->
<script> $('#csvTable').DataTable({ pageLength: 25, order: [[0, 'asc']], language: { url: '//cdn.datatables.net/plug-ins/1.13.6/i18n/zh-HANT.json' }, dom: 'Bfrtip', buttons: ['copy', 'csv', 'excel', 'pdf', 'print'] }); </script>

大檔案處理策略

策略適用場景實作要點
串流輸出超大檔(>100MB)分塊讀取、分塊輸出、避免載入全部記憶體
分頁載入中型檔、需互動AJAX 分頁、後端只讀取所需行
預處理轉儲頻繁存取、資料固定匯入資料庫或 SQLite、建立索引
背景轉換使用者上傳 CSVQueue 處理、WebSocket 通知完成

安全性檢查清單

  • ✅ htmlspecialchars() 防 XSS
  • ✅ 檔案路徑驗證,防目錄遍歷(../)
  • ✅ 檔案大小限制,防 DoS
  • ✅ 編碼檢測與轉換(mb_detect_encoding())
  • ✅ CSV 注入防護:以 \t 或空白開頭的儲存格可能被試算表執行

CSV 注入防護範例

<?php
function sanitizeCsvCell(string $value): string {
    // 危險字元開頭:= + - @ | %
    if (preg_match('/^[\=\+\-\@\|%]/', $value)) {
        return "'" . $value; // 前加單引號中性化
    }
    return $value;
}

// 輸出時
$cell = sanitizeCsvCell($cell);
$cell = htmlspecialchars($cell, ENT_QUOTES, 'UTF-8');
?>

總結

PHP 讀取 CSV 輸出 HTML 表格的核心在於 fgetcsv() 逐行解析與 htmlspecialchars() 安全輸出。實務上應根據資料量選擇渲染策略,並注意編碼、安全性、使用者體驗(分頁/排序/搜尋)等面向。大型專案建議引入成熟前端表格庫(DataTables、AG Grid)配合後端 API 分頁,獲得最佳效能與功能平衡。

copyright © 萬盛學電腦網 all rights reserved