Laravel فریم‌ورکی برای ساخت برنامهٔ PHP است و امکاناتی مانند مسیر‌یابی، دسترسی به دیتابیس، صف و آزمون را در ساختار پروژه فراهم می‌کند. انتخاب شاخهٔ سازگار با محیط اجرا و طراحی استقرار، بخشی از استفادهٔ درست از آن است.
پیش‌نیاز نسخه و محیط اجرا
مستندات Laravel 13 حداقل PHP 8.3 و افزونه‌های مشخصی را برای سرور بیان می‌کنند. حداقل فریم‌ورک را با مدت پشتیبانی خود PHP و نیاز وابستگی‌های پروژه جدا بررسی کنید. نسخهٔ ترمینال و نسخهٔ PHP وب‌سرور ممکن است متفاوت باشد؛ موفقیت Composer در یکی، سازگاری دیگری را ثابت نمی‌کند.
برای پروژهٔ موجود، فایل قفل وابستگی‌ها و راهنمای ارتقای همان شاخه مهم است. نصب‌کنندهٔ پروژهٔ تازه، برنامهٔ فعال را خودکار ارتقا نمی‌دهد. دسترسی‌ها، دیتابیس، صف و اجرای وظایف زمان‌بندی‌شده را بر اساس امکانات برنامه تعیین کنید.
ساخت و آزمون پروژهٔ توسعه
پس از نصب PHP و Composer، روش رسمی نصب‌کنندهٔ Laravel با فرمان زیر آماده می‌شود:
composer global require laravel/installerسپس در محل مناسب توسعه، پروژهٔ تازه را بسازید:
laravel new example-appexample-app نام پوشهٔ نمونه است. ادامهٔ نصب، تنظیم دیتابیس و ساخت فایل‌های فرانت‌اند را مطابق گزینه‌های انتخاب‌شده در راهنمای همان نسخه انجام دهید. سرور توسعه و ابزارهای محلی را جای وب‌سرور محیط عملیاتی در نظر نگیرید.
استقرار با مسیر عمومی درست
در محیط عمومی، درخواست‌ها باید به public/index.php هدایت شوند. انتقال این فایل به ریشهٔ پروژه می‌تواند تنظیمات و فایل‌های حساس را عمومی کند. فایل .env حاوی اطلاعات محیط است و نباید در مخزن عمومی یا مسیر قابل دریافت وب قرار بگیرد.
مجوز نوشتن مسیرهای لازم، از جمله storage و bootstrap/cache، باید برای کاربر صحیح سرویس تنظیم شود. APP_DEBUG در محیط عملیاتی خاموش باشد. پس از استقرار، مسیرهای برنامه، ورود، دیتابیس و کارهای پس‌زمینه را آزمایش کنید؛ نمایش یک صفحهٔ اولیه صحت تمام سرویس‌ها را ثابت نمی‌کند.
