ป้ายกำกับ: เทมเพลต

เพราะว่า word นั้นมีความสามารถปรับแต่งรูปแบบได้ซับซ้อนมากกว่า excel อยู่มาก อย่างน้อยแค่ตำแหน่งของส่วนต่าง ๆ ในแบบฟอร์มก็มีมากกว่า excel ที่เลือกตำแหน่งได้แค่ว่าจะใส่ column / row ไหน

การใช้ PHP สร้างไฟล์ word ขึ้นมาการสร้างไฟล์แม่แบบขึ้นก่อน โดยการสร้างตัว word template ขึ้นมาก่อนโดยใช้โปรแกรม Microsoft Word สร้างเอกสารไปตามปกติ จึงง่ายกว่า จากนั้นก็แก้เพียงแต่ในส่วนที่่ต้องการจะแทนค่าให้ใส่ ${key name} ลงไป หรือส่วนที่ต้องการ repeat ก็เพิ่ม ${key name} … ${/key name} เข้าไปเท่านั้นจะง่ายกว่า ไฟล์ในตัวอย่างนี้สามารถโหลดได้จาก template.docx
จากนั้นก็เขียน code
PHPWord/template.php

<?php
ini_set ('max_execution_time', 0) ;
ini_set ('memory_limit', '-1') ;
 
include '../vendor/autoload.php';
 
use PhpOffice\PhpWord;
 
$title = 'Template Render ' . date ('Y-m-d H:i:s') ;
 
/* load template */
$templateProcessor = new \PhpOffice\PhpWord\TemplateProcessor ('template.docx') ;
 
/* fill data */
$templateProcessor->setValue ('header', $title) ;
 
/* random data */
$scores = [];
for ($a = 0; $a < 10; $a++) {
 $scores[$a + 1] = rand (0, 100) ;
}
 
/* clone table row and fill */
$templateProcessor->cloneRow ('student_id', count ($scores)) ;
foreach ($scores as $key => $value) {
 $templateProcessor->setValue ('score#' . $key, htmlspecialchars ($value, ENT_COMPAT, 'UTF-8')) ;
 $templateProcessor->setValue ('student_id#' . $key, htmlspecialchars ($key, ENT_COMPAT, 'UTF-8')) ;
}
 
/* clone all block */
$templateProcessor->cloneBlock ('repeater', 5) ;
 
header ("Content-Description: File Transfer") ;
header ('Content-Disposition: attachment; filename="' . $title . '.docx"') ;
header ('Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document') ;
header ('Content-Transfer-Encoding: binary') ;
header ('Cache-Control: must-revalidate, post-check=0, pre-check=0') ;
header ('Expires: 0') ;
$templateProcessor->saveAs ('php://output') ;

อธิบาย code

• การทำงานโดยจะโหลด ตัว PHPWord มาใช้ก่อน จะสังเกตว่าจะมีการใช้ namespaces แทนที่จะใช้ include เข้ามาเหมือน PHPExcel
• กำหนดจุดที่จะกรอกข้อมูลโดยใส่ ${key name} ใน word เช่น ${header} จากนั้นใน PHP ก็ส่งค่าตัวแปรไปแทนที่โดยใช้
  fill data to template

  $templateProcessor->setValue ('header', $title) ;
  

• สามารถ repeat ตารางได้โดยการใส่ ${key name} ใน column ที่ต้องการคัดลอกแถวทั้งแถว เช่น ${student_id} และสั่งให้คัดลอกแถวโดยใช้
  clone row

  $templateProcessor->cloneRow ('student_id', จำนวนครั้ง) ;
  

• สามารถเติมช้อมูลให้คอลัมน์ที่เพิ่มมาใหม่นี้โดยใช้เพิ่มขึ้นมาเพิื่อจะแทนที่ลำดับที่เพิ่มขึ้นมานั่นเอง
  fill array to template

  foreach ($scores as $key => $value) {
   $templateProcessor->setValue ('score#' . $key, htmlspecialchars ($value, ENT_COMPAT, 'UTF-8')) ;
   $templateProcessor->setValue ('student_id#' . $key, htmlspecialchars ($key, ENT_COMPAT, 'UTF-8')) ;
  }
  

  
  สังเกตว่ามี
  เพิ่มขึ้นมาเพื่อจะแทนที่ลำดับที่เพิ่มขึ้นมานั่นเอง
  

  #' . $key
  

• ในรูปแบบตารางที่ซับซ้อน เช่น ตาราง “ใบขออนุญาตสอบซ่อม” ที่ต้องทำซ้ำหลายแถวและหลายคอลัมน์พร้อม ๆ กัน ทั้งตารางจะไม่สามารถใช้
  clone row

  $templateProcessor->cloneBlock ('repeater', จำนวนครั้ง) ;
  

  แทน แต่จะไม่สามารถใส่ตัวแปรลงไปแทนที่ได้ใน version นี้