شرح صفوف ومحتوى الفقرة
يقوم Laravel افتراضياً بقراءة ملف البيئة وتحميل عشرات الملفات المنفصلة داخل مجلد config مع كل طلب HTTP وارد. يدمج الأمر php artisan config:cache جميع مصفوفات الإعدادات في ملف واحد سريع، مما يفرض قاعدة صارمة باستدعاء دالة env داخل ملفات مجلد config فقط.
- دمج الإعدادات بملف واحد (Single-File Config Load): يكتب الأمر config:cache ملفاً مدمجاً في bootstrap/cache ليتخطى Laravel قراءة ملف البيئة في كل طلب.
- القاعدة الذهبية لدالة env (The Golden env Rule): بعد تفعيل كاش الإعدادات، تُرجع دالة env القيمة null في أي مكان خارج ملفات مجلد config.
- القراءة عبر دالة config (Reading via config): اقرأ القيم دائماً داخل المتحكمات والكلاسات باستخدام دالة config('app.name') الآمنة.
PHP
// config/services.php (Allowed to call env):
'stripe' => ['key' => env('STRIPE_KEY')],
// In Controller (Always use config helper):
$key = config('services.stripe.key');
// Terminal: php artisan config:cache