ThinkPHP를 활용한 CSV 파일 생성 및 HTML 테이블 기반 Excel 다운로드 구현

웹 애플리케이션 개발 중 데이터를 CSV나 Excel 형식으로 내보내는 기능은 매우 흔하게 사용됩니다. ThinkPHP 프레임워크를 사용할 때 파일 출력 과정에서 의도치 않은 HTML 태그나 디버그 로그가 포함되는 문제를 방지하고, 효율적으로 파일을 생성하는 방법을 정리합니다.

1. ThinkPHP에서 CSV 파일 내보내기

CSV 파일 내보내기 로직 자체는 간단하지만, ThinkPHP의 page_trace 설정이 켜져 있는 경우 파일 끝에 디버그용 HTML 코드가 삽입되어 파일이 손상되는 경우가 발생합니다. 이를 방지하기 위해 데이터를 출력한 후 반드시 exit를 호출해야 합니다.

컨트롤러 구현 (DataExportController.class.php)

<?php
namespace Home\Controller;
use Think\Controller;

class DataExportController extends Controller {

    public function downloadCsv() {
        // 데이터 조회
        $recordModel = M('ExportData');
        $list = $recordModel->field('item_name, item_value')->select();

        // CSV 헤더 설정
        $csvContent = "항목명,값\n";
        $csvContent = iconv('utf-8', 'cp949', $csvContent); // 한글 깨짐 방지 (Windows Excel 기준)

        foreach ($list as $item) {
            $name = iconv('utf-8', 'cp949', $item['item_name']);
            $value = iconv('utf-8', 'cp949', $item['item_value']);
            $csvContent .= $name . "," . $value . "\n";
        }

        $today = date('Ymd_His');
        $fileName = "report_{$today}.csv";

        // 모델을 통한 파일 전송 처리
        $model = D('FileHandler');
        $model->pushCsvDownload($fileName, $csvContent);
        
        // 중요: 추가적인 HTML 출력을 막기 위해 즉시 종료
        exit;
    }
}

모델 구현 (FileHandlerModel.class.php)

<?php
namespace Home\Model;
use Think\Model;

class FileHandlerModel extends Model {
    
    public function pushCsvDownload($filename, $content) {
        header("Content-type: text/csv");   
        header("Content-Disposition: attachment; filename=" . $filename);   
        header('Cache-Control: must-revalidate, post-check=0, pre-check=0');   
        header('Expires: 0');   
        header('Pragma: public');
        
        echo $content;
    }
}

2. HTML 테이블 구조를 이용한 Excel 파일 출력

복잡한 라이브러리 없이 HTML의 <table> 구조를 사용하여 Excel 파일을 생성할 수도 있습니다. 브라우저가 전송받은 HTML 내용을 Excel 형식으로 해석하도록 헤더를 설정하는 방식입니다.

구현 예시 (excel_export.php)

<?php
// DB 연결 및 데이터 설정 생략
$targetSiteId = isset($_GET['site_id']) ? intval($_GET['site_id']) : 0;

if ($targetSiteId > 0) {
    // Excel 출력을 위한 버퍼링 시작
    $outputBuffer = '<table border="1">';
    $outputBuffer .= '<tr><th>이메일</th><th>이름</th><th>가입일</th></tr>';

    // 가상의 데이터 루프
    $results = $db->query("SELECT email, username, created_at FROM users WHERE site_id = $targetSiteId");
    
    while ($row = $results->fetch()) {
        $outputBuffer .= '<tr>';
        $outputBuffer .= '  <td>' . $row['email'] . '</td>';
        $outputBuffer .= '  <td>' . $row['username'] . '</td>';
        $outputBuffer .= '  <td>' . $row['created_at'] . '</td>';
        $outputBuffer .= '</tr>';
    }
    $outputBuffer .= '</table>';

    // Excel 다운로드 헤더 전송
    $fileName = "user_report_" . date('Ymd') . ".xls";
    header("Content-type: application/vnd.ms-excel");
    header("Content-Disposition: attachment; filename=$fileName");
    
    echo $outputBuffer;
    
    // 프로그램 종료: 이후의 HTML 폼이나 태그가 파일에 포함되지 않도록 함
    exit;
}
?>
<!-- 다운로드 요청을 위한 UI -->
<h1>데이터 리포트 생성</h1>
<form action="excel_export.php" method="get">
    <select name="site_id">
        <option value="1">지점 A</option>
        <option value="2">지점 B</option>
    </select>
    <button type="submit">Excel 다운로드</button>
</form>

주의사항

두 방식 모두 공통적으로 가장 중요한 포인트는 데이터를 echo한 직후 exit; 명령어를 사용하는 것입니다. 프레임워크 기반의 환경에서는 메서드 실행이 끝난 뒤에도 공통 레이아웃이나 디버그 툴바, 혹은 하단 스크립트가 자동으로 붙는 경우가 많기 때문입니다. 이 명령어 하나로 순수한 데이터 파일만 추출할 수 있습니다.

태그: ThinkPHP PHP CSV Excel FileDownload

11월 10일 04:05에 게시됨