2. إعداد بيئة التطوير

تمت كتابة البرامج النصية واختبارها في البيئة التالية:

بيئة خادم ويب Apache / نظام إدارة قواعد البيانات MySQL / PHP 7.3 تسمى Laragon؛
بيئة تطوير NetBeans 10.0؛

2.1. تثبيت Laragon

Laragon عبارة عن حزمة تجمع بين عدة مكونات برمجية:

خادم ويب Apache. سنستخدمه لكتابة نصوص ويب بلغة PHP؛
نظام إدارة قواعد البيانات MySQL؛
لغة البرمجة النصية PHP؛
خادم Redis الذي يوفر التخزين المؤقت لتطبيقات الويب:

يمكن تنزيل Laragon (مارس 2019) من العنوان التالي:

https://laragon.org/download/

ينتج عن التثبيت [1-5] هيكل الدليل التالي:

في [6] مجلد تثبيت PHP؛

يؤدي تشغيل [Laragon] إلى عرض النافذة التالية:

[1]: القائمة الرئيسية لـ Laragon؛
[2]: زر [Start All] (تشغيل الكل) يقوم بتشغيل خادم الويب Apache وقاعدة بيانات MySQL؛
[3]: يعرض زر [WEB] صفحة الويب [http://localhost]، والتي تتوافق مع ملف PHP [<laragon>/www/index.php]، حيث <laragon> هو مجلد تثبيت Laragon؛
[4]: يتيح لك زر [Database] إدارة قاعدة بيانات MySQL باستخدام أداة [phpMyAdmin]. يجب تثبيت هذه الأداة مسبقًا؛
[5]: يفتح زر [Terminal] محطة أوامر؛
[6]: يفتح زر [Root] نافذة Windows Explorer في مجلد [<laragon>/www]، وهو الدليل الجذر لموقع الويب [http://localhost]. هذا هو المكان الذي يجب أن تضع فيه جميع تطبيقات الويب التي يديرها خادم Apache الخاص بـ Laragon؛

لنفتح محطة Laragon [5]:

في [1]، نوع المحطة الطرفية. تتوفر ثلاثة أنواع من المحطات الطرفية في [6]؛
في [2، 3]: الدليل الحالي؛
في [4]، اكتب الأمر [echo %PATH%]، الذي يعرض قائمة الدلائل التي يتم البحث فيها عند البحث عن ملف قابل للتنفيذ. يتم تضمين جميع المجلدات الرئيسية لـ Laragon في مسار الملفات القابلة للتنفيذ هذا، وهو ما لن يحدث إذا فتحت نافذة موجه الأوامر [cmd] في Windows. في هذا المستند، عندما يُطلب منك كتابة أوامر لتثبيت برنامج معين، يتم كتابة هذه الأوامر عمومًا في محطة Laragon؛

2.2. تثبيت NetBeans 10.0 IDE

يمكن تنزيل NetBeans 10.0 IDE من العنوان التالي (مارس 2019):

https://netbeans.apache.org/download/index.HTML

الملف الذي تم تنزيله هو ملف ZIP يحتاج فقط إلى فك ضغطه. بمجرد تثبيت NetBeans وتشغيله، يمكنك إنشاء أول مشروع PHP الخاص بك.

في [1]، حدد خيار File / New Project (ملف / مشروع جديد)؛
في [2]، حدد فئة [PHP]؛
في [3]، حدد نوع المشروع [PHP Application]؛

في [4]، قم بتسمية المشروع؛
في [5]، اختر مجلدًا للمشروع؛
في [6]، حدد إصدار PHP الذي تم تنزيله؛
في [7]، حدد ترميز UTF-8 لملفات PHP؛
في [8]، حدد وضع [Script] لتشغيل نصوص PHP في وضع سطر الأوامر. حدد [Local WEB Server] لتشغيل نص PHP في بيئة ويب؛
في [9،10]، حدد دليل التثبيت لمترجم PHP الخاص بحزمة Laragon:

اختر [إنهاء] لإكمال معالج إنشاء مشروع PHP؛

في [11]، يتم إنشاء المشروع مع ملف [index.php]؛
في [12]، اكتب نص برمجي PHP بسيط؛
في [13]، قم بتشغيل [index.php]؛

في [14]، النتائج في نافذة [output] في NetBeans؛
في [15]، قم بإنشاء نص برمجي جديد؛
في [16]، البرنامج النصي الجديد؛

يمكن للقارئ إنشاء جميع البرامج النصية التالية في مجلدات مختلفة ضمن نفس مشروع PHP. يتوفر كود المصدر للبرامج النصية الواردة في هذا المستند في بنية دليل NetBeans التالية:

توجد البرامج النصية في هذا المستند في دليل مشروع [scripts-console] [1]. سنستخدم أيضًا مكتبات PHP التي سيتم وضعها في المجلد [<laragon-lite>/www/vendor] [2]، حيث <laragon-lite> هو دليل التثبيت لبرنامج Laragon. لكي يتعرف NetBeans على المكتبات الموجودة في [2] كجزء من مشروع [scripts-console]، نحتاج إلى تضمين المجلد [vendor] [2] في [مسار التضمين] [3] للمشروع. سنقوم بتكوين NetBeans بحيث يتم تضمين المجلد [<laragon-lite>/www/vendor] [2] في كل مشروع PHP جديد، وليس فقط في مشروع [scripts-console]:

في [1-2]، انتقل إلى خيارات NetBeans؛
في [3-4]، قم بتكوين خيارات PHP؛
في [5-7]، قم بتكوين [مسار التضمين العام] لـ PHP: يتم تضمين المجلدات المدرجة في [7] تلقائيًا في [مسار التضمين] لكل مشروع PHP؛

في [9]، قم بالوصول إلى خصائص فرع [مسار التضمين]؛
في [10-11]، المكتبات الجديدة التي استكشفها NetBeans. يقوم NetBeans بمسح كود PHP في هذه المكتبات وتخزين فئاتها وواجهاتها ووظائفها وما إلى ذلك، من أجل تقديم المساعدة للمطور؛

في [12]، يستخدم مقتطف كود فئة [PhpMimeMailParser\Parser] من مكتبة [vendor/php-mime-mail-parser]؛
في [13]، يقترح NetBeans أساليب هذه الفئة؛
في [14-15]، يعرض NetBeans الوثائق الخاصة بالطريقة المحددة؛

مفهوم [مسار التضمين] خاص بـ NetBeans. يوجد هذا المفهوم في PHP أيضًا، لكنهما، من حيث المبدأ، مفهومان مختلفان.

الآن بعد أن تم إعداد بيئة التطوير، يمكننا تغطية أساسيات PHP.