Laravel Configuration

💡 يتم تخزين جميع ملفات الت Configration الخاصة بإطار Laravel في مجلد الـ config.

Environment Configuration

تسمح لنا Laravel بتشغيل تطبيق لبيئات متنوعة، لتهيئة بيئة التطبيق الخاص بك ، ستحتاج إلى ملف env. ، الموجود في مجلد الـ root للمشروع.

عند تثبيت الـ artisan لـ Laravel ، يتم إنشاء هذا الملف أو إنشاؤه تلقائيًا بواسطة الـ artisan نفسه.

💡 إذا كنت تقوم بالتطوير مع فريق ، فقد ترغب في الاستمرار في تضمين ملف env.example. مع تطبيقك، يمكن للمطورين الآخرين في فريقك أن يروا بوضوح متغيرات البيئة اللازمة لتشغيل التطبيق الخاص بك + يمكنك أيضًا إنشاء ملف env.testing. سيتخطى هذا الملف ملف env. عند تشغيل اختبارات PHPUnit أو تنفيذ أوامر Artisan باستخدام خيار env=testing–.

يحتوى ملف env. على الـ parametrs التاليه:

APP_NAME=Laravel
APP_ENV=local
APP_KEY=base64:77Yrp2qu92MKvqllast7/mYSvnu1XNasZxm43KK5glk=
APP_DEBUG=true
APP_URL=http://localhost

LOG_CHANNEL=stack

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=

BROADCAST_DRIVER=log
CACHE_DRIVER=file
QUEUE_CONNECTION=sync
SESSION_DRIVER=file
SESSION_LIFETIME=120

REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379

MAIL_MAILER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS=null
MAIL_FROM_NAME="${APP_NAME}"

AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=

PUSHER_APP_ID=
PUSHER_APP_KEY=
PUSHER_APP_SECRET=
PUSHER_APP_CLUSTER=mt1

MIX_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
MIX_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"

💡 يمكن تجاوز أي variable في ملف env. بواسطة متغيرات البيئة الخارجية (external environment) مثل متغيرات البيئة على مستوى الخادم (server-level) أو على مستوى النظام (system-level).

Retrieving Environment Configuration

سيتم تحميل جميع المتغيرات المدرجة في هذا الملف إلى ENV_$ وستكون super-global عندما يتلقى تطبيقك طلبًا + يمكنك استخدام المساعد env لاسترداد القيم من هذه المتغيرات في ملفات الـ configuration الخاصة بك. 

يمكنك الوصول إلى متغير البيئة، كالتالى:

'database' => env('DB_DATABASE', 'new_laravel'),

💡 يتم استدعاء وظائف env-helper في ملف app.php المتضمن في مجلد الـ Configuration.

Accessing Configuration Values

يمكنك الوصول بسهولة إلى قيم الـ Configuration الخاصة بك باستخدام وظيفة config المساعد العام من أي مكان في تطبيقك.

يمكن الوصول إلى قيم الـ Configuration باستخدام [ إسم الملف > . > الخيار الذى تريد الوصول إليه > , > قيمة الخيار]:

$value = config('app.timezone', 'Asia/Seoul');

Caching of Configuration

لإعطاء تطبيقك دفعة سريعة ، يجب عليك تخزين جميع ملفات التكوين في ذاكرة تخزين مؤقت cache في ملف واحد باستخدام الأمر:

config: cache Artisan

سيؤدي الأمر السابق إلى دمج جميع خيارات الـ Configuration لتطبيقك في ملف واحد سيتم تحميله بسرعة من خلال إطار العمل.

💡 يجب عليك عادةً تشغيل الأمر php artisan config: cache كأسلوب منهجى خاص بك:

php artisan config: cache

Maintenance Mode

عندما يكون تطبيقك في وضع الصيانة ، سيتم عرض طريقة عرض مخصصة لجميع الطلبات في التطبيق الخاص بك، هذا يجعل من السهل “تعطيل” التطبيق الخاص بك أثناء التحديث أو أثناء إجراء الصيانة.

💡 يتم تضمين فحص وضع الصيانة في مكدس البرامج الوسيطة الافتراضية (default middleware stack) لتطبيقك + إذا كان التطبيق في وضع الصيانة ، فسيتم طرح MaintenanceModeException برمز حالة 503.

لتمكين وضع الصيانة ، قم بتنفيذ الأمر التالى:

php artisan down

لتعطيل وضع الصيانة ، استخدم الأمر التالى:

php artisan up

💡 يمكنك تخصيص قالب وضع الصيانة الافتراضي عن طريق تحديد القالب الخاص بك على resources/views/errors/503.blade.php.

💡 أثناء تشغيل التطبيق في وضع الصيانة ، لن يتم التعامل مع أي مهام في قائمة الانتظار، ستستمر معالجة المهام كالمعتاد بمجرد انتهاء التطبيق من وضع الصيانة.

💡 Done: انت الأن إنتهيت من الـ Configuration الخاص بالـ laravel (لكن يجب عليك التركيز على النقاط المهمة والتطبيق أهم شىء).