智慧防疫物資管理系統：通報

前一篇文章提到，我們將三到四個月的資料匯出後使用已通報資料庫篩選比對，形成真的需要通報的資料，並存回已通報資料庫。

以目前的通報數量來說，每天最少通報 1 筆，最多則有 98 筆，想當然爾無法逐筆輸入疾管署智慧防疫物資管理系統提供的網頁表單，還好網站提供多筆批次匯入的方法。

因為目前網站只接受 xlsx 格式，所以接下來我們要利用 php 把資料庫中的資料存成 xlsx 檔，下載後利用網站上的表單上傳網頁。

流程規劃

需要通報的資料在完成通報存回資料庫時，會利用 insertdate 欄位註記資料存進資料庫的時間，因此只要利用該欄位，即可把當天或某一天需要通報的資料查詢出來。

在智慧防疫物資管理系統中，又另外把藥品分成三大類，同一大類的藥品可以寫在同一個 Excel 檔中進行通報。但因為對於藥品管理而言，我們是直接以藥品名稱區分資料，因此分類的部分並不會存在資料庫裡，而且直接在 php 存成陣列處理。

<?php
// 智慧防疫物資管理系統的分類
$smis_category = [
    "流感抗病毒藥劑" => ["Tamiflu", "Eraflu", "Oseltamivir", "Relenza"],
    "防疫藥品器材" => ["Evusheld", "Remdesivir"],
    "新興傳染病用藥" =>  ["Paxlovid", "Molnupiravir"]
];

程式規劃的部分，會將生成 xlsx 檔案的程式獨立出來，可以單獨一個 php 頁面，或是直接作在資料比對介面上也可以，當程式接到變數 insertdate 和剛剛的大分類 category 時，便會自動下載 xlsx 檔案：

flowchart LR
    A("資料比對介面.php") --> B[["變數：\ninsertdate\ncategory"]]
    style B text-align:left
    B-->C("Excel 下載頁面.php")
    C<-.->|資料存取|D[("已通報資料庫")]
    C-->E(("Excel 檔案.xlsx"))

程式可以這樣寫：

// 取得 "insertdate" 和 "category" 的 URL 變數
$insertdate = $_GET["insertdate"];
$sql = "SELECT * FROM `smis` WHERE `insertdate` = '$insertdate'";
if ((isset($_GET["category"]))&&($_GET["category"]!="")) {

    $category = $_GET["category"];

    if ($category=="新興傳染病用藥") {
        $sql .= " AND (`medicine` = 'Paxlovid' OR `medicine` = 'Molnupiravir')";
    } elseif ($category=="防疫藥品器材") {
        $sql .= " AND (`medicine` = 'Remdesivir' OR `medicine` = 'Evusheld')";
    } elseif ($category=="流感抗病毒藥劑") {
        $sql .= " AND (`medicine` = 'Tamiflu' OR `medicine` = 'Eraflu' OR `medicine` = 'Relenza')";
    }
}

// 查詢資料庫取得資料陣列
$dsn = "mysql:host=伺服器位置;dbname=資料庫名稱;charset=utf8";
$conn_user = "帳號";
$conn_pwd = "密碼";
$conn = new PDO($dsn, $conn_user, $conn_pwd);
$conn -> exec("SET NAMES utf8");
$records = $conn->query($sql)->fetchAll(PDO::FETCH_ASSOC);

直接在瀏覽器中顯示並下載

利用 sql 查詢出資料之後，就可以迭代資料陣列開始製作 xlsx 檔，最簡單的寫法是以 \t 當作欄位分隔線， \n 換行，直接將內容以字串的方式寫在同一個 php 變數中後，最後使用 exit() 方法印在瀏覽器上，再加入 Content-type 和 Content-Disposition 讓瀏覽器知道內容是附件，必須下載：

// 欄位名稱：欄位會因為 category 不同而有變更
$excel = "姓名\t出生年月日YYYY/MM/DD\t身分證字號\t給藥日期YYYY/MM/DD\t投藥劑量\t物資項目代碼\t批號\t用藥對象\n";

// 迭代資料
foreach ($records as $record) {
    // 利用 .= 延長字串
    $excel .= $record["ptname"]."\t";
    $excel .= date("Y/m/d", strtotime($record["ptbirth"]))."\t";
    $excel .= $record["ptid"]."\t";
    $excel .= $record["reportdate"]."\t";
    $excel .= $record["quantity"]."\t";
    $excel .= "\t";
    $excel .= "\t";
    $excel .= "\t";
    $excel .= "\n";
}

// 下載成 Excel 檔
header("Content-type: application/vnd.ms-excel");
header("Content-Disposition: attachment; filename=.xlsx");
exit($excel);

