معرفی فایل کانفیگ فریمورک Flare

فایل کانفیگ فریمورک Flare به شما این امکان را می‌دهد تا تنظیمات مختلف پروژه خود را به راحتی و به صورت مرکزی مدیریت کنید. این تنظیمات شامل آدرس‌های سایت، اطلاعات دیتابیس، وضعیت دیباگ و پشتیبانی از اپلیکیشن‌های تک صفحه‌ای (SPA) هستند.

تنظیمات اصلی کانفیگ

در زیر برخی از تنظیمات اصلی که می‌توانید در فایل کانفیگ config.php قرار دهید، آورده شده است:


$Config = [
    'URL'      => 'http://localhost/public/',  // آدرس اصلی وبسایت
    'DB_HOST'  => 'localhost',  // میزبان دیتابیس
    'DB_NAME'  => 'Flare_Db',  // نام دیتابیس
    'DB_USER'  => 'root',  // نام کاربری دیتابیس
    'DB_PASS'  => '',  // رمز عبور دیتابیس
    'DB_PREFIX'=> '',  // پیشوند جداول
    'DB_PORT'  => 3306,  // پورت اتصال
];

حالت دیباگ

با تنظیم متغیر $Deb_set می‌توانید حالت دیباگ را فعال یا غیرفعال کنید. در حالت فعال، امکانات دیباگ از طریق دو پکیج symfony/error-handler و maximebf/debugbar در دسترس قرار می‌گیرد.


$Deb_set = false;  // حالت دیباگ غیرفعال

امکانات دیباگ فعال

در صورت فعال بودن دیباگ:

  • Symfony ErrorHandler: مدیریت خطاهای PHP و نمایش بهتر Exceptionها در مرورگر.
  • Debugbar: اضافه شدن نوار دیباگ در پایین صفحه شامل اطلاعات ریکوئست ، متغیرها و غیره.
    • 

$debugbar['messages']->addMessage('hello');

$debugbar['time']->startMeasure('op1', 'sleep 500');
usleep(300);
$debugbar['time']->startMeasure('op2', 'sleep 400');
usleep(200);
$debugbar['time']->stopMeasure('op1');
usleep(200);
$debugbar['time']->stopMeasure('op2');

$debugbar['messages']->addMessage('world', 'warning');
$debugbar['messages']->addMessage(array('toto' => array('titi', 'tata')));
$debugbar['messages']->addMessage('oups', 'error');

$debugbar['time']->startMeasure('render');

توابع مهم دیباگ

  • dump(\$variable) : خروجی گرفتن از متغیرها به صورت زیبا و خوانا (نیاز به symfony/var-dumper یا تنظیمات داخلی دارد).
  • dd(\$variable) symfony/var-dumper تابع dd() (مخفف "Dump and Die") برای نمایش اطلاعات یک متغیر و توقف اجرای برنامه استفاده می‌شود. این تابع در هنگام فعال بودن حالت دیباگ مفید است. .
نکته: استفاده از دیباگ‌بار در محیط‌های تولیدی توصیه نمی‌شود. قبل از انتشار نسخه نهایی سایت، حتما $Deb_set را به false تغییر دهید.

پشتیبانی از اپلیکیشن‌های تک صفحه‌ای (SPA)

با تنظیم متغیر $CONF_SPA می‌توانید قابلیت اپلیکیشن‌های تک صفحه‌ای (SPA) را فعال کنید. اگر از این ویژگی استفاده نمی‌کنید، مقدار آن را به false تغییر دهید:


$CONF_SPA = true;  // حالت SPA فعال
$CONF_SPA = false; // حالت SPA غیرفعال

تنظیمات CLI

فایل cli-config.php تنها باید از طریق CLI (خط فرمان) استفاده شود. در این فایل دو ثابت تعریف می‌شود:

  • CONFIG: مسیر فایل‌های تنظیمات پروژه.
  • PUPATH: مسیر پوشه public که فایل‌های وب در آن قرار دارند.

const CONFIG = __DIR__.DIRECTORY_SEPARATOR;
const PUPATH = __DIR__ . '/../../public/';

نکات مهم

  • تنظیم آدرس URL: حتما مسیر درست وبسایت را وارد کنید.
  • اطلاعات دیتابیس: نام دیتابیس، کاربر و رمز عبور را به درستی تنظیم کنید.
  • غیرفعال کردن دیباگ: در محیط‌های production حتما دیباگ را خاموش کنید.
  • استفاده صحیح از SPA: در صورت عدم استفاده از SPA، آن را غیرفعال کنید تا بار اضافی روی پروژه وارد نشود.
\/