Generering af HTML til PNG i PHP er et almindeligt behov for at skabe miniaturer, e‑mail‑forhåndsvisninger og rapporter. Aspose.HTML Cloud SDK for PHP leverer et kraftfuldt bibliotek, der gør server‑side konvertering ligetil. I denne vejledning vil du lære, hvordan du opsætter SDK’en, konfigurerer konverteringsindstillinger, kører et komplet kodeeksempel, og udfører den samme opgave med cURL REST‑kald for automatiserede arbejdsprocesser.

HTML til PNG-konvertering i PHP - Trin-for-trin guide

  1. Installer SDK’en via Composer: Brug den officielle Composer-kommando til at tilføje biblioteket til dit projekt.
composer require aspose-html-cloud
  1. Konfigurer dine Aspose Cloud-legitimationsoplysninger: Opret et Configuration-objekt og indstil din AppSid og AppKey.
$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setAppKey('YOUR_APP_KEY');
  1. Initialiser Convert API: Opret en forekomst af ConvertApi med konfigurationsobjektet.
$convertApi = new ConvertApi($config);
  1. Indstil konverteringsindstillinger: Definer outputformat, dimensioner, kvalitet og baggrundsfarve ved hjælp af ConvertOptions.
$options = new ConvertOptions();
$options->setOutputFormat('png');
$options->setWidth(1024);
$options->setHeight(0);               // Preserve aspect ratio
$options->setQuality(90);
$options->setBackgroundColor('#FFFFFF');
  1. Udfør konverteringen: Kald convertLocal med kilde‑HTML‑filen og destinations‑PNG‑stien.
try {
    $convertApi->convertLocal($inputHtmlPath, $outputPngPath, $options);
    echo "Conversion successful: {$outputPngPath}\n";
} catch (Exception $e) {
    echo "Conversion failed: " . $e->getMessage() . "\n";
}

For detaljeret information om klasser og metoder, se API reference.

HTML til PNG i PHP - Fuldstændigt kodeeksempel

Dette eksempel demonstrerer, hvordan man konverterer en lokal HTML‑fil til et PNG‑billede ved hjælp af Aspose.HTML Cloud SDK for PHP.

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

use Aspose\HTML\Cloud\Configuration;
use Aspose\HTML\Cloud\Api\ConvertApi;
use Aspose\HTML\Cloud\Model\ConvertOptions;

// -----------------------------------------------------------------------------
// Configuration – replace with your actual Aspose Cloud credentials
// -----------------------------------------------------------------------------
$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setAppKey('YOUR_APP_KEY');

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

// -----------------------------------------------------------------------------
// Define source HTML and destination PNG paths (generic, adjust as needed)
// -----------------------------------------------------------------------------
$inputHtmlPath  = __DIR__ . '/sample.html';
$outputPngPath  = __DIR__ . '/sample.png';

// -----------------------------------------------------------------------------
// Set conversion options – adjust width/height, quality, and background color
// -----------------------------------------------------------------------------
$options = new ConvertOptions();
$options->setOutputFormat('png');      // Target format
$options->setWidth(1024);              // Desired width (pixels)
$options->setHeight(0);                // Height 0 preserves aspect ratio
$options->setQuality(90);              // PNG compression level (0‑100)
$options->setBackgroundColor('#FFFFFF'); // Optional background for transparent pages

// -----------------------------------------------------------------------------
// Perform the conversion
// -----------------------------------------------------------------------------
try {
    $convertApi->convertLocal($inputHtmlPath, $outputPngPath, $options);
    echo "Conversion successful: {$outputPngPath}\n";
} catch (Exception $e) {
    echo "Conversion failed: " . $e->getMessage() . "\n";
}

// -----------------------------------------------------------------------------
// No explicit cleanup required – SDK handles temporary resources internally
// -----------------------------------------------------------------------------
?>

Bemærk: Dette kodeeksempel demonstrerer kernefunktionaliteten. Før du bruger det i dit projekt, skal du sørge for at opdatere filstierne (sample.html, sample.png osv.) så de matcher dine faktiske filplaceringer, verificere at alle nødvendige afhængigheder er korrekt installeret, og teste grundigt i dit udviklingsmiljø. Hvis du støder på problemer, så henvis til den officielle dokumentation eller kontakt supportteamet for assistance.

Konverter HTML til PNG ved hjælp af cURL og REST API’et

Følgende cURL-kommandoer viser, hvordan man opnår den samme HTML til PNG-konvertering ved hjælp af Aspose.HTML Cloud REST API.

  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 kilde‑HTML‑filen til lageret.
curl -X PUT "https://api.aspose.cloud/v4.0/html/storage/file/sample.html" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: text/html" \
     --data-binary "@sample.html"
  1. Anmod om konvertering til PNG.
curl -X POST "https://api.aspose.cloud/v4.0/html/convert?format=png&width=1024&quality=90&backgroundColor=%23FFFFFF" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"inputPath":"sample.html","outputPath":"sample.png"}'
  1. Download den genererede PNG-fil.
curl -X GET "https://api.aspose.cloud/v4.0/html/storage/file/sample.png" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample.png

For en komplet liste over parametre og yderligere indstillinger, se den officielle API-dokumentation.

Forudsætninger og opsætning for Aspose.HTML Cloud SDK for PHP

Før du begynder, skal du sikre dig, at du har:

  • PHP 7.4 eller senere installeret.
  • Composer installeret på din udviklingsmaskine.
  • En Aspose Cloud‑konto med gyldig AppSid og AppKey.

Installer SDK’en ved hjælp af Composer:

composer require aspose-html-cloud

Du kan downloade den seneste pakke fra den officielle udgivelsesside: Aspose.HTML Cloud SDK for PHP Release.

Konfigurer dine legitimationsoplysninger som vist i trinsektionen, så er du klar til at begynde at konvertere HTML til PNG.

Konklusion

Konvertering af HTML til PNG i PHP bliver ubesværet med Aspose.HTML Cloud SDK for PHP. Biblioteket håndterer rendering, skalering og billedoptimering på serversiden, hvilket eliminerer behovet for en browser eller eksterne værktøjer. Ved at følge den trin‑for‑trin guide kan du integrere høj‑kvalitets PNG‑generering i enhver PHP‑applikation, uanset om det er til miniature‑oprettelse, e‑mail‑rendering eller rapportgenerering. Husk at anskaffe en korrekt licens til produktionsbrug; prisoplysninger findes på produktsiden, og en midlertidig licens kan fås fra den midlertidige licensside mens du evaluerer biblioteket.

FAQs

  • Hvordan fungerer HTML til PNG i PHP uden en browser?
    Aspose.HTML Cloud SDK for PHP gengiver HTML ved hjælp af sin egen renderingsmotor på serveren, så ingen browser eller headless Chrome er påkrævet.

  • Kan jeg styre billedets dimensioner og kvalitet?
    Ja. Brug ConvertOptions-klassen til at indstille bredde, højde, kvalitet (0‑100) og baggrundsfarve, før du kalder Convert API.

  • Er det muligt at batch-konvertere flere HTML-filer til PNG?
    Absolut. Loop gennem din filliste, genbrug den samme ConvertApi-instans, og juster input- og outputstierne for hver iteration.

  • Hvilken licens er nødvendig for kommercielle projekter?
    En betalt licens er påkrævet til produktion. Du kan se priser på produktsiden og få en midlertidig evalueringslicens fra den midlertidige licensside.

Læs mere