الدرس 8 · الوحدة 4: التسليم والنشر

المحطّة ٨: النشر على XAMPP والتسليم

الخطوة الأخيرة: منتجٌ يعمل على خادمٍ حقيقيّ، موثّقٌ يشغّله غيرك. ⏱ نحو 22 دقيقة.

بعد هذا الدرس ستستطيع أن:

تنشر تطبيق PHP على XAMPP مع MySQL.
تبدّل بين SQLite و MySQL بتغيير طبقة الاتصال وحدها.
تضبط إعدادات الإنتاج الآمنة وتحمي الأسرار.
تجهّز حزمة تسليمٍ وتوثيقًا يمكّن غيرك من تشغيل المنتج.

١من «يعمل في المختبر» إلى «منتجٍ يعمل على خادم»

كتبتَ الكود هنا على SQLite في المتصفّح. الآن ننقله إلى بيئةٍ أقرب للواقع: XAMPP مع Apache وMySQL — وهي البيئة التي تشغّل عليها مشروعك في المعمل وتعرضه للمقيّم.

الفرق بين الكود والمنتج هو هذه الخطوة: أن يعمل على خادمٍ حقيقيٍّ، بقاعدة بياناتٍ حقيقيّة، بإعداداتٍ صحيحة، موثّقًا بحيث يشغّله غيرك.

٢خطوات النشر على XAMPP

ثبّت XAMPP وشغّل Apache وMySQL من لوحة التحكّم.
افتح http://localhost/phpmyadmin، وأنشئ قاعدةً باسم tasks بترميز utf8mb4_unicode_ci.
من تبويب SQL: نفّذ أوامر إنشاء الجدولين (حوّل الأنواع إلى MySQL: INT AUTO_INCREMENT، VARCHAR، DATETIME).
انسخ ملفّات المشروع إلى htdocs/tasks/.
في db.php بدّل سطر SQLite بسطر MySQL: new PDO("mysql:host=localhost;dbname=tasks;charset=utf8mb4", "root", "").
افتح http://localhost/tasks/ وجرّب التسجيل والدخول وإدارة المهامّ.

٣من بيئة التطوير إلى الإنتاج

إعداداتٌ مناسبةٌ للتطوير تصير خطرةً في الإنتاج. راجع هذه قبل التسليم:

الإعداد	في التطوير	في الإنتاج
عرض الأخطاء	ظاهرة لتصحّحها	مخفيّة عن المستخدم، تُسجَّل في ملفّ
مستخدم القاعدة	root بلا كلمة	مستخدمٌ خاصٌّ بكلمةٍ قويّةٍ وصلاحياتٍ محدودة
HTTPS	غير ضروريّ محليًّا	مطلوب (كلمات المرور تُرسَل مُعمّاة عبر الشبكة)
بيانات التجربة	مستخدمو تجربة	تُحذَف قبل الإطلاق

٤حزمة التسليم

مشروعٌ مكتملٌ يُسلَّم بأكثر من كود. جهّز:

كود المشروع منظّمًا (مجلّداتٌ واضحة، db.php منفصل).
ملفّ schema.sql لإنشاء القاعدة وبياناتٍ تجريبيّةٍ اختياريّة.
ملفّ README: ما المشروع، ومتطلّباته، وخطوات التشغيل، وبيانات دخولٍ تجريبيّة.
وثيقة المتطلّبات (محطّة 1) ومخطّط البيانات (محطّة 2) وخطة الاختبار (محطّة 7).

حين يستطيع زميلٌ تشغيل مشروعك من الصفر باتّباع README وحده، فقد صار «منتجًا» لا مجرّد كود. هذا هو معنى «من الفكرة إلى المنتج».

توقّع وتحقّق

ما حال عرض الأخطاء في الإنتاج؟

أين توضع كلمة مرور قاعدة البيانات؟

ما الذي يجعل زميلًا يشغّل مشروعك من الصفر؟

لماذا HTTPS مطلوبٌ في الإنتاج؟

الخلاصة

النشر على XAMPP: أنشئ قاعدة MySQL، نفّذ المخطّط، بدّل سطر الاتصال، ضع الملفّات في htdocs.
طبقة db.php تجعل الانتقال من SQLite إلى MySQL تغييرَ سطرٍ واحد.
الإنتاج يختلف: أخفِ الأخطاء، مستخدمٌ بكلمةٍ قويّة، HTTPS، احذف بيانات التجربة.
لا ترفع الأسرار داخل الكود؛ ضعها في إعداداتٍ منفصلة.
حزمة التسليم: كودٌ + schema.sql + README + وثائق المحطّات — بها يصير الكود منتجًا.

تحدٍّ تصميمي: نشر «مفكّرة مهامّي» وتسليمه

تصميمي

انشر مشروعك على XAMPP مع MySQL، وجهّز حزمة تسليمٍ كاملة. الهدف أن يشغّله زميلٌ من الصفر باتّباع توثيقك وحده.

المطلوب:

تشغيل المشروع فعليًّا على XAMPP + MySQL.
ملفّ README بخطوات التشغيل وبيانات دخولٍ تجريبيّة.
مراجعة إعدادات الإنتاج (الأخطاء، المستخدم، الأسرار).
تجميع وثائق المحطّات (متطلّبات، مخطّط، خطة اختبار).

☑ راجع عملك قبل التسليم:

أنشأتُ قاعدة MySQL ونفّذتُ المخطّط عليها بنجاح.
بدّلتُ سطر الاتصال في db.php إلى MySQL وعمل المشروع.
أخفيتُ عرض الأخطاء عن المستخدم (إعداد إنتاج).
وضعتُ أسرار الاتصال في ملفٍّ منفصلٍ لا يُشارَك.
كتبتُ README: وصفٌ + متطلّبات + خطوات تشغيل + دخولٌ تجريبيّ.
جمعتُ وثيقة المتطلّبات والمخطّط وخطة الاختبار في حزمة التسليم.
طلبتُ من زميلٍ تشغيل المشروع من README وحده ونجح.

💡 تلميح 1

حوّل أنواع SQLite إلى MySQL: INTEGER PRIMARY KEY ← INT AUTO_INCREMENT PRIMARY KEY، TEXT ← VARCHAR/DATETIME.

💡 تلميح 2

جرّب README بنفسك على جهازٍ نظيف (أو مجلّدٍ جديد) قبل التسليم — إن عمل عندك فسيعمل عند المقيّم.

🐞 لاحظت خطأً في هذا الدرس؟ أبلغني بالبريد

📝 معلم؟ أرسل ملاحظة للمؤلف عن هذا الدرس