然而利用瀏覽器直接下載的方法，會依照欄位既有的字串由 Excel 自行判斷欄位的格式，也就是說日期的欄位雖然是 YYYY/MM/DD ， Excel 軟體可能判斷為日期或字串，因此在上傳到智慧防疫物資管理系統時就會因為格式不相符而被系統拒絕。

使用套件製作 xlsx 檔案

為了避免 Excel 軟體幫我們決定格式，比較好的方法是製作 xlsx 檔案的時候就要指定格式，但是單純用字串完成整個檔案再經瀏覽器下載的方式並無法操作格式轉換等精細複雜的操作，因此需要利用 php 的套件 (packages) 來幫忙我們完成。

安裝 Composer

什麼是 php 的套件？舉個例子，當我們使用 Python 需要更進階的操作或是方法時，會去找尋函式庫並且引入，例如如果需要操作數據列表就會想到 pandas 、製作圖像或分析圖像就會想到 PIL 、或甚至要操作鍵盤滑鼠要用到的 pyAutoGUI 等等，為了使用這些函式庫，我們會在終端機使用指令將函式庫下載並安裝完成：

pip install pandas
pip install Pillow
pip install pyAutoGUI
...

接著在 py 程式裡面使用以下程式引入安裝好的函式庫：

import pandas as pd
from PIL import Image
import pyautogui

php 也一樣具有安裝函式庫及引入函式庫的方法，不過在 php 中稱為套件，而相對於 pip ， php 管理、下載、安裝套件的軟體就是 Composer ，不過 php 不像 python 一開始安裝就先把 pip 包含在 python 的安裝檔之中，所以我們必須到 Composer 的官方網站去下載軟體並且安裝，我的環境是 Windows 就直接使用 Windows Installer 即可。

安裝過程中要告訴 Installer php.exe 的位置，以我使用 xampp 的開發環境來說，位置通常在 安裝目錄\xampp\php\ 底下。不過使用 Windows 安裝 php 的時候，大部分預設會將 php.exe 存在的目錄加入環境變數，所以 Installer 通常都可以自己找到。

安裝完畢之後可以在 cmd 或 powershell 等 CLI 視窗中輸入 composer 來確認是否有安裝成功，如果出現了以下的歡迎畫面，表示安裝成功了：

   ______
  / ____/___  ____ ___  ____  ____  ________  _____
 / /   / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
/ /___/ /_/ / / / / / / /_/ / /_/ (__  )  __/ /
\____/\____/_/ /_/ /_/ .___/\____/____/\___/_/
                    /_/
Composer version 2.6.5 2023-10-06 10:11:52

安裝套件 phpoffice/phpspreadsheet

接著需要安裝套件，因為開發環境的關係，通常不會像 python 直接以 pip install 的方式安裝在全域 (電腦主機) 裡面，而是伺服器根目錄底下另外開資料夾，然後在該資料夾中安裝套件。例如：

.
├─ smisdl
│   └─ smisdl.php 
├─ 其他網頁
│
...

在瀏覽器中輸入 http://localhost/smisdl/smisdl.php 便可以指向該網頁。

php 的主流框架 Laravel 亦可以利用 composer 安裝，就會使用全域安裝的方式讓 CLI 可以直接下 laravel 的指令。而現在 Laravel 官網建議使用 Docker Desktop ，這又是另外一件事了。

在 smisdl 資料夾底下新增一個 composer.json 檔案，告訴 composer 這個資料夾底下要安裝的套件名稱：

{
    "require": {
        "phpoffice/phpspreadsheet": "^1.29"
    }
}

在 cmd 或 powershell 等 CLI 視窗利用指令 cd 將目前工作路徑移動到該資料夾，並輸入 composer 安裝的指令 composer install ：

C:\> cd C:\網頁根目錄\smisdl
C:\網頁根目錄\smisdl> composer install

這一個指令會去尋找目錄底下的 composer.json 檔案，並安裝檔案中的套件，安裝結束後可以看到資料夾底下多了一個 composer.lock 以及一個 vendor 資料夾，表示已經成功安裝套件。

另外也可以不新增 composer.json ，直接在目錄底下輸入：

C:\網頁根目錄\smisdl> composer require phpoffice/phpspreadsheet

也可以達到一樣的效果，~~只是字很長我很懶~~。

使用套件

接著在 php 網頁中引入套件，就像是 python 裡面的 import ，不過要引入的東西可能要參考各套件的說明：

<?php
require "vendor/autoload.php";
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;

唯一不會變的都是第一行的 require "vendor/autoload.php"; ，意思是這個 php 接下來的 use 都要參考 autoload.php 把套件 load 進來。接著才會 use 引入套件的物件 (object) 或類別 (class) 。

跟瀏覽器直接下載一樣先將資料查詢出來：

