Codeبنية المجلدات والملفات والدليل في برنامج Igniter

⚡ ملخص ذكي

Codeيقوم Igniter بتنظيم مشروع PHP في مجلدات يمكن التنبؤ بها لمنطق التطبيق وملفات نظام الإطار وحزم Composer الخاصة بالبائعين وبرنامج نصي واحد للدخول، بحيث يمكن للمبتدئين تحديد موقع التعليمات البرمجية بسرعة ويمكن للمطورين المتوسطين توسيع بنية MVC نظيفة.

  • 📁 مجلد التطبيق: يحتوي على وحدات التحكم، والنماذج، والعروض، والتكوين، وذاكرة التخزين المؤقت، والمساعدين، والخطافات، واللغة، والمكتبات، والسجلات، وحزم الطرف الثالث.
  • 🧩 مجلد النظام: يخزن هذا الملف نواة الإطار، وبرامج تشغيل قواعد البيانات، والخطوط، والمساعدين، واللغة، والمكتبات المدمجة؛ لا تقم بتحرير هذه الملفات مباشرة.
  • ⚙️ نقطة الدخول: يقوم ملف index.php الرئيسي بتشغيل الإطار، وتعيين المسارات، وتوجيه كل طلب HTTP من خلال وحدة التحكم الأمامية.
  • ✅ اختلافات الإصدارات: Codeيستخدم Igniter 3 المسارين application/ و system/، بينما Codeيقدم Igniter 4 مجلدات app/ و public/ و writable/ لفصل أكثر صرامة.
  • 🧪 دليل البائع ودليل المستخدم: يقوم المورّد بتخزين حزم Composer التي تقوم بنشرها، بينما دليل المستخدم هو وثائق محلية يجب استبعادها من خوادم الإنتاج.

Codeمجلد الإشعال

فهم بنية الملفات في Codeيُعدّ Igniter أساسيًا قبل بناء أي تطبيق حقيقي. يساعدك التصميم المُتوقع على تحديد مواقع المتحكمات والنماذج والعروض بسرعة، وتصحيح أخطاء التوجيه، ودمج أعضاء الفريق الجدد بشكل أسرع. يغطي هذا الدليل الأساسيات الكلاسيكية. Codeلا تزال بنية Igniter 3 مستخدمة على نطاق واسع، كما توضح الاختلافات الرئيسية التي ستواجهها في CodeIgniter 4.x، الذي يقدم app/ و public/ و writable/ كمجلدات منفصلة من المستوى الأعلى.

ما هو Codeبنية ملفات ومجلدات برنامج إغنايتر؟

استخدم Codeبنية ملفات Igniter هي الترتيب الافتراضي للمجلدات وملفات PHP التي تأتي مع إطار العمل بعد تنزيله أو تثبيته. تفصل هذه البنية منطق تطبيقك عن نواة إطار العمل، وتحافظ على تبعيات Composer معزولة، وتوفر نقطة دخول واحدة عبر ملف index.php. تُظهر الصورة التالية بنية الملفات في Codeأنبوب:

Codeبنية الملفات/المجلدات/الدليل في برنامج Igniter
Codeبنية الملفات/المجلدات/الدليل في برنامج Igniter

إليك شجرة دليل مبسطة لملف جديد Codeتثبيت برنامج Igniter 3:

// CodeIgniter 3 root layout
project-root/
├── application/
├── system/
├── user_guide/
├── vendor/
├── composer.json
├── composer.lock
└── index.php

شرح المجلدات الرئيسية

لنلقِ نظرة الآن على الملفات المذكورة أعلاه في Codeهيكل جهاز الإشعال:

  • استمارتنا هذا هو المجلد الذي سيحتوي على منطق تطبيقك. سيتم تضمين جميع أكواد تطبيقك في هذا المجلد.
  • نظام – يحتوي هذا المجلد على الملفات الأساسية لإطار العمل. لا يُنصح بإجراء تغييرات في هذا الدليل أو وضع رمز التطبيق الخاص بك في هذا الدليل.
  • دليل المستخدم – يحتوي هذا الدليل على دليل المستخدم الخاص بـ Codeأنبوب.
  • بائع يحتوي هذا المجلد على شفرة المصدر لحزم Composer. أما الملفات الأخرى المرتبطة بهذا المجلد فهي composer.json و composer.lock.
  • index.php – هذه هي نقطة الدخول إلى التطبيق.

Codeالمجلدات الفرعية لتطبيق Igniter

