Windows システムで PHP を使用して Word ドキュメントを生成するチュートリアル

準備

まず、一般的な WAMP 環境が Windows システムにインストールされ、構成されていることを確認してください。 Interop は純粋に Windows の機能であるため、Apache と PHP を Windows プラットフォームで構築します。この例では、インストールと設定が非常に簡単な EasyPHP 14.1 を使用しました。

次に、Microsoft Officeをインストールします。バージョンは厳密には必須ではありません。 Office 2013 Professional を使用していますが、2007 以降のどのバージョンの Office でも動作するはずです。

次に、Interop アプリケーションを開発するためのライブラリ (PIA、Priority Interaction Components とも呼ばれます) がインストールされていることを確認する必要があります。これを確認するには、エクスプローラーを開いて アセンブリを見つけます。次のインストールされた PIA ブランチが表示されます。

Microsoft.Office.Interop.Word エントリが表示されます (このスクリーンショットでは下線が付いています)。 これは、この例で使用する PIA です。 「名前」、「バージョン」、「公開鍵トークン」には特に注意してください。これらを PHP スクリプトで使用します。

このディレクトリには、プログラミング (PHP だけでなく、VB.net、C# など) に使用される他の PIA (Office ファミリ全体を含む) も表示されます。

このリストに Microsoft.Office.Interop のパッケージ全体が含まれていない場合は、Office を再インストールし、インストールに PIA を含めることもできます。このパッケージを手動でダウンロードしてインストールすることもできます。詳しいインストール手順については、この MSDN ページをご覧ください。

注: Microsoft Office 2010 PIA 再頒布可能パッケージのみを個別にダウンロードしてインストールできます。このパッケージの PIA バージョンは 14.0.0 です。バージョン 15 は、Office をインストールすることによってのみ使用できます。

最後に、php.ini ファイル内の PHP 拡張機能 php_com_dotnet.dll を有効にして、サーバーを再起動する必要があります。

これでプログラミングを始めることができます。

HTMLフォーム

このデモは主にバックエンドの処理に焦点を当てているため、シンプルな HTML フォームを使用してフロントエンドを表示すると次のようになります。

「名前」を入力するためのテキストボックス、「性別」のためのラジオボタングループ、「年齢」のためのフィールド値コントロール、そして「メッセージ」を書くためのテキストフィールドがあります。最後に「送信」ボタンが必要です。

ファイルに「index.html」という名前を付けて、仮想ホストのルート ディレクトリに保存します。これにより、URL (例: http://test/test/interop) を通じてファイルに直接アクセスできるようになります。

バックステージ

バックエンド PHP ファイルは、これから説明するコア部分です。最初に以下のコードを投稿し、それからステップバイステップで説明します

$inputs['printdate']='';
// 「printdate」がないため、PHP 通知を回避するためのダミー値POST 変数
$w = 新しい DOTNET($assembly, $class);
$w->visible = true;

$fn = __DIR__ '\template.docx';

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

echo "ドキュメントが開きました。";

$flds = $d->フィールド;
$count = $flds->Count;
echo "このドキュメントには $count フィールドがあります。";
echo "";
$mapping = setupfields();
 
foreach ($flds as $index => $f)
{ 
 $f->Select();
 $key = $mapping[$index];
 $value = $inputs[$key];
 if ($key == '性別')
 {
 if ($value == 'm')
 $value = 'さん';
 else
 $value = 'さん';
 }
 
 if($key=='printdate')
 $value= date ('Y-m-d H: i:s');
 
 $w->Selection->TypeText($value);
 echo "Mappig フィールド $index: $key 値 $value";
}
 echo "";

echo "マッピングが完了しました!";
echo "印刷中です。しばらくお待ちください...";

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

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



function setupfields()
{
 $mapping = array( );
 $mapping[0] = '性別';
 $mapping[1] = '名前';
 $mapping[2] = '年齢';
 $mapping[3] = 'メッセージ';
 $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 操作には、アセンブリ内のクラスのインスタンスを要求する必要があります。私たちの場合は、Word を使用して作業します。前のスクリーンショットに示されているコードを考慮すると、完全に署名された Word PIA を構築できます。

  「名前」、「バージョン」、「公開鍵トークン」は「c:Windowsassembly」を閲覧した際に表示される情報です
   「文化」は常に中立です。 



呼び出しクラスのコンパイル済みファイルのサフィックスは、通常、ApplicationClass です。
次の 2 つの手順を設定することで、単語オブジェクトを初期化できます: 
まず、visible 属性を true に設定することで、単語オブジェクトをバックグラウンドで保存したり、フォアグラウンドで表示したりすることができます。 
次に、処理対象のドキュメントを開き、それを $d 変数としてインスタンス化します。 
ドキュメントオブジェクトに、HTMLフォームのテキストに基づいてドキュメントのコンテンツを追加します。ここでいくつかのパラメータを設定できます。 
最悪の方法は、php ページ上のすべてをハードコーディングしてから、それらを word オブジェクトに追加することです。次の理由により、この方法は使用しないことを強くお勧めします: 
1 コードは柔軟ではないため、PHP コンテンツを変更するにはスクリプトの再修正が必要になります。
2 制御層と表示層の分離に違反します 
3. Word コンテンツの形式 (配置、フォント、スタイルなど) を設定する必要がある場合、この方法ではコードの行数が大幅に増加し、プログラムでスタイルを変更するのは非常に面倒です。 


もう 1 つの方法は、「検索置換」を使用することです。 PHP に組み込まれているこの機能は非常に強力です。 Word 文書を作成し、置換する必要があるプレースホルダーのコンテンツの周囲にセパレーターを配置します。たとえば、次の内容を含むドキュメントを作成します: 

{{名前}}


PHP では、フォームの送信から取得した「名前」の値に単純に置き換えます。このアプローチにより、最初のオプションの欠点が回避されます。正しいセパレータを見つける必要があるだけです。この例では、使用されるテンプレートが Word ドキュメントであることを除けば、テンプレートのレンダリングを行うことに似ています。 


3 番目のオプションは私の推奨事項で、Word のプレミアム テーマです。プレースホルダーを表すためにフィールドを使用し、PHP コードでは、対応するフォーム値でフィールドを直接更新します。 
この方法は柔軟かつ高速で、Word のベスト プラクティスに準拠しています。これにより、ファイルの全文検索も回避され、パフォーマンスの向上に役立ちます。このオプションには欠点もあることに注意してください。 
 つまり、Word はデビュー以来、名前付きインデックス付きフィールドをサポートしたことがありません。 Word 文書内に作成するフィールドには名前を付けますが、各フィールドにアクセスするには数値の下付き文字を使用します。これは、フィールドインデックスとフォームフィールドの名前の間のマッピングマニュアルを行うために専用の関数 (setupfields) を使用する必要がある理由も説明しています


Word 文書にフィールドを挿入する方法 (カスタマイズされたバージョンを表示するにはここをクリック) については、関連する Word ヘルプ トピックとマニュアルを参照してください。このデモでは、5 つの MERGEFIELD フィールドを含むドキュメントがあります。さらに、簡単にアクセスできるように、ドキュメントと PHP スクリプトを 1 つのディレクトリに配置しました。 
 printdate フィールドには、対応するフォーム フィールドがないことに注意してください。これが、偽の printdate を $inputs 配列のキーとして追加する理由です。このキーがなくてもスクリプトは実行できますが、インデックス printdate が $inputs 配列に存在しないことを示すプロンプトが表示されます。 
フォームデータを使用してフィールド値を更新した後、次のコマンドを使用してドキュメントを印刷します: 
 


$d->PrintOut();

Windows、PHP、Word