Webポータルやレポートツールを構築する際、Word文書を画像プレビューに変換する必要は頻繁にあります。 Aspose.OMR Cloud SDK for PHP は、PHP開発者が高精度で DOCX を JPG にプログラムで変換できるようにします。このチュートリアルでは、完全な PHP サンプル、同等の cURL REST ワークフロー、および環境を整えるために必要なすべてを紹介します。最後まで読むと、任意の PHP アプリケーションに統合できる再利用可能なソリューションが手に入ります。

PHPでAspose.OMR Cloud SDKを使用してDOCXをJPGに変換する完全動作サンプル

この例では、Aspose.OMR Cloud SDK for PHP を使用して DOCX ファイルを JPG 画像に変換する方法を示します。

<?php
require __DIR__ . '/vendor/autoload.php';

use Aspose\OMR\Configuration;
use Aspose\OMR\Api\ConvertApi;
use Aspose\OMR\Model\ConvertDocumentRequest;
use Aspose\OMR\ApiException;

// -----------------------------------------------------------------------------
// Configuration – replace with your actual credentials
// -----------------------------------------------------------------------------
$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setApiKey('YOUR_API_KEY');

// -----------------------------------------------------------------------------
// Initialize the Convert API
// -----------------------------------------------------------------------------
$convertApi = new ConvertApi($config);

// -----------------------------------------------------------------------------
// File paths (adjust as needed)
// -----------------------------------------------------------------------------
$inputDocxPath  = __DIR__ . '/input.docx';
$outputJpgPath  = __DIR__ . '/output.jpg';

// -----------------------------------------------------------------------------
// Prepare request – stream the input file to avoid loading whole file into memory
// -----------------------------------------------------------------------------
$inputStream = fopen($inputDocxPath, 'rb');
if ($inputStream === false) {
    throw new RuntimeException("Unable to open input file: $inputDocxPath");
}

$request = new ConvertDocumentRequest();
$request->setFile($inputStream);          // Input DOCX stream
$request->setOutputFormat('jpg');         // Desired output format
$request->setOutputFileName('output.jpg'); // Optional: name for the generated file

try {
    // -------------------------------------------------------------------------
    // Perform conversion
    // -------------------------------------------------------------------------
    $responseStream = $convertApi->convertDocument($request);

// -------------------------------------------------------------------------
    // Write the resulting JPG to disk using a buffered copy (efficient for large files)
    // -------------------------------------------------------------------------
    $outputHandle = fopen($outputJpgPath, 'wb');
    if ($outputHandle === false) {
        throw new RuntimeException("Unable to open output file: $outputJpgPath");
    }

while (!feof($responseStream)) {
        $buffer = fread($responseStream, 8192);
        if ($buffer === false) {
            throw new RuntimeException('Error reading from response stream.');
        }
        fwrite($outputHandle, $buffer);
    }

fclose($outputHandle);
    fclose($inputStream);
    fclose($responseStream);

echo "Conversion successful. JPG saved to: $outputJpgPath\n";
} catch (ApiException $e) {
    // -------------------------------------------------------------------------
    // Handle API errors (e.g., authentication, unsupported format)
    // -------------------------------------------------------------------------
    fclose($inputStream);
    echo 'API Exception: ', $e->getMessage(), PHP_EOL;
    exit(1);
} catch (Exception $e) {
    // -------------------------------------------------------------------------
    // General error handling
    // -------------------------------------------------------------------------
    if (is_resource($inputStream)) {
        fclose($inputStream);
    }
    echo 'Error: ', $e->getMessage(), PHP_EOL;
    exit(1);
}

注意: このコード例はコア機能を示しています。プロジェクトで使用する前に、ファイルパスや構成値を実際の環境に合わせて更新し、すべての必須依存関係が正しくインストールされていることを確認し、開発環境で徹底的にテストしてください。問題が発生した場合は、公式ドキュメント を参照するか、サポートチーム にお問い合わせください。

cURL を使用した REST API による DOCX から JPG への変換

純粋な REST アプローチを好む場合、同じ変換は数個の cURL コマンドで実行できます。

  1. アクセストークンを取得 - プレースホルダーをクライアント資格情報に置き換えてください。
curl -X POST "https://api.aspose.cloud/connect/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. DOCX ファイルをアップロード - 前のステップで取得したトークンを使用します。
curl -X PUT "https://api.aspose.cloud/v4.0/omr/storage/file/input.docx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document" \
  --data-binary "@input.docx"
  1. JPG への変換をリクエスト.