لنلقِ نظرة الآن على الدلائل بمزيد من التفصيل. كما ذكرنا، يحتوي دليل التطبيق على رمز مشروعك. في هذا القسم، سنلقي نظرة على الدلائل الفرعية الداخلية في Codeبنية دليل Igniter:

  • مخبأ – يخزن الملفات المخزنة مؤقتًا التي تم إنشاؤها بواسطة مكتبات التخزين المؤقت للإخراج وقاعدة البيانات.
  • التكوين – يحتفظ بملفات التكوين مثل database.php و routes.php و autoload.php.
  • وحدات التحكم – يتم تعريف جميع وحدات التحكم في التطبيق هنا وتعيينها URL تحويل الأجزاء إلى إجراءات.
  • النواة – يحتوي على فئات أساسية مخصصة تُوسّع ملفات النظام. على سبيل المثال، إذا أنشأتَ وحدة تحكم أساسية ينبغي أن تُوسّعها وحدات التحكم الأخرى، فستضعها في هذا الدليل.
  • المساعدين – هذا الدليل الخاص بـ Codeيتم استخدام بنية مجلدات Igniter لوظائف المساعدة التي يحددها المستخدم.
  • السنانير – تُستخدم للخطافات المخصصة في بنية مجلد التكامل المستمر التي يتم تشغيلها أثناء دورة تنفيذ الإطار.
  • لغة – تُستخدم لتخزين ملفات اللغة للتطبيقات التي تستخدم أكثر من لغة واحدة.
  • المكتبات – تُستخدم لتخزين المكتبات المُنشأة حسب الطلب.
  • الجذوع – يتم الاحتفاظ بملفات سجل التطبيق في هذا الدليل.
  • عارضات ازياء – يجب تعريف جميع نماذج التطبيقات في هذا الدليل.
  • الفريق الثالث – يتم استخدام هذا للحزم المخصصة التي قمت أنت أو مطورون آخرون بإنشائها.
  • المشاهدات – يتم وضع عروض التطبيق في هذا الدليل.

فيما يلي مثال على شجرة الدليل الفرعي للتطبيق:

// application/ subdirectories
application/
├── cache/
├── config/
├── controllers/
├── core/
├── helpers/
├── hooks/
├── language/
├── libraries/
├── logs/
├── models/
├── third_party/
└── views/

Codeالمجلدات الفرعية لنظام الإشعال

لنلقِ نظرة الآن على المجلدات الفرعية للنظام في بنية ملفات التكامل المستمر. تذكر أن هذا هو المكان الذي يوجد فيه كود المصدر الخاص بالإطار، لذا لا تُجرِ أي تغييرات على الملفات الموجودة في هذا المجلد.

  • النواة – هذا مثل قلب Codeإطار عمل Igniterتوجد جميع الملفات الأساسية التي تُشكّل إطار العمل هنا. إذا كنت ترغب في توسيع وظائف الملف الأساسي، فعليك إنشاء ملف أساسي مُخصّص في مجلد التطبيق. بعد ذلك، يمكنك تعديل أو إضافة السلوكيات التي ترغب بها. لا تُجرِ أي تغييرات مباشرة هنا.
  • قاعدة بيانات – يتم توفير برامج تشغيل قواعد البيانات، وذاكرة التخزين المؤقت، والملفات الأخرى اللازمة لعمليات قواعد البيانات هنا.
  • الخطوط – كما يوحي الاسم، يحتوي هذا الدليل على الخطوط والمعلومات المتعلقة بها.
  • المساعدين – هذا الدليل في Codeيحتوي مجلد بنية Igniter على وظائف مساعدة جاهزة للاستخدام.
  • لغة – يحتوي على ملفات اللغة التي يستخدمها الإطار.
  • المكتبات – يحتوي على ملفات المصدر للمكتبات المختلفة التي تأتي مع Codeجهاز إشعال جاهز للاستخدام مباشرة.

يبدو تخطيط مجلدات النظام كالتالي:

// system/ subdirectories
system/
├── core/
├── database/
├── fonts/
├── helpers/
├── language/
└── libraries/

Codeدليل مستخدم Igniter

يُستخدم هذا الدليل كمرجع عندما ترغب في فهم Codeواجهة برمجة تطبيقات Igniter. لا ينبغي تحميل هذا المجلد عند نشر تطبيقك في بيئة الإنتاج، لأنه يزيد من حجم الملف ويعرض وثائق لا مكان لها على خادم مباشر.

Codeدليل موردي Igniter

يحتوي هذا المجلد على ملفات المصدر للحزم التي تُثبّتها عبر Composer. يجب ترك الملفات الموجودة في هذا المجلد كما هي دون إجراء أي تغييرات عليها. على عكس مجلد دليل المستخدم، يجب تحميل هذا المجلد إذا كنت تستخدم حزم Composer في تطبيقك.

ملف index.php

