نصب لاراول در سی پنل فقط با آپلود ZIP و تغییر دو خط index.php کامل نمی‌شود. نسخهٔ PHP، افزونه‌های لازم، وابستگی‌ها، تنظیمات محیط و مسیر عمومی باید با پروژه هماهنگ باشند. این راهنما برای استقرار پروژهٔ آماده است؛ ساخت برنامه و ارتقای نسخهٔ Laravel فرایند جداگانه‌ای است.
پیش‌نیاز نصب لاراول در سی پنل
نسخهٔ پروژه را از composer.json و فایل قفل بررسی کنید. نیازمندی نسخه‌های Laravel یکسان نیست؛ PHP وب و خط فرمان نیز ممکن است متفاوت باشند. دسترسی SSH، Composer، زمان‌بندی و اجرای صف را بر اساس نیاز برنامه از میزبان بررسی کنید. صرف وجود cPanel به معنی پشتیبانی از همهٔ قابلیت‌ها نیست.
مسیر صحیح فایل‌های پروژه
ساختار برنامه را حفظ کنید و ریشهٔ وب دامنه را به پوشهٔ public همان پروژه متصل کنید؛ برای مثال /home/ACCOUNT/apps/example/public. در مدیریت دامنه‌های cPanel امکان تغییر Document Root به نوع دامنه و تنظیمات میزبان بستگی دارد. اگر این امکان موجود نیست، مسیر استقرار مناسب را با میزبان تعیین کنید.
طبق مستند استقرار Laravel، درخواست‌ها باید به public/index.php برسند. ریشهٔ پروژه، فایل .env، پوشهٔ vendor و فایل‌های تنظیمات نباید از وب قابل دریافت باشند. جابه‌جایی کورکورانهٔ index.php یا جایگزینی آن با نمونهٔ نسخهٔ دیگر توصیه نمی‌شود.
آماده‌سازی وابستگی‌ها و خروجی فرانت‌اند
در مسیر پروژه، با PHP سازگار، وابستگی‌های قفل‌شده را نصب کنید:
composer install --no-dev --optimize-autoloader
composer check-platform-reqs --no-devطبق مستند Composer، install از composer.lock استفاده می‌کند؛ اجرای update هنگام استقرار می‌تواند نسخه‌ها را تغییر دهد. خطای نیازمندی را با نادیده‌گرفتن اجباری پلتفرم پنهان نکنید. اگر SSH ندارید، بستهٔ آماده را در محیط سازگار بسازید و خروجی کامل را منتقل کنید.
برای پروژهٔ دارای Vite، خروجی تولیدی CSS و JavaScript را با دستور ساخت تعریف‌شده در package.json آماده کنید؛ معمولاً npm run build است. وجود node_modules روی هاست به‌تنهایی خروجی تولیدی نیست. راهنمای Vite تنظیمات ساخت و مسیر فایل‌ها را توضیح می‌دهد.
تنظیمات محیط و دسترسی نوشتن
مقادیر دیتابیس و APP_URL را برای مقصد تنظیم کنید. APP_DEBUG در محیط عمومی باید false باشد. فایل .env را در مخزن عمومی یا آرشیو قابل دانلود قرار ندهید. در انتقال برنامهٔ موجود، APP_KEY را حفظ کنید؛ تولید کلید تازه می‌تواند داده‌های رمزگذاری‌شده را غیرقابل خواندن کند. منابع: تنظیمات محیط و رمزگذاری Laravel.
پوشه‌های storage و bootstrap/cache باید برای فرایند برنامه قابل‌نوشتن باشند؛ مجوز ۷۷۷ راه‌حل عمومی نیست. پس از تنظیم نهایی، کش پیکربندی را طبق نسخهٔ پروژه بازسازی کنید. تغییر .env با کش قدیمی ممکن است فوراً دیده نشود.
تکمیل استقرار و رفع خطا
مهاجرت دیتابیس را فقط پس از بررسی تغییرات و مقصد اجرا کنید. صف و زمان‌بندی، اگر برنامه به آن‌ها وابسته است، جدا تنظیم می‌شوند. صفحهٔ اصلی، یک مسیر داخلی، ورود و فایل‌های عمومی را بیازمایید. برای خطای ۵۰۰، لاگ برنامه و PHP را بخوانید؛ نمایش عمومی دیباگ یا بازکردن دسترسی فایل‌ها جایگزین تشخیص علت نیست.
مطالعهٔ مرتبط
بازبینی فنی: ۱۳ آبان ۱۴۰۵. تاریخ انتشار اولیه و نشانی قبلی حفظ شده‌اند.