curl -X POST "https://api.aspose.cloud/v4.0/omr/convert" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "FileName": "input.docx",
        "OutputFormat": "jpg",
        "OutputFileName": "output.jpg"
      }' -o response.json
  1. 生成されたJPGをダウンロード.
curl -X GET "https://api.aspose.cloud/v4.0/omr/storage/file/output.jpg" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -o output.jpg

完全なリファレンスについては、公式 API ドキュメントをご覧ください。

PHP と Aspose.OMR Cloud SDK を使用した DOCX から JPG への変換の詳細

以下の番号付きの内訳は、PHP ワークフローで DOCX を JPG に変換する PHP コードの各部分を説明しています。

  1. 構成設定 - Configuration クラスは AppSid と ApiKey を保持します。
$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setApiKey('YOUR_API_KEY');
  1. API 初期化 - ConvertApi のインスタンスが設定で作成されます。
$convertApi = new ConvertApi($config);
  1. 入力ストリームの準備 - DOCX ファイルは、メモリ全体に読み込むことを避けるためにバイナリ ストリームとして開かれます。
$inputStream = fopen($inputDocxPath, 'rb');
  1. リクエストの構築 - ConvertDocumentRequest は入力ストリーム、希望する出力形式（jpg）、およびオプションの出力ファイル名を指定します。
$request = new ConvertDocumentRequest();
$request->setFile($inputStream);
$request->setOutputFormat('jpg');
$request->setOutputFileName('output.jpg');
  1. 変換の実行と結果の保存 - convertDocument はレスポンスストリームを返し、バッファコピーを使用して output.jpg に書き込まれます。
$responseStream = $convertApi->convertDocument($request);
$outputHandle = fopen($outputJpgPath, 'wb');
while (!feof($responseStream)) {
    $buffer = fread($responseStream, 8192);
    fwrite($outputHandle, $buffer);
}

ConvertApi クラスの詳細については、API リファレンス を参照してください。

PHPでAspose.OMR Cloud SDKの環境を準備する

  1. Composer を使用して SDK をインストールする
composer require aspose/aspose-omr-cloud

パッケージはリリースページからもダウンロードできます。

  1. PHP バージョンの確認 - SDK には PHP 7.2 以降が必要です。

  2. 資格情報の設定 - コード内の YOUR_APP_SID と YOUR_API_KEY を、Aspose Cloud アカウントの値に置き換えてください。

  3. 自動ロード依存関係 - Composer によって生成された vendor/autoload.php ファイルは、必要なすべてのクラスをロードします。

これらの手順が完了したら、PHPで Aspose.OMR Cloud SDK を使用して DOCX を JPG に変換する準備が整います。

結論

あなたは、Aspose.OMR Cloud SDK を使用して PHP で DOCX を JPG に効率的に変換する方法を理解しました。提供されたコードサンプル、REST cURL ワークフロー、セットアップ手順により、Laravel アプリケーションを含む任意の PHP プロジェクトに統合できる、完全な本番環境対応ソリューションが得られます。商用利用の場合は、Aspose.OMR Cloud SDK for PHP 製品ページでライセンスを購入してください。臨時ライセンスは temporary license page でも入手可能です。今すぐ Word ドキュメントを高品質な JPG 画像に変換しましょう。

よくある質問

PHPでDOCXをJPGに変換するにはどうすればよいですか？
Aspose.OMR Cloud SDK for PHP を使用してください。SDK をインストールし、認証情報を設定した後、上記の PHP コード例が DOCX ファイルを JPG 画像に変換する正確な手順を示しています。

LaravelのPHPでDOCXをJPGに変換することは可能ですか？
はい。SDKはLaravelを含むあらゆるPHPフレームワークで動作します。変換ロジックはコントローラまたはサービスクラス内に配置し、ルートから呼び出してください。

DOCX を PHP で高解像度 JPG に変換する最適な方法は何ですか？
変換リクエストで出力解像度パラメータ（サポートされている場合）を調整します。SDK では、リクエスト ボディで DPI 設定を指定でき、高品質な JPG 出力が可能です。

PHP の単一スクリプトで複数の DOCX を JPG に変換できますか？
もちろんです。DOCX ファイルパスの配列をループし、同じ ConvertApi インスタンスを再利用し、各ファイルに対して convertDocument を呼び出します。このアプローチはバッチ処理に適しています。

Read More