HTML‑ის HTML‑დან PNG‑ში გენერირება PHP-ში საერთო მოთხოვნაა მინიატურების, ელ‑ფოსტის წინასწარ ნახვების და ანგარიშების შესაქმნელად. Aspose.HTML Cloud SDK for PHP უზრუნველყოფს ძლიერი ბიბლიოთეკას, რომელიც სერვერზე‑მდებარებული კონვერსია მარტივად აკეთებს. ამ გიდში თქვენ გაიგებთ, როგორ დაინსტალიროთ SDK, კონფიგურიროთ კონვერსიის პარამეტრები, გაუშვათ სრულყოფილი კოდის მაგალითი, და როგორ შესრულოთ იგივე დავალება cURL REST მოთხოვნებით ავტომატიზებული სამუშაო ნაკადებისთვის.

HTML-დან PNG ფორმატში გადაყვანა PHP-ში - ნაბიჯნაბიჯ გიდი

  1. SDK-ის დაყენება Composer-ის საშუალებით: გამოიყენეთ ოფიციალური Composer-ის ბრძანება ბიბლიოთეკის თქვენს პროექტში დასამატებლად.
composer require aspose-html-cloud
  1. აკონფიგურირეთ თქვენი Aspose Cloud ავტორიზაციის დეტალები: შექმენით Configuration ობიექტი და დააყენეთ თქვენი AppSid და AppKey.
$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setAppKey('YOUR_APP_KEY');
  1. Convert API-ის ინიციალიზაცია: ConvertApi-ის ინსტანციირება კონფიგურაციის ობიექტის საშუალებით.
$convertApi = new ConvertApi($config);
  1. გადაყვანის პარამეტრების დაყენება: განსაზღვრეთ გამოსავალის ფორმატი, ზომები, ხარისხი და ფონის ფერი ConvertOptions-ის გამოყენებით.
$options = new ConvertOptions();
$options->setOutputFormat('png');
$options->setWidth(1024);
$options->setHeight(0);               // Preserve aspect ratio
$options->setQuality(90);
$options->setBackgroundColor('#FFFFFF');
  1. გადაყვანის შესრულება: გამოძახეთ convertLocal წყარო HTML ფაილით და სამიზნე PNG ბილიკით.
try {
    $convertApi->convertLocal($inputHtmlPath, $outputPngPath, $options);
    echo "Conversion successful: {$outputPngPath}\n";
} catch (Exception $e) {
    echo "Conversion failed: " . $e->getMessage() . "\n";
}

კლასის და მეთოდის დეტალური ინფორმაციისთვის მიმართეთ API მითითება.

HTML-დან PNG-ში PHP - სრული კოდის მაგალითი

ეს მაგალითი აჩვენებს, როგორ გადაყვანა ლოკალური HTML ფაილი PNG სურათად 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
// -----------------------------------------------------------------------------
?>

შენიშვნა: ეს კოდის მაგალითი აჩვენებს ძირითადი ფუნქციონირებას. პროექტში მისი გამოყენებამდე, დარწმუნდით, რომ განაახლეთ ფაილების ბილიკები (sample.html, sample.png, ა.შ.) თქვენი რეალური ფაილების მდებარეობებთან, გადაამოწმეთ, რომ ყველა საჭირო დამოკიდებულება სწორად დაინსტალირებულია, და სრულად დატესტეთ თქვენი განვითარების გარემოში. თუ რაიმე პრობლემა გაქვთ, გთხოვთ მიმართოთ ოფიციალურ დოკუმენტაციას ან დაუკავშირდეთ მხარდაჭერის გუნდს დახმარებისთვის.

HTML-ის PNG-ზე გადაყვანა cURL-ისა და REST API-ის გამოყენებით

შემდეგი cURL ბრძანებები აჩვენებს, როგორ შეიძლება იგივე HTML‑დან PNG ფორმატში გადაყვანა Aspose.HTML Cloud REST API-ის გამოყენებით.

  1. წვდომის კოდის მიღება (შეცვალეთ ადგილმყოფები თქვენი კლიენტის ავტორიზაციის დეტალებით).
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. ატვირთეთ წყაროს HTML ფაილი შენახვის ადგილას.
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 ფორმატში გადაყვანის.
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. გადმოწერეთ გენერირებული PNG ფაილი.
curl -X GET "https://api.aspose.cloud/v4.0/html/storage/file/sample.png" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample.png

