HTML’yi PNG’ye PHP içinde oluşturmak, küçük resimler, e-posta önizlemeleri ve raporlar oluşturmak için yaygın bir ihtiyaçtır. Aspose.HTML Cloud SDK for PHP güçlü bir kütüphane sağlayarak sunucu‑tarafı dönüşümü basitleştirir. Bu rehberde SDK’yı nasıl kuracağınızı, dönüşüm seçeneklerini nasıl yapılandıracağınızı, tam bir kod örneğini nasıl çalıştıracağınızı ve otomatik iş akışları için aynı görevi cURL REST çağrılarıyla nasıl gerçekleştireceğinizi öğreneceksiniz.

PHP’de HTML’den PNG’ye Dönüştürme - Adım Adım Kılavuz

  1. Composer aracılığıyla SDK’yı kurun: Kütüphaneyi projenize eklemek için resmi Composer komutunu kullanın.
composer require aspose-html-cloud
  1. Aspose Cloud kimlik bilgilerinizi yapılandırın: Bir Configuration nesnesi oluşturun ve AppSid ve AppKey değerlerinizi ayarlayın.
$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setAppKey('YOUR_APP_KEY');
  1. Convert API’yi Başlatın: ConvertApi nesnesini yapılandırma nesnesiyle örnekleyin.
$convertApi = new ConvertApi($config);
  1. Dönüştürme seçeneklerini ayarlayın: ConvertOptions kullanarak çıktı formatını, boyutları, kaliteyi ve arka plan rengini tanımlayın.
$options = new ConvertOptions();
$options->setOutputFormat('png');
$options->setWidth(1024);
$options->setHeight(0);               // Preserve aspect ratio
$options->setQuality(90);
$options->setBackgroundColor('#FFFFFF');
  1. Dönüşümü gerçekleştir: Kaynak HTML dosyası ve hedef PNG yolu ile convertLocal metodunu çağırın.
try {
    $convertApi->convertLocal($inputHtmlPath, $outputPngPath, $options);
    echo "Conversion successful: {$outputPngPath}\n";
} catch (Exception $e) {
    echo "Conversion failed: " . $e->getMessage() . "\n";
}

Detaylı sınıf ve metod bilgileri için, API referansına bakın.

PHP’de HTML’den PNG’ye - Tam Kod Örneği

Bu örnek, Aspose.HTML Cloud SDK for PHP kullanarak yerel bir HTML dosyasını PNG görüntüsüne dönüştürmeyi gösterir.

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

Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce, dosya yollarını (sample.html, sample.png vb.) gerçek dosya konumlarınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi dokümantasyona bakın veya destek ekibi ile iletişime geçin.

cURL ve REST API Kullanarak HTML’yi PNG’ye Dönüştürme

Aşağıdaki cURL komutları, Aspose.HTML Cloud REST API’sini kullanarak aynı HTML’den PNG’ye dönüşümü nasıl gerçekleştireceğinizi gösterir.

  1. Erişim belirteci alın (yer tutucuları istemci kimlik bilgilerinizle değiştirin).
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. Kaynak HTML dosyasını depoya yükleyin.
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. PNG’ye dönüştürme isteği.
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. Oluşturulan PNG dosyasını indirin.
curl -X GET "https://api.aspose.cloud/v4.0/html/storage/file/sample.png" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample.png

Parametrelerin tam listesi ve ek seçenekler için, resmi API belgelerine bakın.

Aspose.HTML Cloud SDK for PHP için Önkoşullar ve Kurulum

Başlamadan önce, şunların olduğundan emin olun:

  • PHP 7.4 veya daha yeni bir sürüm yüklü.
  • Geliştirme makinenizde Composer yüklü.
  • Geçerli AppSid ve AppKey içeren bir Aspose Cloud hesabı.

Composer kullanarak SDK’yı kurun:

composer require aspose-html-cloud

En son paketi resmi sürüm sayfasından indirebilirsiniz: Aspose.HTML Cloud SDK for PHP Release.

Kimlik bilgilerinizi adımlar bölümünde gösterildiği gibi yapılandırın, ardından HTML’yi PNG’ye dönüştürmeye hazırsınız.

Sonuç

HTML’yi PNG’ye dönüştürmek PHP’de Aspose.HTML Cloud SDK for PHP ile zahmetsiz hale gelir. Kütüphane, sunucu tarafında renderlama, ölçekleme ve görüntü optimizasyonunu yönetir, böylece bir tarayıcı veya harici araçlara ihtiyaç kalmaz. Adım adım rehberi izleyerek, küçük resim oluşturma, e-posta renderlama veya rapor oluşturma gibi amaçlarla herhangi bir PHP uygulamasına yüksek kaliteli PNG üretimini entegre edebilirsiniz. Üretim kullanımı için uygun bir lisans almayı unutmayın; fiyatlandırma detayları ürün sayfasında mevcuttur ve kütüphaneyi değerlendirirken geçici lisans sayfasından geçici bir lisans alabilirsiniz.

SSS

  • HTML’den PNG’ye PHP’de tarayıcı olmadan nasıl çalışır?
    Aspose.HTML Cloud SDK for PHP, HTML’yi kendi render motoru ile sunucuda işler, bu yüzden tarayıcı veya headless Chrome gerekmez.

  • Görüntü boyutlarını ve kalitesini kontrol edebilir miyim?
    Evet. ConvertOptions sınıfını kullanarak genişlik, yükseklik, kalite (0‑100) ve arka plan rengini Convert API’sini çağırmadan önce ayarlayabilirsiniz.

  • Birden fazla HTML dosyasını toplu olarak PNG’ye dönüştürmek mümkün mü?
    Kesinlikle. Dosya listeniz üzerinden döngü kurun, aynı ConvertApi örneğini yeniden kullanın ve her yineleme için giriş ve çıkış yollarını ayarlayın.

  • Ticari projeler için hangi lisans gereklidir?
    Üretim için ücretli bir lisans gereklidir. Ürün sayfasında fiyatlandırmayı görebilir ve geçici lisans sayfasından geçici bir değerlendirme lisansı alabilirsiniz.

Read More