HTML‑ből PNG‑re PHP generálása gyakori igény a bélyegképek, e‑mail előnézetek és jelentések létrehozásához. Az Aspose.HTML Cloud SDK for PHP egy erőteljes könyvtárat biztosít, amely egyszerűvé teszi a szerveroldali konverziót. Ebben az útmutatóban megtanulja, hogyan állítsa be az SDK‑t, konfigurálja a konverziós beállításokat, futtassa a teljes kódrészletet, és ugyanazt a feladatot cURL REST hívásokkal hajtsa végre az automatizált munkafolyamatokhoz.

HTML to PNG konvertálás PHP-ben - Lépésről lépésre útmutató

  1. Telepítse az SDK-t Composer segítségével: Használja a hivatalos Composer parancsot a könyvtár projektbe való hozzáadásához.
composer require aspose-html-cloud
  1. Állítsa be az Aspose Cloud hitelesítő adatait: Hozzon létre egy Configuration objektumot, és állítsa be az AppSid és AppKey értékeket.
$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setAppKey('YOUR_APP_KEY');
  1. Inicializálja a Convert API-t: ConvertApi példányosítása a konfigurációs objektummal.
$convertApi = new ConvertApi($config);
  1. Állítsa be a konverziós beállításokat: Határozza meg a kimeneti formátumot, a méreteket, a minőséget és a háttérszínt a ConvertOptions használatával.
$options = new ConvertOptions();
$options->setOutputFormat('png');
$options->setWidth(1024);
$options->setHeight(0);               // Preserve aspect ratio
$options->setQuality(90);
$options->setBackgroundColor('#FFFFFF');
  1. Végezze el a konverziót: Hívja meg a convertLocal függvényt a forrás HTML fájllal és a cél PNG útvonallal.
try {
    $convertApi->convertLocal($inputHtmlPath, $outputPngPath, $options);
    echo "Conversion successful: {$outputPngPath}\n";
} catch (Exception $e) {
    echo "Conversion failed: " . $e->getMessage() . "\n";
}

Részletes osztály- és metódusinformációkért tekintse meg az API-referencia.

HTML PNG-re PHP-ben - Teljes kódrészlet

Ez a példa bemutatja, hogyan lehet egy helyi HTML fájlt PNG képpé konvertálni az Aspose.HTML Cloud SDK for PHP használatával.

<?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
// -----------------------------------------------------------------------------
?>

Megjegyzés: Ez a kódpélda bemutatja az alapvető funkcionalitást. Mielőtt a projektjében használná, győződjön meg róla, hogy frissíti a fájlútvonalakat (sample.html, sample.png, stb.) a tényleges helyeknek megfelelően, ellenőrizze, hogy minden szükséges függőség megfelelően telepítve van, és alaposan tesztelje a fejlesztői környezetben. Ha problémákba ütközik, kérjük, tekintse meg a hivatalos dokumentációt vagy lépjen kapcsolatba a támogatási csapattal segítségért.

HTML konvertálása PNG-re cURL és a REST API használatával

Az alábbi cURL parancsok bemutatják, hogyan lehet ugyanazt az HTML‑ról PNG‑re konvertálást elvégezni az Aspose.HTML Cloud REST API használatával.

  1. Szerezzen hozzáférési tokent (cserélje ki a helyőrzőket a saját ügyfélhitelesítő adataira).
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. A forrás HTML fájl feltöltése a tárolóba.
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. Kérje a konvertálást PNG formátumba.
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. Töltse le a generált PNG fájlt.
curl -X GET "https://api.aspose.cloud/v4.0/html/storage/file/sample.png" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample.png

A paraméterek teljes listájáért és további lehetőségekért tekintse meg a hivatalos API dokumentációt.

Előkövetelmények és beállítások az Aspose.HTML Cloud SDK for PHP-hez

Mielőtt elkezdené, győződjön meg róla, hogy rendelkezik:

  • PHP 7.4 vagy újabb telepítve.
  • Composer telepítve a fejlesztői gépén.
  • Egy Aspose Cloud fiók érvényes AppSid és AppKey értékekkel.

Telepítse az SDK-t a Composer használatával:

composer require aspose-html-cloud

A legújabb csomagot letöltheti a hivatalos kiadási oldalról: Aspose.HTML Cloud SDK for PHP kiadás.

Állítsa be a hitelesítő adatait a lépések szakaszában leírtak szerint, majd készen áll a HTML PNG-re konvertálására.

Összegzés

HTML konvertálása PNG‑re PHP‑ben könnyedé válik az Aspose.HTML Cloud SDK for PHP segítségével. A könyvtár kezeli a renderelést, a méretezést és a képek optimalizálását a szerveroldalon, ezáltal nincs szükség böngészőre vagy külső eszközökre. A lépésről‑lépésre útmutató követésével magas minőségű PNG generálást integrálhat bármely PHP alkalmazásba, legyen szó bélyegkép létrehozásáról, e‑mail renderelésről vagy jelentéskészítésről. Ne feledje, hogy a termeléshez megfelelő licencet kell beszerezni; az árak a termékoldalon érhetők el, és ideiglenes licencet a ideiglenes licenc oldal oldalról szerezhet be, miközben értékeli a könyvtárat.

GYIK

  • Hogyan működik a HTML PNG-re konvertálása PHP-ben böngésző nélkül?
    Az Aspose.HTML Cloud SDK for PHP a saját renderelő motorjával rendereli a HTML-t a szerveren, így nincs szükség böngészőre vagy headless Chrome-ra.

  • Mérhetem és szabályozhatom a kép méreteit és minőségét?
    Igen. Használja a ConvertOptions osztályt a szélesség, magasság, minőség (0‑100) és háttérszín beállításához, mielőtt meghívná a Convert API-t.

  • Lehetséges tömegesen konvertálni több HTML fájlt PNG-re?
    Természetesen. Iteráljon a fájllistán, használja újra ugyanazt a ConvertApi példányt, és minden iterációban állítsa be a bemeneti és kimeneti útvonalakat.

  • Milyen licenc szükséges kereskedelmi projektekhez?
    A termeléshez fizetett licenc szükséges. Az árakat a termékoldalon tekintheti meg, és ideiglenes értékelő licencet szerezhet az ideiglenes licenc oldal segítségével.

Olvass tovább