在Windows系統下使用PHP產生Word文檔的教程_php技巧

準備工作

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

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

我們然後需要去確保開發Interop應用（又被稱作PIA，優先互動組件）的庫是安裝好的。為了確保這個，我們可以開啟資源管理員，然後找到<Windows目錄>\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檔案是我們所要討論的核心部分。我先將代碼貼到下面，接下來在一步一步的進行解釋
 

<?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=neutral, PublicKeyToken=71e9bce111e9429c';$class = 'Microsoft.Office.Interop.Word.ApplicationClass'; $w = new DOTNET($assembly, $class);$w->visible = true; $fn = __DIR__ . '\\template.docx'; $d = $w->Documents->Open($fn); echo "Document opened.<br><hr>"; $flds = $d->Fields;$count = $flds->Count;echo "There are $count fields in this document.<br>";echo "<ul>";$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 "<li>Mappig field $index: $key with value $value</li>";}echo "</ul>"; echo "Mapping done!<br><hr>";echo "Printing. Please wait...<br>"; $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, PublicKeyToken=71e9bce111e9429c';$class = 'Microsoft.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:\Windows\assembly”時所展示的資訊
•     “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();

PrintOut方法有幾個選擇性參數，這裡，我們使用最簡單的格式。這將會給連結到我們Windows機器的預設印表機列印一份副本。

我們可以通過使用PrintPreview進行預覽列印。在純自動化的情景下，當然，我們直接使用PrintOut進行列印。

在退出word應用程式之前，我們還需要稍作等待，因為列印工作需要時間來完全退出後台。如果沒有delay(3)，$w->Quit將會立刻得到執行，並且列印工作立刻被終止。

最終，我們調用 $w->Quit(false) 來選擇通過我們的PHP指令碼調用關閉word應用程式。這裡提供的唯一參數是用來指明我們是否希望在退出前儲存更改。我們確實對文檔進行了更改，但是我們不希望儲存它們，因為我們希望能為其他使用者的輸入提供一份乾淨的模板。
 

當我們完成編碼之後，我們可以載入表單頁面，輸入一些內容並提交表單。下面的截圖展示了PHP指令碼的輸出，同時更新了Word文檔：

提高編碼速度並更好的理解PIA

PHP是一種弱類型的語言。一個COM對象是一種Object類型。在我們的PHP編碼過程中，在一個對象中我們無法使用代碼自動提示和完成功能，在一個Word應用，一個文檔甚至一個欄位中同樣如此。我們不知道它有哪些特性，或者它支援哪些方法。

這將大幅度的降低我們開發的速度。為了使開發更快，首先，我建議我們在c#中開發功能應當遷移至我們的PHP編碼。我推薦一款免費的C# IDE 叫做"#develop"，你可以在這裡下載。相比VS，我更喜歡這一款軟體，因為#develop體積更小，更簡潔，響應更快。

C#代碼遷移至PHP一點也不嚇人。先讓我展示一些C#的代碼：
 

複製代碼 代碼如下:

Word.Application w=new Word.Application();
w.Visible=true;
            
String path=Application.StartupPath+"\\template.docx";
            
Word.Document d=w.Documents.Open(path) as Word.Document;
            
Word.Fields flds=d.Fields;
int len=flds.Count;
            
foreach (Word.Field f in flds)
{
    f.Select();
    int i=f.Index;
    w.Selection.TypeText("...");
}

我們可以看到，C#的代碼和我們之前展示的PHP的代碼基礎一模一樣。由於C#是一種強型別語言，所以我們可以看到有些類型轉換的語句，我們不得不顯性的給我們的變數賦一種類型。

有了代碼的類型，我們可以盡情的享受代碼的自動提示和代碼自動完成功能，這樣我們開發的速度將有大幅度提高。

另一種可以給予我們更快速度進行PHP開發的方式是使用Word的宏命令。我們先操作一遍我們需要重複的動作，然後用一個宏將其錄製下來。一個宏其實是Visual Basic，同樣也可以非常容易的翻譯成PHP。

最重要的是，Office PIA微軟官方文檔，特別是文檔中對於每個Office應用的命名空間，總會是我們所需要的最想進的參考。比較常用的3個應用如下：

•     Excel 2013：http://msdn.microsoft.com/en-us/library/microsoft.office.interop.excel(v=office.15).aspx
•     Word 2013：http://msdn.microsoft.com/en-us/library/microsoft.office.interop.word(v=office.15).aspx
•     PowerPoint2013：http://msdn.microsoft.com/en-us/library/microsoft.office.interop.powerpoint(v=office.15).aspx

結語

在這篇文章中，我們示範了如何使用PHP COM庫和Microsoft Office Interop功能來倩影一個Word文檔。

Windows和Office在我們的日常生活中可以說是被廣泛的使用。能夠知道和瞭解Office或者Windows的強大之處還有PHP，對於任何一個在Windows平台上進行PHP開發的程式員都是十分必要的。

使用PHP的COM擴充，掌握這一組合的大門就被開啟了。

如果你對於這部分的編程比較感興趣，請留下你的評論，我們將會考慮在這個話題上寫更多的文章。我十分期待更多現實生活的應用開發能使用這種方式。