// 取得 "insertdate" 和 "category" 的 URL 變數
$insertdate = $_GET["insertdate"];
$sql = "SELECT * FROM `smis` WHERE `insertdate` = '$insertdate'";
if ((isset($_GET["category"]))&&($_GET["category"]!="")) {

    $category = $_GET["category"];

    if ($category=="新興傳染病用藥") {
        $sql .= " AND (`medicine` = 'Paxlovid' OR `medicine` = 'Molnupiravir')";
    } elseif ($category=="防疫藥品器材") {
        $sql .= " AND (`medicine` = 'Remdesivir' OR `medicine` = 'Evusheld')";
    } elseif ($category=="流感抗病毒藥劑") {
        $sql .= " AND (`medicine` = 'Tamiflu' OR `medicine` = 'Eraflu' OR `medicine` = 'Relenza')";
    }
}

// 查詢資料庫取得資料陣列
$dsn = "mysql:host=伺服器位置;dbname=資料庫名稱;charset=utf8";
$conn_user = "帳號";
$conn_pwd = "密碼";
$conn = new PDO($dsn, $conn_user, $conn_pwd);
$conn -> exec("SET NAMES utf8");
$records = $conn->query($sql)->fetchAll(PDO::FETCH_ASSOC);

開始製作 xlsx 檔案，首先是整個檔案的設定：

$spreadsheet = new Spreadsheet();
$spreadsheet->getDefaultStyle()->getFont()->setName("微軟正黑體");
$spreadsheet->getDefaultStyle()->getFont()->setSize(12);
//設定預設字體與字體大小
$spreadsheet->getDefaultStyle()->getNumberFormat()->setFormatCode("@");
//設定每一個儲存格為通用格式 @

再來是建立工作頁 (Work Sheet) ，並編輯內容：

$sheet = $spreadsheet->getActiveSheet()->setTitle("用藥個案");
//工作頁頁籤名稱
$sheet->setCellValue("A1", "姓名");
//在指定的儲存格 A1 輸入文字：姓名
$sheet->setCellValue("F1", "給藥日期\nYYYY/MM/DD");
...
// 可以利用跳脫字元 \n 來達到儲存格內換行的效果
foreach ($records as $key=>$value) {
    $row = $key+2;
    $sheet->setCellValueByColumnAndRow(1, $row, $value["ptname"]);
    //如果無法指定為 A1 這種英文 + 數字的格式，可以利用這個方法指定 Column 和 Row 序數的儲存格中輸入文字
    ...
}

最後利用 new Xlsx() 將物件寫入 xlsx 檔案，並且暫存在伺服器之中。但是我們的目的是要下載這個檔案，所以還是會利用 header("Content-Disposition:...") 的方式來下載剛剛存起來的 xlsx 檔，並且利用 php unlink() 刪除存在伺服器中的暫存檔：

$writer = new Xlsx($spreadsheet);
$writer->save($filename);
//套件儲存檔案
$content = file_get_contents($filename);
header("Content-Disposition: attachment; filename=".$filename);
unlink($filename);
exit($content);
//瀏覽器下載檔案

如此就可以完成，當這個頁面接到兩個參數時，產生事先指定每一儲存格格式的 xlsx 檔。另外套件也能作到指定每一儲存格的大小、顏色格式、文字對齊、框線、合併儲存格等等，甚至可以直接在儲存格裡面輸入 Excel 的公式結果，十分強大。只是這邊就沒有這種需求了，如果有需要的需要多翻一下套件的說明，不過說明其實滿簡陋的，就只能多 google 。

phpspreadsheet 的前身名為 phpExcel ，程式的部分應該都是相通的，可以試試看。

為什麼還要手動匯入？

flowchart LR
    A(("Excel 檔案.xlsx"))-->|自動上傳|B("智慧防疫物資管理系統")

下載了檔案，最後一定會想要自動化上傳到智慧防疫物資管理系統，畢竟以使用者體驗來看，同一個頁面可以直接完成的作業，一定遠遠勝過還要再開第二或第三頁面；與其按下按鈕下載檔案，不如按下按鈕直接通報。

雖然是這樣想，但是疾病管制署的網頁是利用醫事人員晶片卡登入，於是該機構的網站外包商要求使用者電腦必須額外安裝系統讀卡元件，接著使用讀卡機設備讀取晶片卡、輸入認證碼後才能完成登入。

依我目前的技術，還無法做到直接用 php 或 python 自動化這些步驟，可能也有些認證的方法需要破解，就留給未來的我吧。

流程規劃#

直接在瀏覽器中顯示並下載#

使用套件製作 xlsx 檔案#

安裝 Composer#

安裝套件 phpoffice/phpspreadsheet#

使用套件#

為什麼還要手動匯入？#