GroupDocs.Assembly Cloud SDK for PHP は、開発者が PHP アプリケーションから直接、シンプルなレターから複雑な複数ページのレポートまで、完全にフォーマットされたドキュメントを生成できる包括的なクラウドベースのプラットフォームです。このソリューションは完全に HTTPS 経由で動作するため、クライアント側にオフィスソフトウェアや高負荷のライブラリは必要ありません。すべての処理は GroupDocs Cloud サービスによって実行されます。
SDK は、明確な 3 ステップのワークフローに従います。
AssembleDocument リクエストに渡すと、アセンブルされたドキュメントがストリームとして、または GroupDocs Cloud Storage に保存されているファイルへの参照として取得されます。SDK はさらに、条件ブロック、再利用可能な変数、バーコード生成、メール添付ファイルの作成、完全な HTML スタイル設定などの強力な機能を備えており、あらゆるビジネスルールに適応する動的なデータ駆動型ドキュメントの構築を可能にします。すべての操作は SSL/TLS で保護され、アクセスキーによって認証されるため、機密データが暗号化されたチャネルから外部に漏れることはありません。
SDK は純粋な PHP で記述されており、標準の REST 呼び出しを使用しているため、PHP5.6 以降をサポートするあらゆるオペレーティング システム(Windows、Linux、macOS を含む)で実行でき、Composer、CI パイプライン、または任意のカスタム デプロイメント プロセスとシームレスに統合できます。
以下のスニペットは、Assembly Cloud PHP SDK を使用してドキュメントを生成するための一般的なワークフローを示しています。
AssemblyApi インスタンスを作成します。AssembleOptions を設定し、テンプレートのパス、データ、出力形式を指定します。assembleDocument を呼び出して、アセンブルされたファイルを取得します。use GroupDocs\Assembly\AssemblyApi;
use GroupDocs\Assembly\Model;
use GroupDocs\Assembly\Requests;
$assemblyApi = new AssemblyApi('......##', '......##'); // 認証情報に置き換えます
$fileName = "Input1.docx"; // テンプレートファイル名
$dataFile = "Input2.docx"; // データソースファイル (XML または DOCX)
// テンプレートを Cloud Storage にアップロード
$requestFileContent = $fileName;
$uploadDocumentRequest = new UploadFileRequest($requestFileContent, $fileName, NULL);
$assemblyApi->uploadFile($uploadDocumentRequest);
// データソースを読み取り
$reportData = file_get_contents($dataFile);
// アセンブルオプションを設定
$assembleData = new Model\AssembleOptions([
"template_file_info" => new Model\TemplateFileInfo(["file_path" => $fileName]),
"save_format" => "docx",
"report_data" => $reportData
]);
$request = new Requests\AssembleDocumentRequest($assembleData);
$result = $assemblyApi->assembleDocument($request); // 結果にはアセンブルされたドキュメントが含まれます