יצירת HTML ל-PNG ב-PHP היא צורך נפוץ ליצירת תמונות ממוזערות, תצוגות מקדימות של אימיילים ודוחות. Aspose.HTML Cloud SDK for PHP מספק ספרייה חזקה שמפשטת המרה בצד השרת. במדריך זה תלמדו כיצד להגדיר את ה‑SDK, להגדיר אפשרויות המרה, להריץ דוגמת קוד מלאה, ולבצע את אותה משימה באמצעות קריאות REST של cURL לעבודה אוטומטית.
המרת HTML ל-PNG ב-PHP - מדריך שלב אחר שלב
- התקנת ה‑SDK באמצעות Composer: השתמשו בפקודת Composer הרשמית כדי להוסיף את הספרייה לפרויקט שלכם.
composer require aspose-html-cloud
- הגדר את אישורי Aspose Cloud שלך: צור אובייקט
Configurationוהגדר אתAppSidו‑AppKeyשלך.
$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setAppKey('YOUR_APP_KEY');
- אתחול ה-Convert API: צור מופע של
ConvertApiעם אובייקט התצורה.
$convertApi = new ConvertApi($config);
- הגדרת אפשרויות המרה: הגדר פורמט פלט, ממדים, איכות וצבע רקע באמצעות
ConvertOptions.
$options = new ConvertOptions();
$options->setOutputFormat('png');
$options->setWidth(1024);
$options->setHeight(0); // Preserve aspect ratio
$options->setQuality(90);
$options->setBackgroundColor('#FFFFFF');
- בצע את ההמרה: קרא ל-
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.
- קבל אסימון גישה (החלף מצייני מקום עם פרטי האימות של הלקוח שלך).
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"
- העלה את קובץ ה-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"
- בקש את ההמרה ל‑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"}'
- הורד את קובץ 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 באמצעות מנוע הרינדור שלו על השרת, ולכן אין צורך בדפדפן או ב‑Chrome ללא ראש. -
האם אני יכול לשלוט במימדי התמונה ובאיכות?
כן. השתמש במחלקתConvertOptionsכדי להגדיר רוחב, גובה, איכות (0‑100) וצבע רקע לפני קריאת ה-Convert API. -
האם ניתן לבצע המרה קבוצתית של קבצי HTML מרובים ל-PNG?
בהחלט. יש לעבור על רשימת הקבצים שלך, להשתמש באותו מופע שלConvertApi, ולהתאים את נתיבי הקלט והפלט לכל איטרציה. -
מה רישיון נדרש לפרויקטים מסחריים?
נדרש רישיון בתשלום לשימוש בייצור. ניתן לצפות בתמחור בדף המוצר ולקבל רישיון הערכה זמני מדף דף רישיון זמני.