Konvertering af Word-dokumenter til billedforhåndsvisninger er et hyppigt behov, når man bygger webportaler eller rapporteringsværktøjer. Aspose.OMR Cloud SDK for PHP giver PHP-udviklere mulighed for programmatisk at konvertere DOCX til JPG i PHP med høj nøjagtighed. I denne vejledning vil du se et komplet PHP‑eksempel, den tilsvarende cURL REST‑arbejdsgang og alt, der kræves for at gøre miljøet klar. Når du er færdig, har du en genanvendelig løsning, der kan integreres i enhver PHP‑applikation.

Fuld fungerende eksempel på konvertering af DOCX til JPG i PHP ved hjælp af Aspose.OMR Cloud SDK

Dette eksempel demonstrerer, hvordan du bruger Aspose.OMR Cloud SDK for PHP til at konvertere en DOCX‑fil til et JPG‑billede.

<?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);
}

Bemærk: Dette kodeeksempel demonstrerer kernefunktionaliteten. Før du bruger det i dit projekt, skal du sørge for at opdatere alle filstier og konfigurationsværdier, så de matcher dit faktiske miljø, bekræfte at alle nødvendige afhængigheder er korrekt installeret, og teste grundigt i dit udviklingsmiljø. Hvis du støder på problemer, så se venligst den officielle dokumentation eller kontakt supportteamet for assistance.

DOCX til JPG-konvertering via REST API ved hjælp af cURL

Hvis du foretrækker en ren REST‑tilgang, kan den samme konvertering udføres med et par cURL‑kommandoer.

  1. Få en adgangstoken - erstat pladsholderne med dine klientoplysninger.
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. Upload DOCX-filen - brug tokenet fra det foregående trin.
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. Anmod om konvertering til 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. Download den genererede JPG
curl -X GET "https://api.aspose.cloud/v4.0/omr/storage/file/output.jpg" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -o output.jpg

For en komplet reference, se den officielle API-dokumentation.

Gennemgang af konvertering af DOCX til JPG i PHP med Aspose.OMR Cloud SDK

Den følgende nummererede gennemgang forklarer hver del af PHP‑koden, der udfører konverteringen fra DOCX til JPG i PHP‑arbejdsgangen.

  1. Konfigurationsopsætning - Klassen Configuration indeholder din AppSid og ApiKey.
$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setApiKey('YOUR_API_KEY');
  1. API Initialization - En forekomst af ConvertApi oprettes med konfigurationen.
$convertApi = new ConvertApi($config);
  1. Forbereder inputstrømmen - DOCX-filen åbnes som en binær strøm for at undgå at indlæse hele filen i hukommelsen.
$inputStream = fopen($inputDocxPath, 'rb');
  1. Opbygning af anmodningen - ConvertDocumentRequest angiver inputstrømmen, det ønskede outputformat (jpg) og et valgfrit outputfilnavn.
$request = new ConvertDocumentRequest();
$request->setFile($inputStream);
$request->setOutputFormat('jpg');
$request->setOutputFileName('output.jpg');
  1. Udførelse af konverteringen og gemning af resultatet - convertDocument returnerer en responsstrøm, som skrives til output.jpg ved brug af en bufferkopi.
$responseStream = $convertApi->convertDocument($request);
$outputHandle = fopen($outputJpgPath, 'wb');
while (!feof($responseStream)) {
    $buffer = fread($responseStream, 8192);
    fwrite($outputHandle, $buffer);
}

For flere detaljer om ConvertApi-klassen, se API-referencen.

Gør miljøet klar til Aspose.OMR Cloud SDK i PHP

  1. Installer SDK’en via Composer
composer require aspose/aspose-omr-cloud

Pakken kan også downloades fra udgivelsesside.

  1. Bekræft PHP-version - SDK’en kræver PHP 7.2 eller senere.

  2. Opsæt legitimationsoplysninger - Erstat YOUR_APP_SID og YOUR_API_KEY i koden med værdierne fra din Aspose Cloud-konto.

  3. Autoload-afhængigheder - Filen vendor/autoload.php genereret af Composer indlæser alle nødvendige klasser.

Når disse trin er fuldført, er du klar til at konvertere DOCX til JPG i PHP ved hjælp af Aspose.OMR Cloud SDK.

Konklusion

Du ved nu, hvordan du effektivt kan konvertere DOCX til JPG i PHP med Aspose.OMR Cloud SDK. Den medfølgende kodeeksempel, REST cURL‑arbejdsgang og installationsinstruktioner giver dig en komplet, produktionsklar løsning, som kan integreres i ethvert PHP‑projekt, inklusive Laravel‑applikationer. Til kommerciel brug kan du købe en licens på produktsiden Aspose.OMR Cloud SDK for PHP; en midlertidig licens er også tilgængelig via midlertidig licensside. Begynd at konvertere dine Word‑dokumenter til JPG‑billeder af høj kvalitet i dag.

FAQs

Hvordan kan jeg konvertere DOCX til JPG i PHP?
Brug Aspose.OMR Cloud SDK for PHP. Efter at have installeret SDK’et og konfigureret dine legitimationsoplysninger, viser PHP‑kodeeksemplet ovenfor de præcise trin til at konvertere en DOCX‑fil til et JPG‑billede.

Er det muligt at konvertere DOCX til JPG i Laravel i PHP?
Ja. SDK’en fungerer med enhver PHP-ramme, inklusive Laravel. Placer konverteringslogikken i en controller eller service-klasse og kald den fra dine routes.

Hvad er den bedste måde at konvertere DOCX til høj opløsning JPG i PHP?
Juster output‑opløsningsparametrene (hvis understøttet) i konverteringsanmodningen. SDK’en giver dig mulighed for at angive DPI‑indstillinger i anmodningens brødtekst for JPG‑output af højere kvalitet.

Kan jeg konvertere flere DOCX til JPG i PHP med et enkelt script?
Absolut. Loop gennem et array af DOCX‑filstier, genbrug den samme ConvertApi‑instans, og kald convertDocument for hver fil. Denne tilgang skalerer godt til batchbehandling.

Læs mere