2. إعداد بيئة العمل

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

بيئة خادم ويب Apache / SGBD MySQL / PHP 7.3 تسمى Laragon؛
بيئة تطوير NetBeans 10.0 IDE؛

2.1. تثبيت Laragon

Laragon عبارة عن حزمة تضم عدة برامج:

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

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

https://laragon.org/download/

يؤدي التثبيت [1-5] إلى إنشاء الشجرة التالية:

في [6] مجلد التثبيت الخاص بـ PHP؛

عند تشغيل [Laragon]، تظهر النافذة التالية:

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

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

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

2.2. تثبيت IDE NetBeans 10.0

يمكن تنزيل IDE NetBeans 10.0 من العنوان التالي (مارس 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:

اختر [Finish] لإنهاء معالج إنشاء المشروع 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] في الفرع [Include Path] [3] للمشروع. سنقوم بتكوين Netbeans بحيث يتم تضمين المجلد [<laragon-lite>/www/vendor] [2] في أي مشروع جديد PHP وليس فقط في المشروع [scripts-console]:

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

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

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

مفهوم [Include Path] هنا خاص بـ Netbeans. PHP لديه هذا المفهوم أيضًا، لكنهما مفهومان مختلفان في الأساس.

الآن بعد تثبيت بيئة العمل، يمكننا تناول أساسيات PHP.