ملف index.php في Codeيحتوي هيكل ملف Igniter على كود التمهيد الذي يُحدد البيئة والمسارات وآليات الإبلاغ عن الأخطاء قبل تسليم التحكم إلى إطار العمل. يوجد هذا الملف في الدليل الجذر ويعمل كوحدة تحكم أمامية لكل طلب HTTP وارد.

كيفية Codeيُغيّر المُشغّل 4 البنية

Codeأعاد Igniter 4.x تنظيم واجهة المستخدم لتحسين الأمان والتحميل التلقائي وفقًا لمعيار PSR-4. فبدلاً من مجلد تطبيق واحد، ستجد الآن ثلاثة مجلدات رئيسية تفصل بين المهام بشكل أكثر دقة.

  • تطبيق/ – مكافئ للتطبيق/المجلد القديم، الذي يحتوي على وحدات التحكم، والنماذج، والعروض، والتكوين، والفلاتر، والمكتبات.
  • عامة/ – المجلد الوحيد المتاح على الويب، والذي يحتوي على ملف index.php وملفات CSS وJS والصور الخاصة بك.
  • قابل للكتابة/ – يخزن ذاكرة التخزين المؤقت والسجلات والجلسات والتحميلات التي يحتاجها الإطار لكتابتها في وقت التشغيل.
  • نظام/ لا يزال يحتفظ بنواة الإطار، المصنفة تحت Codeأنبوب\.
  • بائع/ – حزم الملحن، مطابقة في دورها لـ CI 3.
// CodeIgniter 4 root layout
project-root/
├── app/
├── public/
├── writable/
├── system/
├── vendor/
├── tests/
├── composer.json
├── env
└── spark

إذا كنت ستبدأ مشروعًا جديدًا اليوم، Codeيُوصى باستخدام Igniter 4. إذا كنت تستخدم قاعدة بيانات قديمة، فإن بنية CI 3 الموضحة أعلاه ستتطابق مع ما تراه على القرص.

العمل مع Codeهيكل جهاز الإشعال - الاستخدام اليومي

بمجرد معرفة مكان كل مجلد، تصبح المهام الشائعة سهلة. أنشئ وحدة تحكم جديدة ضمن application/controllers/ (أو app/Controllers/ في CI 4)، واربطها بمسار في config/routes.php، وأنشئ نموذجًا ضمن models/، واعرض المخرجات من ملف عرض في views/. احتفظ بالإعدادات في config/، وضع التعليمات البرمجية القابلة لإعادة الاستخدام في helpers/ أو libraries/، ودع Composer يدير كل شيء داخل vendor/. التزم بهذا النهج، وسيظل مشروعك سهل الاستخدام حتى مع نموه.

الأسئلة الشائعة

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

In Codeفي Igniter 4، يمكنك وضع وحدات التحكم الجديدة في مجلد app/Controllers/ باستخدام مساحات أسماء PSR-4. قم بمطابقة اسم الملف مع اسم الفئة، ثم قم بتسجيل مسار في app/Config/Routes.php حتى يتمكن الإطار من توجيه الطلبات إليه.

لا. مجلد دليل المستخدم مخصص للوثائق المحلية فقط. استبعده من عمليات النشر في بيئة الإنتاج لتقليل حجم الملفات وتجنب عرض مواد مرجعية خاصة بالإطار على خادم مباشر. أما مجلدا المورّد والنظام، فيجب نشرهما.

يُعد ملف index.php هو وحدة التحكم الأمامية. فهو يُهيئ البيئة، ويُحدد ثوابت المسار، ويُحمّل إطار العمل التمهيدي بحيث يتم توجيه كل طلب وارد من خلاله. Codeقم بتشغيل خط أنابيب Igniter قبل الوصول إلى وحدات التحكم والعروض الخاصة بك.

نعم. يمكن لأدوات الذكاء الاصطناعي مثل GitHub Copilot وCursor وClaude إنشاء وحدات التحكم والنماذج والعروض في المجلدات الصحيحة، وشرح الملفات غير المألوفة، وتحديد الفئات الموضوعة في غير مكانها. وهي مفيدة بشكل خاص عند التبديل بين CodeIgniter 3 و Codeتخطيطات Igniter 4.

تشرح المساعدات المدعومة بالذكاء الاصطناعي كيفية تعامل وحدات التحكم مع الطلبات، وكيفية إدارة النماذج للبيانات، وكيفية عرض طرق العرض للمخرجات، ثم تُنشئ ملفات مطابقة في المجلدات الصحيحة. كما يمكنها مراجعة التعليمات البرمجية الخاصة بك، واقتراح عمليات إعادة هيكلة، وتعزيز فصل نمط MVC أثناء بناء تطبيقات حقيقية. Codeمشاريع Igniter.

تلخيص هذه التدوينة بـ: