مكتبة PHP مجانية لإنشاء ملفات PDF من HTML
واجهة برمجة تطبيقات PHP مفتوحة المصدر لإنشاء مستندات PDF من محتوى HTML. تدعم تحويل HTML وCSS إلى PDF عبر كود PHP.
في عصرنا الرقمي اليوم، أصبحت القدرة على إنشاء مستندات PDF بشكل ديناميكي مطلبًا حيويًا للعديد من تطبيقات الويب. سواء كان ذلك لإنشاء الفواتير أو التقارير أو المحتوى القابل للطباعة، فإن وجود مكتبة موثوقة وفعّالة لتوليد PDF أمر أساسي. إحدى هذه المكتبات التي اكتسبت شعبية بين المتخصصين في البرمجيات والمبرمجين هي Dompdf. تحتوي على دعم مدمج للـ Unicode، مما يتيح إنشاء ملفات PDF بلغات ومجموعات أحرف مختلفة. يمكنها التعامل مع النصوص المعقدة مثل العربية والصينية والسيريلية، مما يضمن عرضًا دقيقًا للمحتوى متعدد اللغات.
دومبدف سهل الاستخدام للغاية ويسهل عملية إنشاء مستندات PDF من محتوى HTML. توفر المكتبة العديد من الميزات المتقدمة لتخصيص وتعزيز عملية إنشاء PDF الخاصة بك. هناك عدة ميزات مهمة في المكتبة، مثل التعامل مع معظم خصائص CSS 2.1 وبعض خصائص CSS3، إضافة الصور إلى PDF، دعم سمات HTML 4.0 التقديمية، إضافة رؤوس وتذييلات إلى ملفات PDF، التحكم في فواصل الصفحات باستخدام CSS، إدراج جدول محتويات، استخدام العلامات المرجعية في ملفات PDF، دعم PHP المضمن والعديد غير ذلك.
Dompdf هي مكتبة PHP تسمح لمطوري البرمجيات بإنشاء مستندات PDF من محتوى HTML. تستفيد من قوة امتداد PHP DOM ومحددات CSS2.1 لتجسيد HTML و CSS بدقة إلى صيغة PDF. إنها مشروع مفتوح المصدر ويتم صيانته بنشاط على GitHub، مما يجعله خيارًا موثوقًا لإنشاء PDF في تطبيقات PHP. يقدم خيارات تكوين متعددة لضبط عملية إنشاء PDF، مثل إعدادات حجم الصفحة، الهوامش، محتوى الرأس والتذييل، الضغط، والمزيد، وفقًا لمتطلبات المستخدمين المحددة. مجموعة ميزاته القوية، بما في ذلك دعم تجسيد HTML و CSS، إنشاء محتوى ديناميكي، دعم متعدد اللغات، وخيارات التخصيص، تجعلها خيارًا شائعًا بين مطوري ومهندسي البرمجيات.
البدء مع Dompdf
الطريقة الموصى بها والأسهل لتثبيت Dompdf هي استخدام Composer، أداة إدارة الاعتمادات لـ PHP. يرجى استخدام الأمر التالي لتثبيت سلس.
تثبيت Dompdf عبر Composer
composer require dompdf/dompdf يمكنك أيضًا تثبيته يدويًا؛ قم بتنزيل أحدث ملفات الإصدار مباشرةً من مستودع GitHub.
عرض HTML و CSS عبر واجهة برمجة تطبيقات PHP
تسهل مكتبة Dompdf المفتوحة المصدر على مطوري البرمجيات تحميل وعرض ملفات HTML وCSS دون أي تبعيات خارجية. تدعم مجموعة واسعة من ميزات HTML وCSS، مما يجعلها قادرة على عرض تخطيطات وتنسيقات معقدة. تدعم معظم محددات CSS2.1، بما في ذلك الميزات المتقدمة مثل استعلامات وسائط CSS، inline-block، عرض الجداول، والمزيد. كما تدعم الجداول المعقدة، بما في ذلك امتدادات الصفوف والأعمدة، نماذج الحدود المنفصلة والمدمجة، تنسيق الخلايا الفردية وما إلى ذلك. يوضح المثال التالي كيفية تحميل محتوى HTML وتحويله إلى ملف PDF وحفظه في المكان الذي تختاره.
كيفية تحميل محتوى HTML وتحويله إلى PDF عبر كود PHP؟
require_once 'vendor/autoload.php';
use Dompdf\Dompdf;
$dompdf = new Dompdf();
// Load the HTML content you wish to convert to a PDF
$html = 'مرحبًا، dompdf!
';
$dompdf->loadHtml($html);
// Customize the PDF generation settings:
$dompdf->setPaper('A4', 'portrait');
// Render the PDF
$dompdf->render();
// Save the PDF to a file
$dompdf->stream('document.pdf');
// Output the PDF directly to the browser
$dompdf->stream();
إضافة رؤوس وتذييلات إلى PDF عبر PHP
الرؤوس والتذييلات جزء مهم جدًا من مستندات PDF، حيث تسمح لمطوري البرمجيات بإدراج النصوص والصور وملفات PDF الأخرى في صفحة واحدة أو أكثر داخل مستند PDF. عادةً ما تُستخدم الرؤوس والتذييلات للإعلان عن ملكية المستند. تجعل مكتبة Dompdf المفتوحة المصدر من السهل على مطوري البرمجيات إدراج الرؤوس والتذييلات داخل تطبيقاتهم PHP ببضع أسطر من الشيفرة فقط. يمكن للمطورين إضافة الرؤوس والتذييلات إلى مستندات PDF الخاصة بهم باستخدام طريقتي setHtmlHeader() و setHtmlFooter(). يمكن أن تحتوي هذه الأقسام على محتوى HTML، ويمكنك استخدام تنسيق CSS لتخصيص مظهرها.
تخصيص PDF، دعم جدول المحتويات والإشارات المرجعية
توفر مكتبة Dompdf عدة ميزات متقدمة تسمح لمطوري البرمجيات بتخصيص وتعزيز عملية إنشاء ملفات PDF. تدعم المكتبة إدراج الصور والخطوط في ملفات PDF، ويمكن استخدام عناوين URL المطلقة أو توفير مسار الملف المحلي. تأكد من أن الصور متاحة للخادم. بالنسبة للخطوط المخصصة، يدعم dompdf تضمين ملفات الخطوط TrueType (.ttf) و OpenType (.otf). كما أنه من السهل جدًا إنشاء جدول محتويات أو إضافة إشارات مرجعية إلى مستندات PDF الخاصة بك.
