Home Arrow Icon Knowledge base Arrow Icon Global Arrow Icon ما هي متغيرات البيئة المشتركة المستخدمة في شراع لارافيل


ما هي متغيرات البيئة المشتركة المستخدمة في شراع لارافيل


تعتمد Laravel Sail ، وهي بيئة تنمية لـ Laravel باستخدام Docker ، اعتمادًا كبيرًا على متغيرات البيئة المحددة في المقام الأول في ملف ". تقوم متغيرات البيئة هذه بتكوين التطبيق وخدماته ، مما يتيح تنسيقًا سلسًا للحاويات وضبط الإعدادات المناسبة للتطوير المحلي.

يمكن تجميع متغيرات البيئة الشائعة المستخدمة في شراع Laravel وفقًا لغرضها: تكوين التطبيق ، وتكوين قاعدة البيانات ، ومنافذ الخدمة والربط ، وإعدادات مستخدم الحاويات ، والتخصيصات الخاصة بالإبحار.

متغيرات تكوين التطبيق

- `app_name`: يحدد اسم تطبيق Laravel.
- `app_env`: يعين نوع البيئة ، عادة" محلي "للإبحار.
- `app_key`: مفتاح تشفير مشفر base64 يستخدمه Laravel للتشفير وأمن الجلسة.
- `app_debug`: علامة منطقية لتمكين رسائل الخطأ التفصيلية وميزات تصحيح الأخطاء (` true` أو `false`).
- `app_url`: عنوان URL حيث يمكن الوصول إلى التطبيق محليًا ، وغالبًا ما يتم ضبطه على` http: // localhost`.

متغيرات اتصال قاعدة البيانات