პარამეტრების სრულ სია და დამატებითი არჩევანისთვის იხილეთ ოფიციალური API დოკუმენტაცია.

მოთხოვნები და დაყენება Aspose.HTML Cloud SDK for PHP-ისთვის

დაწყებამდე, დარწმუნდით, რომ გაქვთ:

  • PHP 7.4 ან უფრო ახალი დაყენებულია.
  • Composer დაყენებულია თქვენი განვითარების მანქანაზე.
  • Aspose Cloud ანგარიში, რომელშიც მოქმედი AppSid და AppKey არსებობს.

დააყენეთ SDK Composer-ის გამოყენებით:

composer require aspose-html-cloud

თქვენ შეგიძლიათ გადმოწეროთ უახლესი პაკეტი ოფიციალური გამოშვების გვერდიდან: Aspose.HTML Cloud SDK for PHP Release.

აკონფიგურირეთ თქვენი ავტორიზაციის დეტალები, როგორც ნაჩვენებია ნაბიჯების განყოფილებაში, შემდეგ თქვენ მზად იქნებით HTML-ის PNG ფორმატში გადაყვანის დაწყებისთვის.

დასკვნა

HTML-ის PNG ფორმატში გადაყვანა PHP-ში ხდება ადვილი Aspose.HTML Cloud SDK for PHP-ის დახმარებით. ბიბლიოთეკა მართავს რენდერს, მასშტაბირებას და გამოსახულებების ოპტიმიზაციას სერვერის მხარეს, რაც აცილებს ბრაუზერის ან გარე ინსტრუმენტების საჭიროობას. ნაბიჯ‑ნაბიჯ სახელმძღვანელოს მიყოლებით, შეგიძლიათ ინტეგრიროთ მაღალი ხარისხის PNG გენერაცია ნებისმიერი PHP აპლიკაციაში, თუ ეს იყოს მინიატურების შექმნა, ელ‑ფოსტის რენდერი ან ანგარიშის გენერაცია. დამახსოვრეთ, რომ მიიღოთ შესაბამისი ლიცენზია პროდუქციის გამოყენებისთვის; ფასის დეტალები ხელმისაწვდომია პროდუქტის გვერდზე, ხოლო დროებითი ლიცენზია შეიძლება მიიღოთ დროებითი ლიცენზიის გვერდიდან ბიბლიოთეკის შეფასებისას.

ხშირად დასმული კითხვები

  • HTML‑ის PNG ფორმატში გადაყვანა PHP-ში როგორ მუშაობს ბრაუზერის გარეშე?
    Aspose.HTML Cloud SDK for PHP HTML‑ის რენდერირებას აკეთებს თავისი რენდერინგის ძრავით სერვერზე, ამიტომ ბრაუზერი ან headless Chrome არ არის საჭირო.

  • მიძლია თუ არა სურათის ზომებისა და ხარისხის კონტროლირება?
    დიახ. გამოიყენეთ ConvertOptions კლასი, რათა განსაზღვროთ სიგანე, სიმაღლე, ხარისხი (0‑100) და ფონის ფერი, სანამ Convert API-ს გამოძახებთ.

  • შესაძლებელია მრავალ HTML ფაილის ერთდროულად PNG ფორმატში გადაყვანა?
    აბსოლუტურად. გადახედეთ თქვენი ფაილების სიას, თავიდან გამოიყენეთ იგივე ConvertApi ინსტანცია და თითოეული იტერაციისთვის შეცვალეთ შეყვანის და გამოტანის გზები.

  • კომერციული პროექტებისთვის რა ლიცენზია საჭიროა?
    წარმოებაში გადახდილი ლიცენზია აუცილებელია. ფასები შეგიძლიათ ნახოთ პროდუქტის გვერდზე და დროებით შეფასების ლიცენზია მიიღოთ დროებითი ლიცენზიის გვერდიდან.

მეტი