Xoops模組開發->用PHPExcel套件匯出Mysql資料表內容存成Excel檔的方法-教學撰寫:徐嘉裕Neil hsu

所謂有近就有出，PHPExcel套件既然能讀取Excel檔寫入Mysql資料表中，那當然也能吧Mysql資料表中的內容匯出成Excel檔，這部分還是要感謝tad吳弘凱老師在出版的【實戰PHP7】一書所提到的PHPExcel套件匯出Mysql資料表使用方法，我只是吧他應用在Xoops模組開發上，寫了一個工作心得紀錄以方便日後查詢，有需要的朋友可以參考看看或是可以去買那本書有更詳盡的匯出格式排版教學。

1、於模組根目錄建立一個excel.php檔，(很重要)這支檔必須為獨立運作檔，不能由後台ui介面程式include引入，這樣會連同模組後台的佈景的檔頭表頭一起執行，導致匯出的.xls檔編碼格式全部出錯(如下圖)，所以excel.php檔一定要用連結方式開啟，不能作成function然後同頁面呼叫這樣會出錯的。

2、於excel.php檔中引入以下檔案

/*-----------引入檔案區--------------*/
include_once "header.php";
require_once TADTOOLS_PATH . '/PHPExcel.php'; //引入 PHPExcel 物件庫
require_once TADTOOLS_PATH . '/PHPExcel/IOFactory.php'; //引入 PHPExcel_IOFactory 物件庫

備註說明：header.php中必須要有引入mainfile.php及tad_function.php這兩支檔才行，這樣資料庫語法及語言檔跟TADTOOLS變數才能使用，如果您的header.php中沒有引入這兩支檔，請加上以下的引入語法。

include_once "../../mainfile.php";  //一定要引入的XOOPS網站設定檔

include_once XOOPS_ROOT_PATH."/modules/tadtools/tad_function.php"; //引入TadTools的函式庫

3、於excel.php檔中貼上以下的PHPExcel套件匯出Mysql資料表為Excel檔的程式CODE

$objPHPExcel = new PHPExcel(); //實體化Excel
//----------內容-----------//
//接收變數
$excel_id=isset($_REQUEST['excel_id'])?$_REQUEST['excel_id']:"";
$excelsplit=preg_split('/,/',$excel_id); //正規表達式比對,切割成陣列

//$excelsplit[0]為資料庫查詢的欄位數值ID

//$excelsplit[1]做為檔案檔名用標題文字

$title=$excelsplit[1]; //標題

$objPHPExcel->setActiveSheetIndex(0); //設定預設顯示的工作表
$objActSheet = $objPHPExcel->getActiveSheet(); //指定預設工作表為 $objActSheet
$objActSheet->setTitle($title); //設定標題
$objPHPExcel->createSheet(); //建立新的工作表

//設定欄位字形及文字大小
$objPHPExcel->getDefaultStyle()->getFont()->setName('Microsoft JhengHei')->setSize(12);


//設定欄位預設寬度
$objActSheet->getColumnDimension('A')->setWidth(15);
$objActSheet->getColumnDimension('B')->setWidth(15);
$objActSheet->getColumnDimension('C')->setWidth(15);
$objActSheet->getColumnDimension('D')->setWidth(15);
$objActSheet->getColumnDimension('E')->setWidth(15);


//設定欄位文字顏色跟區塊底色
$objActSheet->getStyle('A1:E1')->getFill()->setFillType(PHPExcel_Style_Fill::FILL_SOLID)->getStartColor()->setRGB('6D6D6D');
$objActSheet->getStyle('A1:E1')->getFont()->setBold(false)->getColor()->setARGB('00FFFFFF');
$objActSheet->getStyle('A1:E1')->getAlignment()->setHorizontal(PHPExcel_Style_Alignment::HORIZONTAL_CENTER); //表頭置中


//Exce表頭區
$objActSheet
->setCellValue("A1", _MD_EXCELCLASS1)
->setCellValue("B1", _MD_EXCELCLASS2)
->setCellValue("C1", _MD_EXCELCLASS3)
->setCellValue("D1", _MD_EXCELCLASS4)
->setCellValue("E1", _MD_EXCELCLASS5);


/*=========資料庫語法================*/
global $xoopsDB;  //需要global物件

$i = 2; //扣除表頭由第二回圈開始寫入資料表內容

$sql = "select * from " . $xoopsDB->prefix('neilstudentinformation') . " where `student_class_id` = '$excelsplit[0]' order by student_id DESC";
$result = $xoopsDB->query($sql) or redirect_header($_SERVER['PHP_SELF'],3, mysql_error());
while(list($student_id,$student_name,$student_grade,$student_number,$student_seatnumber,$student_class_name,$student_class_id) = $xoopsDB -> fetchRow($result)){ 

 
$objActSheet->getStyle("A{$i}:E{$i}")->getAlignment()->setHorizontal(PHPExcel_Style_Alignment::HORIZONTAL_CENTER); //表格全部置中

//資料存入Exce欄位
$objActSheet->setCellValue("A{$i}", $student_name)
->setCellValue("B{$i}", $student_grade)
->setCellValue("C{$i}", $student_number)
->setCellValue("D{$i}", $student_seatnumber)
->setCellValue("E{$i}", $student_class_name);
$i++; 

}

//Exce做檔名

$class_excelname=date("Y-m-d-H-i-s");  //以時間為檔名前綴
$title=$class_excelname.$title._MD_EXCELCLASS6;
$title = (_CHARSET == 'UTF-8') ? iconv("UTF-8", "Big5", $title) : $title;

//編碼格式設定
header('Content-Type: application/vnd.ms-excel');
header("Content-Disposition: attachment;filename={$title}.xls");
header('Cache-Control: max-age=0');

//輸出Excel檔案版本
$objWriter = PHPExcel_IOFactory::createWriter($objPHPExcel, 'Excel5');
$objWriter->setPreCalculateFormulas(false);

//輸出檔案
$objWriter->save('php://output');
exit;

3、於模組後台UI介面做一個匯出Exce按鈕，路徑指向excel.php

<a class='btn btn-default active' href='".XOOPS_URL."/modules/模組ID/excel.php?excel_id=".$class_id.",".$class_name."''>"匯出Exce"</a>

備註說明：excel_id=".$class_id.",".$class_name."是串接兩個變數，一個$class_id為資料表查詢ID變數，$class_name則為標題作為檔案名稱用

4、於模組/language/tchinese_utf8/main.php 中置如以下的語系常數，Exce表頭所用。

define("_MD_EXCELCLASS1","學生姓名");

define("_MD_EXCELCLASS2","年級");

define("_MD_EXCELCLASS3","學號");

define("_MD_EXCELCLASS4","座號");

define("_MD_EXCELCLASS5","班級名稱");

define("_MD_EXCELCLASS6","學生資料");

這樣就完成了，實際來測試看看!!

預計要匯出資料表裡面的三年一班共4筆資料

點選UI介面的匯出Exce按鈕，並儲存檔案

儲存的檔名顯示【2017-11-05-19-25-08三年一班學生資料.xls】的確有帶到以日期作為前綴的檔名

接者開啟Excel檔看內容是否都有匯出!

資料表中的4筆三年一班資料內容都有寫入Excel檔了，格式也置中，表頭也加底色，這樣就完成整個匯出操作，可以收工吃晚飯了~(餓)。

教學撰寫：徐嘉裕 Neil hsu