Конвертування документів Word у попередні перегляди зображень часто потрібно під час створення веб‑порталів або інструментів звітності. Aspose.OMR Cloud SDK for PHP дає змогу розробникам PHP програмно конвертувати DOCX у JPG у PHP з високою точністю. У цьому підручнику ви побачите повний приклад PHP, еквівалентний робочий процес cURL REST і все, що потрібно для підготовки середовища. Після завершення у вас буде багаторазове рішення, яке можна інтегрувати в будь‑який PHP‑додаток.

Повний робочий приклад конвертації DOCX у JPG у PHP за допомогою Aspose.OMR Cloud SDK

Цей приклад демонструє, як використовувати 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);
}

Примітка: Цей приклад коду демонструє основну функціональність. Перш ніж використовувати його у вашому проєкті, переконайтеся, що оновили всі шляхи до файлів та значення конфігурації відповідно до вашого реального середовища, перевірте, що всі необхідні залежності встановлені правильно, і ретельно протестуйте у вашому середовищі розробки. Якщо ви зіткнетеся з будь-якими проблемами, будь ласка, зверніться до офіційної документації або зв’яжіться з командою підтримки для отримання допомоги.

Конвертація DOCX у JPG за допомогою REST API з використанням cURL

Якщо ви віддаєте перевагу чистому підходу 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.

Розбір процесу конвертації DOCX у JPG у PHP за допомогою Aspose.OMR Cloud SDK

Наступний нумерований розбір пояснює кожну частину 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.

Підготовка середовища для Aspose.OMR Cloud SDK у PHP

  1. Встановіть SDK за допомогою Composer
composer require aspose/aspose-omr-cloud

Пакет також можна завантажити зі сторінки випуску.

  1. Перевірте версію PHP - SDK вимагає PHP 7.2 або новішої.

  2. Налаштуйте облікові дані - Замініть YOUR_APP_SID і YOUR_API_KEY у коді на значення з вашого облікового запису Aspose Cloud.

  3. Автозавантаження залежностей - Файл vendor/autoload.php, згенерований Composer, завантажує всі необхідні класи.

Після завершення цих кроків ви готові конвертувати DOCX у JPG у PHP, використовуючи Aspose.OMR Cloud SDK.

Висновок

Тепер ви знаєте, як ефективно конвертувати DOCX у JPG у PHP за допомогою Aspose.OMR Cloud SDK. Наданий зразок коду, робочий процес REST cURL та інструкції з налаштування надають вам повне, готове до продакшн рішення, яке можна інтегрувати в будь‑який PHP‑проект, включаючи застосунки Laravel. Для комерційного використання придбайте ліцензію на сторінці продукту Aspose.OMR Cloud SDK for PHP; тимчасова ліцензія також доступна через сторінка тимчасової ліцензії. Почніть конвертувати ваші Word‑документи у високоякісні JPG‑зображення вже сьогодні.

Питання та відповіді

Як можна конвертувати DOCX у JPG за допомогою PHP?
Використовуйте Aspose.OMR Cloud SDK for PHP. Після встановлення SDK та налаштування ваших облікових даних, наведений вище приклад коду PHP показує точні кроки для конвертації файлу DOCX у зображення JPG.

Чи можливо конвертувати DOCX у JPG у Laravel на PHP?
Так. SDK працює з будь‑яким PHP‑фреймворком, включаючи Laravel. Розмістіть логіку конвертації всередині контролера або сервісного класу та викликайте її з ваших маршрутів.

Який найкращий спосіб конвертувати DOCX у JPG високої роздільної здатності в PHP?
Налаштуйте параметри вихідної роздільної здатності (за наявності підтримки) у запиті на конвертацію. SDK дозволяє вказати налаштування DPI у тілі запиту для отримання JPG вищої якості.

Чи можу я конвертувати кілька DOCX у JPG у PHP за допомогою одного скрипту?
Звичайно. Пройдіться по масиву шляхів до файлів DOCX, повторно використайте той самий екземпляр ConvertApi і викличте convertDocument для кожного файлу. Такий підхід добре масштабується для пакетної обробки.

Читати далі