كيفية إنشاء ملفات PDF باستخدام PHP

تمت الكتابة بواسطة: عبد الحكيم

تارخ آخر تحديث: 18 سبتمبر 2024

محتوى المقال

استخدام مكتبة FPDF لإنشاء ملفات PDF
إخراج ملف PDF إلى المتصفح أو تخزينه
إنشاء جداول في ملفات PDF
الخلاصة

تُعد ملفات PDF واحدة من أكثر الصيغ شيوعًا لتوزيع المستندات الإلكترونية عبر الإنترنت. يتم استخدامها على نطاق واسع لمشاركة المستندات بشكل آمن وسهل. باستخدام PHP، يمكنك إنشاء ملفات PDF ديناميكيًا من بيانات أو محتويات معينة. في هذا المقال، سنستعرض كيفية إنشاء ملفات PDF باستخدام PHP مع أمثلة توضيحية خطوة بخطوة.

استخدام مكتبة FPDF لإنشاء ملفات PDF

أشهر مكتبة لإنشاء ملفات PDF باستخدام PHP هي مكتبة FPDF. إنها مكتبة مفتوحة المصدر وسهلة الاستخدام لإنشاء ملفات PDF ديناميكيًا. توفر FPDF الكثير من الوظائف لإنشاء ملفات PDF احترافية.

في هذا الدليل، سنقوم بالخطوات التالية:

تنزيل وتثبيت مكتبة FPDF
إنشاء ملف PDF بسيط
إضافة نصوص وصور إلى ملف PDF
إعداد تنسيقات مختلفة في ملف PDF

1. تنزيل وتثبيت مكتبة FPDF

للبدء، قم بتنزيل مكتبة FPDF من الموقع الرسمي FPDF.org. بعد تنزيل المكتبة، ضع الملفات داخل مجلد مشروع PHP الخاص بك.

الآن، نحن جاهزون لكتابة بعض الأكواد. قم بإنشاء ملف PHP جديد في مجلد مشروعك واسمه generate_pdf.php.


        <?php

        // استيراد مكتبة FPDF

        require 'fpdf.php';



        // إنشاء كائن FPDF

        $pdf = new FPDF();

        $pdf->AddPage();

        $pdf->SetFont('Arial','B',16);



        // إضافة نص إلى ملف PDF

        $pdf->Cell(40,10,'مرحبًا بك في ملف PDF!' );



        // إخراج ملف PDF في المتصفح

        $pdf->Output();

        ?>

2. إنشاء ملف PDF بسيط

في الكود أعلاه، قمنا بتحميل مكتبة FPDF أولاً، ثم قمنا بإنشاء كائن PDF جديد باستخدام $pdf = new FPDF();. بعد ذلك، أضفنا صفحة باستخدام $pdf->AddPage();، وحددنا نوع الخط وحجمه باستخدام $pdf->SetFont('Arial', 'B', 16);. أخيرًا، قمنا بإضافة نص باستخدام $pdf->Cell(40,10,'مرحبًا بك في ملف PDF!');.

إذا قمت بتشغيل هذا الملف في المتصفح، سيظهر لك ملف PDF يحتوي على النص "مرحبًا بك في ملف PDF!" معروضًا في المتصفح.

3. إضافة نصوص وصور إلى ملف PDF

FPDF تدعم إضافة النصوص، الصور، الروابط والجداول إلى ملفات PDF. هنا مثال لإضافة صورة إلى ملف PDF.


        <?php

        // إضافة صورة إلى ملف PDF

        $pdf->Image('path_to_image.jpg',$x,$y,$w,$h);

        ?>

في هذا المثال، استخدمنا الدالة $pdf->Image() لإضافة صورة إلى ملف PDF. يجب أن تحدد مسار الصورة، الإحداثيات $x و$y، وعرض وارتفاع الصورة.

4. إعداد تنسيقات مختلفة في ملف PDF

توفر FPDF خيارات متعددة لتنسيق النصوص، مثل الخط العريض، المائل، والمحاذاة. إليك كيفية استخدام بعض هذه التنسيقات:


        <?php

        // إعداد خط مائل

        $pdf->SetFont('Arial','I',12);

        $pdf->Cell(40,10,'نص مائل' );



        // إعداد خط عريض

        $pdf->SetFont('Arial','B',12);

        $pdf->Cell(40,10,'نص عريض' );


        ?>

كما ترى، يمكنك بسهولة التحكم في مظهر النصوص داخل ملف PDF باستخدام FPDF. يمكنك أيضًا تعديل المحاذاة (يسار، وسط، يمين) باستخدام المعاملات المختلفة داخل الدوال.

إخراج ملف PDF إلى المتصفح أو تخزينه

يمكنك استخدام دالة Output لإخراج ملف PDF إلى المتصفح أو لتخزينه في خادم الويب الخاص بك. إليك كيف يمكنك حفظ ملف PDF بدلاً من عرضه في المتصفح:


        <?php

        // حفظ ملف PDF باسم "myfile.pdf"

        $pdf->Output('F', 'myfile.pdf');

        ?>

يمكنك أيضًا إخراج الملف مباشرة كتحميل للمستخدم عبر المتصفح باستخدام المعامل 'D' بدلاً من 'F'.

إنشاء جداول في ملفات PDF

لإضافة جدول إلى ملف PDF، ستحتاج إلى رسم الخلايا يدويًا باستخدام Cell أو MultiCell. إليك مثال على كيفية إضافة جدول بسيط:


        <?php

        // إضافة جدول بسيط

        $pdf->SetFont('Arial','B',12);

        $pdf->Cell(40,10,'العنوان',1);

        $pdf->Cell(40,10,'القيمة',1);

        $pdf->Ln();



        $pdf->SetFont('Arial','',12);

        $pdf->Cell(40,10,'اسم المنتج',1);

        $pdf->Cell(40,10,'100',1);

        $pdf->Ln();

        ?>

في هذا المثال، قمنا بإنشاء خلايا باستخدام Cell مع تمرير القيم والمعاملات المناسبة لإنشاء جدول بسيط. قمنا أيضًا باستخدام Ln للانتقال إلى سطر جديد.

الخلاصة

توفر PHP مع مكتبة FPDF وسيلة قوية لإنشاء ملفات PDF ديناميكيًا. سواء كنت تحتاج إلى توليد تقارير، فواتير، أو مستندات رسمية، يمكنك بسهولة تخصيص ملفات PDF وإضافة النصوص، الصور، الجداول، وغيرها. تعد هذه المكتبة بسيطة ومرنة وتتيح لك التحكم الكامل في تخطيط ومحتوى ملفات PDF الخاصة بك.

نأمل أن يكون هذا الدليل قد قدم لك بداية قوية لتعلم كيفية إنشاء ملفات PDF باستخدام PHP. إذا كنت ترغب في مزيد من التخصيصات أو العمل على مشاريع أكثر تعقيدًا، فإن مكتبة FPDF لديها الكثير لتقدمه لك في هذا الصدد.