تثبيت Dompdf على AlmaLinux 8 باستخدام Virtualmin

تثبيت Dompdf على AlmaLinux 8 باستخدام Virtualmin

في هذا المقال، سنقوم بشرح خطوات تثبيت مكتبة Dompdf على نظام AlmaLinux 8 وإعدادها للاستخدام مع Virtualmin. Dompdf هي مكتبة PHP شهيرة تُستخدم لتحويل HTML إلى PDF.

المتطلبات:

• نظام AlmaLinux 8 مع صلاحيات الروت أو sudo.
• Virtualmin مثبت ومُعد مسبقًا.
• PHP و Composer مثبتان.

الخطوة الأولى: تثبيت PHP والإضافات المطلوبة

أولاً، تأكد من أن PHP مثبت. تتطلب Dompdf إصدار PHP 7.1 أو أحدث.

1. تحديث قائمة الحزم على النظام:

   sudo dnf update -y

2. تثبيت PHP والإضافات المطلوبة:

   sudo dnf install -y php php-cli php-mbstring php-xml php-gd php-json

الخطوة الثانية: تثبيت Composer

Composer هو مدير الحزم الخاص بـ PHP، وهو ضروري لتثبيت Dompdf.

1. تنزيل وتثبيت Composer:

   php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
   php composer-setup.php --install-dir=/usr/local/bin --filename=composer
   php -r "unlink('composer-setup.php');"

2. التحقق من تثبيت Composer:

   composer --version

الخطوة الثالثة: تثبيت Dompdf

الآن، استخدم Composer لتثبيت مكتبة Dompdf.

1. انتقل إلى دليل المشروع الخاص بك أو أنشئ دليلاً جديدًا:

   mkdir -p /home/your-username/your-project
   cd /home/your-username/your-project

2. تثبيت Dompdf باستخدام Composer:

   composer require dompdf/dompdf

الخطوة الرابعة: إعداد Virtualmin للمشروع

تأكد من أن Virtualmin مُعد لتقديم مشروعك.

1. تسجيل الدخول إلى Virtualmin.
2. اختيار النطاق الذي تريد إعداد Dompdf تحته.
3. الانتقال إلى إعدادات الخادم > إصدارات PHP والتأكد من اختيار إصدار PHP المناسب.
4. الانتقال إلى الخدمات > تكوين الموقع والتأكد من أن جذر المستند مضبوط إلى دليل مشروعك.

الخطوة الخامسة: اختبار تثبيت Dompdf

إنشاء ملف PHP بسيط لاختبار Dompdf.

1. انتقل إلى جذر الويب لمشروعك:

   cd /home/your-username/your-project/public_html

2. إنشاء ملف اختبار باسم test_dompdf.php:

   <?php
   require 'vendor/autoload.php';
   
   use Dompdf\Dompdf;
   
   $dompdf = new Dompdf();
   $dompdf->loadHtml('hello world');
   
   // (اختياري) إعداد حجم الورق والاتجاه
   $dompdf->setPaper('A4', 'portrait');
   
   // تحويل HTML إلى PDF
   $dompdf->render();
   
   // عرض PDF المُنشأ في المتصفح
   $dompdf->stream();
   ?>

3. الوصول إلى الملف عبر المتصفح:

   http://your-domain.com/test_dompdf.php

إذا كان كل شيء مضبوطًا بشكل صحيح، يجب أن ترى ملف PDF يتم عرضه بمحتوى "hello world".

الخطوة السادسة: تأمين التثبيت الخاص بك

1. إزالة أو حماية ملف الاختبار بعد التحقق من التثبيت:

   rm /home/your-username/your-project/public_html/test_dompdf.php

الخاتمة

بتتبع هذه الخطوات، ستكون قد قمت بتثبيت Dompdf وإعداده على خادم AlmaLinux 8 باستخدام Virtualmin. الآن يمكنك البدء في استخدام Dompdf لتحويل صفحات HTML إلى ملفات PDF بسهولة.