在Windows系統下使用PHP產生Word文件的教學課程

準備工作

首先，請確保在你的Windows系統中已經安裝並設定好了典型的WAMP環境。由於Interop純粹是Windows的特性，我們將在Windows平台下建置Apache和PHP。在這個實例中，我使用了EasyPHP 14.1，而這款軟體安裝和設定都十分容易。

接下來，我們要安裝Microsoft Office。版本不是嚴格要求的。我正在使用的是Office2013專業版，但是任何2007之後的Office版本都應該可以使用。

我們接著需要去確保開發Interop應用（又被稱為PIA，優先互動元件）的函式庫是安裝好的。為了確保這個，我們可以打開資源管理器，然後找到assembly，我們將會看到下面安裝好的PIAs分支：

我們可以看到一個 Microsoft.Office.Interop.Word 條目（在這個截圖中有底線）。 這就是我們在這個範例中將要使用的 PIA。請特別注意它的“名稱”,“版本”和“公鑰標記”。我們將要在PHP腳本中用到它們。

在這個目錄中，我們還可以看到其它用於程式設計（不僅是PHP，還有VB.net, C#等）的PIAs（包括整個Office家族）。

如果這個清單沒有包含 Microsoft.Office.Interop 的整個包，我們可以重新安裝Office並且在安裝中包含PIA；我們也可以手動下載安裝這個包。安裝的詳細步驟可以參考這個MSDN頁面。

注意：只有Microsoft Office 2010 PIA Redistributable 可以被單獨下載安裝。這個包中的 PIA 版本是14.0.0。版本15只能透過安裝Office取得。

最後，我們需要在檔案 php.ini 中啟用 PHP 擴充功能 php_com_dotnet.dll，並且重新啟動伺服器。

現在我們可以開始程式設計了。

HTML表單

由於該demo主要關注與後台的處理，所以我們這裡就用一個簡單的HTML表單做前台的展示，看起來應該是這樣的：

我們有一個文字方塊用於輸入“Name”，一個“Gender”的單選按鈕組，一個“Age”的域值控制還有一個文字域來寫“Message”，最後，還需要一個“ Submit”按鈕。

將該文件命名為“index.html”，保存在虛擬主機的根目錄下，這樣我們可以直接透過URL存取該文件，例如：http://test/test/interop

後台

後台的PHP檔案是我們所要討論的核心部分。我先將程式碼貼到下面，接下來在一步一步的進行解釋

$inputs = $_POST;
$inputs['printdate']='';
/// A dummy value to avoid a PHP notice as we don't have "printdate" in the POST variables.

$assembly = 'Microsoft.Office.Interop.Word, Version=15.0.0.0, Culture=kenral, Culture =71e9bce111e9429c';
$class = 'Microsoft.Office.Interop.Word.ApplicationClass';

$w = new DOTNET($assembly, $class);
$w->ible =$ true;

$fn = __DIR__ . '\template.docx';

$d = $w->Documents->Open($fn);

echo " Document opened.";

$flds = $d->Fields;
$count = $flds->Count;
echo "There are $count fields in this document.";
echo "";$mapping = setupfields();
 
foreach ($flds as $index => $f)
{
 $f->Select();
 $key = $mapping[$index];
 $value = $inputs[$key];
 if ($key == 'gender')
 {
 if ($value == 'm')
 $value = 'Mr.';
 else
 $value = 'Ms.';
 }
 
 if($key=='printdate')
 $value= date ('Y-m-d H:i:s');
 
 $w->Selection->TypeText($value);
 echo "
Mappig field $index: $key with value $value";}
echo "
";

echo "Mapping done! ";
echo "Printing. Please wait...";

$d->PrintOut();
sleep(3);
 echo "Done!";

$w->Quit(false);
$w=null;



function setupfields()
{
 $mapping = array();
 $mapping[0] = 'gender';
 $mapping[1] = 'name';
 $mapping[2] = 'age';
 $mapping[3] = 'msg';
 $mapping[4] = 'printdate';


 return $mapping;
}

在設定完用來取得表單中傳過來的值的變數$inputs之後，我們要建立一個虛擬值用來存放printdate－我們稍後會討論為何需要這個變數－現在，我們看到這4行比較關鍵的程式碼：

$assembly = 'Microsoft.Office.Interop.Word, Version=15.0.0.0, Culture=neutral, PublicToken=71e9bce111e9429'Keyneutral, PublicToken=71e9bce111e9429' .Office.Interop.Word.ApplicationClass';

$w = new DOTNET($assembly, $class);
$w->visible = true;

在PHP中的COM操縱需要在一個assembly裡請求一個class的實例。在我們的案例中，我見將要操作Word。如果考慮到我們上一個截圖中展示的程式碼，我們將能夠建構出一個完整簽名的Word PIA：

“Name”，“Version”，“Public Key Token”是在當我們瀏覽“c:Windowsassembly”時所展示的資訊
「Cultrue」總是neutrual的。

呼叫類別編譯後的檔案後綴名為通常為ApplicationClass.

透過設定下面兩個步驟，我們可以初始化一個word物件：

首先，word物件可以保存在背景或透過將visible屬性設為true，使它在前台展示出來。

然後，我們打開將要處理的文檔，把它實例化為一個$d變數。

在文件物件中，基於html表單的文字來新增文件的內容，這裡可以設定一些參數。

最不好的方式是對php頁面上所有內容進行硬編碼，然後將它們新增到word物件中。我強烈建議不採用此種方式，原因有：

1 程式碼沒有彈性，php內容的任何變更都需要重新修改腳本；

2 違反了控制層、展示層的分離；
3 如果需要設定word內容的格式（對齊，字體，樣式，等），這種方式大大增加了程式碼行數，並且以程式設計的方式來修改樣式是非常麻煩的。

另一種方式是使用“搜尋-替換”。 PHP內建的這種功能非常強大。我們可以建立一個word文檔，在那些需要被替換的佔位內容周圍放置一些分隔符號。例如，我們建立一個文件包含以下內容：

{{name}}

在PHP中，我們只需使用從表單提交中取得的「Name」值來替換。這種方式避免了第一選項中的那些缺點。我們只需要找到正確的分隔符，在這個例子中，除了使用的模板是word文檔，我們更像是做一個模板渲染。

第三個選項是我的建議，並且是Word中的高級主題。我們將用網域來表示佔位符，在我們的php程式碼中，我們會直接更新了對應的表單值的欄位。

這種方法靈活，快速，符合Word的最佳實務。這也避免了文件的全文搜索，這有助於提高效能。請注意，此選項有它的缺點了。

總之，自從首次亮相，Word從來沒有支援命名索引的欄位。儘管我們對於我們在Word文件中建立的欄位提供了一個名字，我們還是要用數字下標來存取每個欄位。這也解釋了為什麼我們要使用專用的功能（setupfields）來做表單欄位的欄位索引和名稱之間的對應手冊

學習如何在word文件中插入欄位（點擊這裡查看一個客製化好的版本），請參閱相關 Word 說明主題和手冊。對於這個demo，我們有一個具備5個MERGEFIELD欄位的文件。此外，我們將文件和PHP腳本放在一個目錄下，以便於取得。

請注意，printdate欄位並沒有一個對應的窗體欄位。這就是為什麼我們要在$inputs數組中添加一個假的printdate作為key。沒有這個key，腳本仍然可以執行，但是會有提示說明$inputs數組中不存在索引printdate。

在使用表單資料更新完欄位的值之後，我們將會使用下面的指令列印文件：

$d->PrintOut();

Windows, PHP, Word