將 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 = "<?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
// 略...
}
}
?>
<!-- HTML -->
| 策略 | 適用場景 | 實作要點 |
|---|---|---|
| 串流輸出 | 超大檔(>100MB) | 分塊讀取、分塊輸出、避免載入全部記憶體 |
| 分頁載入 | 中型檔、需互動 | AJAX 分頁、後端只讀取所需行 |
| 預處理轉儲 | 頻繁存取、資料固定 | 匯入資料庫或 SQLite、建立索引 |
| 背景轉換 | 使用者上傳 CSV | Queue 處理、WebSocket 通知完成 |
htmlspecialchars() 防 XSS../)mb_detect_encoding())\t 或空白開頭的儲存格可能被試算表執行<?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 分頁,獲得最佳效能與功能平衡。