La conversione di documenti Word in anteprime immagine è una necessità frequente quando si costruiscono portali web o strumenti di reporting. Aspose.OMR Cloud SDK for PHP consente agli sviluppatori PHP di convertire programmaticamente DOCX in JPG in PHP con alta fedeltà. In questo tutorial vedrai un esempio completo in PHP, il flusso di lavoro REST equivalente con cURL e tutto il necessario per preparare l’ambiente. Alla fine avrai una soluzione riutilizzabile che può essere integrata in qualsiasi applicazione PHP.

Esempio completo funzionante per convertire DOCX in JPG in PHP usando Aspose.OMR Cloud SDK

Questo esempio dimostra come utilizzare l’Aspose.OMR Cloud SDK for PHP per convertire un file DOCX in un’immagine 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);
}

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare tutti i percorsi dei file e i valori di configurazione per corrispondere al tuo ambiente reale, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se riscontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Conversione da DOCX a JPG tramite REST API usando cURL

Se preferisci un approccio REST puro, la stessa conversione può essere eseguita con alcuni comandi cURL.

  1. Ottieni un token di accesso - sostituisci i segnaposto con le tue credenziali client.
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. Carica il file DOCX - usa il token del passaggio precedente.
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. Richiedi la conversione in 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. Scarica il JPG generato.
curl -X GET "https://api.aspose.cloud/v4.0/omr/storage/file/output.jpg" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -o output.jpg

Per un riferimento completo, consulta la documentazione API ufficiale.

Analisi della conversione da DOCX a JPG in PHP con Aspose.OMR Cloud SDK

La seguente suddivisione numerata spiega ogni parte del codice PHP che esegue la conversione da DOCX a JPG nel flusso di lavoro PHP.

  1. Impostazione della configurazione - La classe Configuration contiene il tuo AppSid e ApiKey.
$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setApiKey('YOUR_API_KEY');
  1. Inizializzazione dell’API - Viene creata un’istanza di ConvertApi con la configurazione.
$convertApi = new ConvertApi($config);
  1. Preparazione dello stream di input - Il file DOCX viene aperto come stream binario per evitare di caricare l’intero file in memoria.
$inputStream = fopen($inputDocxPath, 'rb');
  1. Creazione della richiesta - ConvertDocumentRequest specifica lo stream di input, il formato di output desiderato (jpg) e un nome file di output opzionale.
$request = new ConvertDocumentRequest();
$request->setFile($inputStream);
$request->setOutputFormat('jpg');
$request->setOutputFileName('output.jpg');
  1. Esecuzione della conversione e salvataggio del risultato - convertDocument restituisce un flusso di risposta che viene scritto in output.jpg utilizzando una copia bufferizzata.
$responseStream = $convertApi->convertDocument($request);
$outputHandle = fopen($outputJpgPath, 'wb');
while (!feof($responseStream)) {
    $buffer = fread($responseStream, 8192);
    fwrite($outputHandle, $buffer);
}

Per ulteriori dettagli sulla classe ConvertApi, fare riferimento al riferimento API.

Preparare l’ambiente per Aspose.OMR Cloud SDK in PHP

  1. Installa l’SDK tramite Composer
composer require aspose/aspose-omr-cloud

Il pacchetto può anche essere scaricato dalla pagina di rilascio.

  1. Verifica la versione di PHP - L’SDK richiede PHP 7.2 o versioni successive.

  2. Configura le credenziali - Sostituisci YOUR_APP_SID e YOUR_API_KEY nel codice con i valori del tuo account Aspose Cloud.

  3. Caricamento automatico delle dipendenze - Il file vendor/autoload.php generato da Composer carica tutte le classi richieste.

Con questi passaggi completati, sei pronto a convertire DOCX in JPG in PHP usando l’Aspose.OMR Cloud SDK.

Conclusione

Ora sai come convertire DOCX in JPG in PHP in modo efficiente con l’Aspose.OMR Cloud SDK. Il campione di codice fornito, il flusso di lavoro REST cURL e le istruzioni di configurazione ti offrono una soluzione completa, pronta per la produzione, che può essere integrata in qualsiasi progetto PHP, incluse le applicazioni Laravel. Per uso commerciale, acquista una licenza nella pagina prodotto Aspose.OMR Cloud SDK for PHP; una licenza temporanea è disponibile anche tramite la pagina della licenza temporanea. Inizia a convertire i tuoi documenti Word in immagini JPG di alta qualità oggi.

FAQs

Come posso convertire DOCX in JPG in PHP?
Utilizza Aspose.OMR Cloud SDK for PHP. Dopo aver installato l’SDK e configurato le tue credenziali, l’esempio di codice PHP sopra mostra i passaggi esatti per convertire un file DOCX in un’immagine JPG.

È possibile convertire DOCX in JPG in Laravel in PHP?
Sì. L’SDK funziona con qualsiasi framework PHP, incluso Laravel. Posiziona la logica di conversione all’interno di un controller o di una classe di servizio e chiamala dalle tue rotte.

Qual è il modo migliore per convertire DOCX in JPG ad alta risoluzione in PHP?
Regola i parametri di risoluzione dell’output (se supportati) nella richiesta di conversione. L’SDK consente di specificare le impostazioni DPI nel corpo della richiesta per un output JPG di qualità superiore.

Posso convertire più file DOCX in JPG in PHP con un unico script?
Assolutamente. Scorri un array di percorsi di file DOCX, riutilizza la stessa istanza di ConvertApi e invoca convertDocument per ogni file. Questo approccio scala bene per l’elaborazione batch.

Leggi di più