Generare HTML in PNG con PHP è una necessità comune per creare miniature, anteprime di email e report. Aspose.HTML Cloud SDK for PHP fornisce una libreria potente che rende la conversione lato server semplice. In questa guida imparerai come configurare l’SDK, impostare le opzioni di conversione, eseguire un esempio di codice completo e svolgere la stessa operazione con chiamate REST cURL per flussi di lavoro automatizzati.

Conversione da HTML a PNG in PHP - Guida passo passo

  1. Installa l’SDK via Composer: Usa il comando Composer ufficiale per aggiungere la libreria al tuo progetto.
composer require aspose-html-cloud
  1. Configura le tue credenziali Aspose Cloud: Crea un oggetto Configuration e imposta il tuo AppSid e AppKey.
$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setAppKey('YOUR_APP_KEY');
  1. Inizializzare l’API di conversione: Istanziare ConvertApi con l’oggetto di configurazione.
$convertApi = new ConvertApi($config);
  1. Imposta le opzioni di conversione: Definisci il formato di output, le dimensioni, la qualità e il colore di sfondo usando ConvertOptions.
$options = new ConvertOptions();
$options->setOutputFormat('png');
$options->setWidth(1024);
$options->setHeight(0);               // Preserve aspect ratio
$options->setQuality(90);
$options->setBackgroundColor('#FFFFFF');
  1. Eseguire la conversione: Chiamare convertLocal con il file HTML di origine e il percorso PNG di destinazione.
try {
    $convertApi->convertLocal($inputHtmlPath, $outputPngPath, $options);
    echo "Conversion successful: {$outputPngPath}\n";
} catch (Exception $e) {
    echo "Conversion failed: " . $e->getMessage() . "\n";
}

Per informazioni dettagliate su classi e metodi, consultare il riferimento API.

HTML in PNG in PHP - Esempio di codice completo

Questo esempio dimostra come convertire un file HTML locale in un’immagine PNG utilizzando l’Aspose.HTML Cloud SDK per 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
// -----------------------------------------------------------------------------
?>

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare i percorsi dei file (sample.html, sample.png, ecc.) per corrispondere alle tue effettive posizioni dei file, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Converti HTML in PNG usando cURL e l’API REST

I seguenti comandi cURL mostrano come ottenere la stessa conversione da HTML a PNG utilizzando l’API REST di Aspose.HTML Cloud.

  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 HTML di origine nel storage.
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. Richiedi la conversione in 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. Scarica il file PNG generato.
curl -X GET "https://api.aspose.cloud/v4.0/html/storage/file/sample.png" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample.png

Per un elenco completo di parametri e opzioni aggiuntive, consulta la documentazione ufficiale dell’API.

Prerequisiti e configurazione per Aspose.HTML Cloud SDK for PHP

Prima di iniziare, assicurati di avere:

  • PHP 7.4 o versioni successive installato.
  • Composer installato sulla tua macchina di sviluppo.
  • Un account Aspose Cloud con AppSid e AppKey validi.

Installa l’SDK usando Composer:

composer require aspose-html-cloud

Puoi scaricare il pacchetto più recente dalla pagina di rilascio ufficiale: Aspose.HTML Cloud SDK for PHP Release.

Configura le tue credenziali come mostrato nella sezione dei passaggi, quindi sei pronto per iniziare a convertire HTML in PNG.

Conclusione

Convertire HTML in PNG in PHP diventa semplice con l’Aspose.HTML Cloud SDK for PHP. La libreria gestisce il rendering, il ridimensionamento e l’ottimizzazione delle immagini sul lato server, eliminando la necessità di un browser o di strumenti esterni. Seguendo la guida passo‑passo, è possibile integrare la generazione di PNG ad alta qualità in qualsiasi applicazione PHP, sia per la creazione di miniature, il rendering di email o la generazione di report. Ricorda di acquisire una licenza adeguata per l’uso in produzione; i dettagli dei prezzi sono disponibili nella pagina del prodotto, e una licenza temporanea può essere ottenuta dalla pagina della licenza temporanea mentre valuti la libreria.

FAQs

  • Come funziona HTML in PNG in PHP senza un browser?
    L’Aspose.HTML Cloud SDK for PHP rende l’HTML usando il proprio motore di rendering sul server, quindi non è necessario alcun browser o Chrome headless.

  • Posso controllare le dimensioni e la qualità dell’immagine?
    Sì. Usa la classe ConvertOptions per impostare larghezza, altezza, qualità (0‑100) e colore di sfondo prima di chiamare l’API Convert.

  • È possibile convertire in batch più file HTML in PNG?
    Assolutamente. Scorri l’elenco dei file, riutilizza la stessa istanza di ConvertApi e regola i percorsi di input e output per ogni iterazione.

  • Quale licenza è necessaria per progetti commerciali?
    È necessaria una licenza a pagamento per la produzione. È possibile visualizzare i prezzi nella pagina del prodotto e ottenere una licenza di valutazione temporanea dalla pagina della licenza temporanea.

Read More