إنشاء HTML إلى PNG في PHP هو احتياج شائع لإنشاء الصور المصغرة، ومعاينات البريد الإلكتروني، والتقارير. Aspose.HTML Cloud SDK for PHP يوفر مكتبة قوية تجعل التحويل من جانب الخادم بسيطًا. في هذا الدليل ستتعلم كيفية إعداد SDK، وتكوين خيارات التحويل، وتشغيل مثال كامل للكود، وأداء نفس المهمة باستخدام استدعاءات cURL REST لتدفقات العمل المؤتمتة.
تحويل 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. -
هل من الممكن تحويل عدة ملفات HTML إلى PNG دفعة واحدة؟
بالتأكيد. قم بالتكرار عبر قائمة الملفات الخاصة بك، وأعد استخدام نفس كائنConvertApi، وقم بضبط مسارات الإدخال والإخراج لكل تكرار. -
ما الترخيص المطلوب للمشاريع التجارية؟
يلزم الحصول على ترخيص مدفوع للإنتاج. يمكنك الاطلاع على الأسعار في صفحة المنتج والحصول على ترخيص تقييم مؤقت من صفحة رخصة مؤقتة.