郵件合并允許你從單一模板和結構化數據源生成文檔（可能會是大量文檔），這可以用于生成業務報表、采購訂單、收據、目錄、存貨清單和發票等。

Aspose.Words for Cloud Mail Merge 讓你能夠從模板和任何語言（包括.NET、Java、PHP、Ruby、Rails、Python、jQuery等等）的XML中生成文檔。你可以通過支持REST的任意語言或平臺來使用它（幾乎所有平臺和語言都支持REST并提供原生REST客戶端來處理REST APIs）。

本文主要講述PHP中的郵件合并。要想執行郵件合并，你需要上傳一個模板到Aspose for Cloud或任意第三方存儲，然后發送一封郵件申請（在主體上傳送XML數據）以生產基于模板和數據的文檔。如下步驟描述了具體過程。

決定執行什么類型的郵件合并

Aspose.Words for Cloud 支持簡單郵件合并和帶區域的郵件合并。如果你想要插入簡單或無重復數據，比如名稱、地址和代碼字段在信封上，或到信中的字段，則可以使用簡單郵件合并（也叫做不帶區域的郵件合并）。

準備一個模板

為了準備模板來執行簡單郵件合并（不帶區域，類似于MS Word上可用的經典郵件合并），插入一個或更多合并字段到你想要填充來自數據源的數據的地方。

對于動態增長部分的文檔，使用帶區域合并。指定一個文檔中的郵件合并區域，插入兩個郵件合并字段來標記郵件合并區域的開始和結束）。郵件合并區域中的所有文檔內容都自動重復（為數據源中的每個記錄）。

格式XML

如果你想要執行簡單郵件合并，而且在Word文檔中沒有«TableStart:TableName»«TableEnd:TableName»類合并字段，就在請求主體中用如下XML結構來發送：

&lt?xml version="1.0" encoding="utf-8" ?>
  &ltCollectionName>
      &ltfield1>Value1&lt/field1>
      &ltfield2>Value2&lt/field2>
  &lt/CollectionName>

注意：你可以在XML中為CollectionName選擇任意文本，但字段名稱必須匹配Word文檔中合并字段的名稱。

當合并郵件是在«TableStart:TableName»«TableEnd:TableName» 區域內時執行帶區域的郵件合并，就在請求主體中用如下XML結構來發送：

&lt?xml version="1.0" encoding="utf-8"?>
  &ltCollectionName xmlns:xsi="//www.w3.org/2001/XMLSchema-instance">
      &ltItemName>
          &ltfield1>Value1&lt/field1>
          &ltfield2>Value2&lt/field2>
      &lt/ItemName>
      &ltItemName>
          &ltfield1>Value1&lt/field1>
          &ltfield2>Value2&lt/field2>
      &lt/ItemName>
&lt/CollectionName>

注意：你可以在XML中為CollectionName選擇任意文本，但ItemName 必須匹配TableStart 和TableEnd區域名稱。比如本例中的，«TableStart:ItemName»«TableEnd:ItemName»）并且字段名稱必須匹配Word文檔中的合并字段名稱。

使用PHP REST郵件合并

在你執行郵件合并之前，你需要上傳你的模板Word文件和XML數據到Aspose for Cloud或任意第三方存儲。

一旦你上傳模板和XML，你就可以用如下URI來執行郵件合并：

在上述URI中有幾個可選參數供你使用。依據你的需求，可以用到所有的或特定的參數。以下是這些可選參數的細節：

• withRegions：如果你想要執行帶區域郵件合并，這個參數可以被設置為ture。請看Section 1的完整代碼。
• mailMergeDataFile：這個參數可以設置來指定XML數據文件。請看Section 1的完整代碼。
• cleanup：這個參數可以設置來指定不同的cleanp選項，比如，移除空的段落、未使用的字段和控的表格等等。請看Section 1的完整代碼。
• filename：這個參數可以用來指定作為郵件合并最終結果而生成的文件名稱。
• storage：這個參數可以用來設置存儲名稱，如果你用的是第三方存儲的話。
• folder：這個參數用來設置模板文件上傳的名稱/路徑。

在構建URI之后，完成如下步驟：

• 設置App SID 和App Key并簽署URI。請看Section 2的完整代碼。
• 發送一封郵件到Aspose for Cloud Service。請看Section 3的完整代碼。
• 從響應流中獲得輸出文件名稱。請看Section 4的完整代碼。

完整代碼如下：

/**** Section 1 ****/
// Build URI to execute mail merge  $strURI = '//api.aspose.com/v1.1/words/Sample.docx/executeMailMerge?withRegions=true&mailMergeDataFile=Data.xml';
// Use the following URI if you want to remove EmptyParagraphs,UnusedRegions,UnusedFields and ContainingFields during mail merge  // $strURI = '//api.aspose.com/v1.1/words/Sample.docx/executeMailMerge?mailMergeDataFile=Data.xml&cleanup=EmptyParagraphs,UnusedRegions,UnusedFields,ContainingFields';
/**** End Section 1 ****/
/**** Section 2 ****/
$appSID  = "77****-****-****-****-80*********";  
$appKey = "****************";
// Sign URI
$signedURI = Sign($strURI, $appSID, $appKey);
/**** End Section 2 ****/
/**** Section 3 ****/
$responseStream = ProcessCommand($signedURI, "POST", "", "");
/**** End Section 3 ****/
/**** Section 4 ****/
$json = json_decode($responseStream);
//build URI to download output DOC
$outputFileName = $json->Document->FileName;
/**** End Section 4 ****/

在執行郵件合并之后，你可以通過跟隨如下實例下載輸出文件。

用PHP SDK進行郵件合并

如果你想要使用PHP SDK來執行郵件合并，你可以下載。

為了使用PHP SDK，你需要執行如下步驟：

• 設置基本產品URI、App SID和App Key。請看Section 1的完整代碼。
• 設置輸出地點、輸出文件名稱和輸出XML。請看Section 2的完整代碼。
• 上傳輸入文件。請看Section 3的完整代碼。
• 創建MailMessage類的對象并為簡單郵件合并和executeMailMergeWithRegions方式調用executeMailMessage方式。請看Section 4的完整代碼。

完整代碼如下：

/**** Section 1 ****/
// Specify product URI Product::$baseProductUri = "//api.aspose.com/v1.1"; //sepcify App SID AsposeApp::$appSID = "xxxxxxxxxxxxxxxxxxxxxxxx"; //sepcify App Key AsposeApp::$appKey = "xxxxxxxxxxxxxxxxxxxxxxxx";
/**** End Section 1 ****/
try{
/**** Section 2 ****/
AsposeApp::$outPutLocation = getcwd() . "/Output/";   $mainDocumentFile = getcwd() . "/Input/SimpleMerge.doc";   $mainDocument = basename($mainDocumentFile);   $xml = simplexml_load_file(getcwd() . "/Input/SimpleMerge.xml");
/**** End Section 2 ****/
/**** Section 3 ****/
//upload main document   echo "Uploading main document...<br />";   $folder = new Folder();   $folder->uploadFile($mainDocumentFile, "");   echo "Main document uploaded <br />";
/**** End Section 3 ****/
/**** Section 4 ****/
echo "Executing mail merge... <br />";   //create MailMerge object   $doc = new MailMerge();   $result = $doc->executeMailMerge($mainDocument, $xml->asXML());
/**** End Section 4 ****/ }
catch (Exception $e)
    {
      throw new Exception($e->getMessage());
    }