لتنظيم حاوية قاعدة البيانات (خدمة mysql`) ، تستخدم Sail متغيرات تحدد الاتصال بحاوية قاعدة بيانات MySQL:

- `db_connection`: يشير إلى برنامج تشغيل قاعدة البيانات ، وعادة ما يكون" mysql`.
- `db_host`: اسم المضيف لخادم قاعدة البيانات ، وعادة ما يكون اسم حاوية mySQL ، مثل" mysql`.
- `db_port`: المنفذ الافتراضي لاتصال mySQL ، عادة` 3306`.
- `db_database`: اسم قاعدة البيانات المستخدمة داخل الحاوية.
- `db_username`: اسم المستخدم للوصول إلى قاعدة البيانات.
- `db_password`: كلمة المرور لمستخدم قاعدة البيانات.

تكوين redis

SAIL تدعم اختياريا Redis لتخزين التخزين المؤقت أو التعامل مع الجلسة. تقوم هذه المتغيرات بتكوين اتصال Redis:

- `redis_host`: اسم المضيف لخادم redis ، غالبًا ما يتطابق مع حاوية redis.
- `redis_password`: كلمة المرور لـ redis ، إن وجدت.
- `redis_port`: يستمع المنفذ Redis ، غالبًا ما يكون` 6379 `.

متغيرات إعادة توجيه منفذ الخدمة

لتجنب النزاعات مع الخدمات التي تعمل بالفعل على منافذ مشتركة على نظام المضيف ، يسمح Sail بتخصيص المنافذ المعاد توجيهها لخدماتها:

- `forward_db_port`: تم إعادة توجيه منفذ الجهاز المحلي إلى المنفذ القياسي لـ MySQL 3306 في الحاوية (على سبيل المثال ، يمكنك تعيين هذا إذا كان المنفذ 3306 مشغولًا).
- `forward_redis_port`: تم إعادة توجيه المنفذ المحلي إلى منفذ Redis الافتراضي 6379.
- `forward_mailhog_port`: تم إعادة توجيه المنفذ المحلي إلى منفذ خدمة mailhog ، والذي يتم استخدامه عادة لاختبار البريد الإلكتروني.
- توجد متغيرات أخرى `forward_*` لخدمات مثل phpmyadmin أو خدمات الشراعية الأخرى إذا تم تكوينها.

حاوية مستخدم وأذونات متغيرات

تقوم SAIL بتشغيل الحاويات باستخدام مستخدم يطابق المستخدم المضيف المحلي للتأكد من أن أذونات الملفات تظل متسقة بين المضيف والحاوية. تتحكم هذه المتغيرات في معرفات المستخدم:

- `wwwuser`: يعين معرف المستخدم داخل الحاوية التي تتوافق مع معرف مستخدم جهاز المضيف ، مما يضمن تطابق أذونات الملف.
- "wwwgroup": تعيين معرف المجموعة داخل الحاوية لمطابقة المضيف.

متغيرات تخصيص الشراع

- `app_service`: يتيح تغيير اسم حاوية خدمة تطبيق Laravel الأساسية داخل` docker-corm.yml`. يمكن أن يكون هذا مفيدًا للتكوينات المتقدمة.
- `SAIL_FILES`: يتيح لك تحديد ملفات Docker إضافية لتشكيل ملفات تجاوز ليتم تحميلها إلى جانب ملفات SAIL القياسية. هذا لتخصيص أو تمديد بيئة الشراع.
- `supervisor_php_command`: يستخدم لتخصيص أمر بدء تشغيل PHP داخل حاوية شراع Laravel الرئيسية ، مفيدًا عند دمج أدوات مثل Laravel Octane.
- `supervisor_php_user`: تعيين المستخدم الذي يعمل على تشغيل php في عملية المشرف داخل الحاوية.

متغيرات خدمة البريد

يأتي Laravel Sail مع حاوية MailHog لالتقاط رسائل البريد الإلكتروني المرسلة أثناء التطوير. تكوين هذه المتغيرات إعدادات البريد:

- `mail_mailer`: ضبط على` smtp` أو سائق بريد آخر.
- `mail_host`: اسم HostName لخادم البريد ، وعادة ما يكون" mailHog ".
- `mail_port`: منفذ لـ SMTP ، عادةً` 1025 "لـ MailHog.
- `mail_username` و` mail_password`: بيانات الاعتماد إذا لزم الأمر (عادة ما تترك فارغًا في التطوير).

قائمة انتظار وذاكرة التخزين المؤقت

يمكن أن يضع هذه:

- `queue_connection`: يحدد برنامج قائمة الانتظار ، مثل" Sync` أو "Database` أو` redis`.
- `cache_driver`: يحدد برنامج تشغيل ذاكرة التخزين المؤقت ، وغالبًا ما يكون" ملف "أو" redis`.

متغيرات بيئة الخدمة الأخرى

- `xdebug_config`: تم تكوينه تلقائيًا عن طريق الإبحار لتصحيح الأخطاء مع xDebug ، وغالبًا ما يضع` client_host = host.docker.internal` لنظام التشغيل mac و windows.
- "Puid" و "PGID": شوهد أحيانًا في تكوينات الشراع المخصصة لتعيين معرفات المستخدم والمجموعة بشكل صريح لمطابقة تقديم المستخدم.

ملخص الأدوار المتغيرة للبيئة في الإبحار

تخدم متغيرات البيئة هذه ، التي يتم تعريفها في الغالب في ملف ".env` ، إلى:

- تكوين أساسيات تطبيق Laravel (الاسم ، البيئة ، وضع التصحيح ، URL).
- قم بتوصيل حاوية تطبيق Laravel بقاعدة البيانات وخدمات ذاكرة التخزين المؤقت داخل Docker.
- منافذ الخريطة من الحاوية إلى الجهاز المضيف ، وتجنب تعارضات المنافذ المحلية.
- تأكد من أذونات المستخدم والمجموعة المناسبة بين أنظمة المضيف وأنظمة الحاويات.
- تخصيص حاويات البيئة الشراعية لارافيل وعمليات الاستخدام المتقدم.

تتحكم متغيرات بيئة الملفات ". يؤدي ضبط هذه المتغيرات وإعادة تشغيل الإبحار (باستخدام أوامر مثل "./vendor/bin/sail down` و`.

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