نصب Laravel روی هاست cPanel؛ راهنمای گام‌به‌گام

اگر تصمیم گرفته‌اید که یک وب‌سایت قدرتمند و بهینه با استفاده از فریمورک لاراول راه‌اندازی کنید، اما نمی‌دانید چگونه آن را روی هاست cPanel نصب کنید، جای درستی آمده‌اید! 

اگر هنوز هاست مناسبی برای سایت خود انتخاب نکرده‌اید، پیشنهاد می‌کنم سرویس‌های میزبانی وب مشهدهاست را بررسی کنید که بهینه‌ترین گزینه‌ها را برای پروژه‌های لاراولی ارائه می‌دهد.

با من همراه باشید تا گام‌به‌گام فرآیند نصب Laravel روی cPanel را یاد بگیریم و به راحتی پروژه خود را روی سرور راه‌اندازی کنیم.

مراحل نصب Laravel روی Cpanel

جهت نصب لاراول در هاست اشتراکی cpanel خود بصورت زیر اقدام کنید:

مرحله ۱: فشرده‌سازی (ZIP) پروژه‌ی لاراول

برای شروع، باید کل پوشه‌ی پروژه‌ی لاراول را در سیستم خود فشرده‌سازی کنید. اما یک نکته‌ی مهم! 👇
🚫 نیازی نیست پوشه‌های node_modules و test را در فایل ZIP قرار دهید، زیرا این فایل‌ها حجم زیادی دارند و روی هاست هم قابل بازسازی هستند.

💡 نکته کاربردی:
اگر در سیستم شما فایل‌های مخفی (dotfiles مثل .env و .htaccess) نمایش داده نمی‌شوند، قبل از فشرده‌سازی، حتماً این قابلیت را در تنظیمات نمایش فایل‌ها فعال کنید. در غیر این صورت، برخی از فایل‌های کلیدی لاراول ممکن است هنگام استقرار، گم شوند و پروژه‌ی شما اجرا نشود!

مرحله ۲: آپلود فایل ZIP در هاست Cpanel

✅ وارد Cpanel شوید و به بخش File Manager بروید.

✅ در مسیر public_html یک پوشه‌ی جدید ایجاد کنید، مثلاً با نام laravel_project.

✅ فایل ZIP پروژه را درون این پوشه آپلود کنید.

مرحله ۳: انتقال فایل‌های عمومی به پوشه public_html

بعد از آپلود، روی فایل ZIP کلیک راست کرده و گزینه‌ی Extract را بزنید.

🔹 پس از استخراج، تمام فایل‌ها را انتخاب کرده و به پوشه‌ی اصلی (laravel_project) منتقل کنید.

🔹 پوشه‌ی اضافی که هنگام Extract ایجاد شده را حذف کنید تا ساختار پروژه مرتب بماند.

لاراول به‌صورت پیش‌فرض، فایل‌های عمومی خود را درون پوشه‌ی public نگه می‌دارد، اما در هاست اشتراکی، باید این فایل‌ها را به مسیر public_html منتقل کنیم.

✅ به پوشه‌ی laravel_project/public بروید و تمام فایل‌های داخل آن را به public_html منتقل کنید.
✅ فایل index.php را باز کرده و دو مسیر زیر را اصلاح کنید:

require __DIR__.'/../laravel_project/vendor/autoload.php'; // تغییر مسیر به پوشه‌ی پروژه‌ی شما

$app = require_once __DIR__.'/../laravel_project/bootstrap/app.php'; // تغییر مسیر به پوشه‌ی پروژه‌ی شما

💡 نکته‌ی مهم: اگر این تغییرات را انجام ندهید، هنگام باز کردن سایت، صفحه‌ی سفید دریافت خواهید کرد!

مرحله ۴: تنظیم فایل .htaccess

باید مطمئن شوید که فایل .htaccess در جای درست قرار گرفته است:

✅ یک نسخه از فایل .htaccess را در public_html قرار دهید.
✅ یک نسخه دیگر را در پوشه‌ی اصلی پروژه (خارج از public_html) نگه دارید.

مرحله 5: تنظیم پایگاه داده در هاست Cpanel

1. از بخش Databases در Cpanel، گزینه MySQL Databases را انتخاب کنید.
2. یک پایگاه داده جدید بسازید.
3. یک کاربر جدید ایجاد کنید و آن را به پایگاه داده متصل کنید (با تمامی دسترسی‌ها).
4. اطلاعات دیتابیس را در فایل .env به‌روز کنید:

DB_DATABASE=your_database_name

DB_USERNAME=your_database_user

DB_PASSWORD=your_database_password

5. برای وارد کردن دیتابیس، به phpMyAdmin بروید و فایل .sql خود را import کنید.

اگر با تنظیمات پایگاه داده آشنا نیستید، می‌توانید از این لینک راهنمایی بگیرید:

مقاله‌ی نحوه‌ی اتصال به پایگاه داده

مرحله ۷: ایجاد Symlink برای دسترسی به Storage (اختیاری)

اگر پروژه شما نیاز به دسترسی به پوشه‌ی Storage دارد، به‌جای اجرای دستور php artisan storage:link که در هاست اشتراکی ممکن است کار نکند، می‌توانید یک فایل symlink.php در public_html ایجاد کنید و کد زیر را داخل آن قرار دهید:

<?php

symlink('/home/your_cpanel_username/your_project_folder/storage/app/public', '/home/your_cpanel_username/public_html/storage');

?>

سپس در مرورگر yourdomain.com/symlink.php را اجرا کنید. اگر موفقیت‌آمیز بود، می‌توانید فایل را حذف کنید.

مرحله ۸: اجرای پروژه از طریق مرورگر

اکنون دامنه‌ی خود را در مرورگر وارد کنید. اگر همه چیز درست تنظیم شده باشد، صفحه اصلی پروژه لاراول شما باید نمایش داده شود. 

جمع‌بندی

در این مقاله، به شما آموزش داده شد که چگونه نصب لاراول روی هاست cPanel را انجام دهید و پروژه‌تان را به‌راحتی راه‌اندازی کنید. با دنبال کردن مراحل ساده این راهنما، می‌توانید نصب لاراول را روی هاست‌های اشتراکی به‌طور کامل انجام دهید و از قابلیت‌های این فریمورک قدرتمند بهره‌برداری کنید.

اگر هنوز هاست مناسبی برای پروژه‌تان انتخاب نکرده‌اید، پیشنهاد می‌کنم به سرویس‌های میزبانی وب مشهدهاست نگاهی بیندازید. این شرکت با ارائه سرویس‌های بهینه و پشتیبانی کامل از پروژه‌های لاراولی، گزینه‌ای عالی برای راه‌اندازی سایت شماست. با خدمات مشهدهاست، می‌توانید پروژه‌تان را بدون دغدغه و با عملکرد بهینه در سرور اجرا کنید.

منبع: [iankumu.com]

سوالات متداول:

 آیا می‌توانم نصب لاراول را روی هاست اشتراکی انجام دهم؟

بله، شما می‌توانید لاراول را روی هاست‌های اشتراکی نصب کنید. با این حال، باید توجه داشته باشید که هاست‌های اشتراکی ممکن است محدودیت‌هایی در زمینه منابع سرور داشته باشند. بنابراین، اگر پروژه شما رشد کرد، بهتر است از هاست‌های اختصاصی یا VPS استفاده کنید.

خطای 500 Internal Server Error پس از نصب لاراول چیست؟

این خطا ممکن است به دلیل تنظیمات اشتباه در فایل .htaccess یا مشکلات در دسترسی به پوشه‌ها و فایل‌های مورد نیاز لاراول باشد. اطمینان حاصل کنید که فایل .htaccess به درستی در پوشه public_html قرار دارد و دسترسی به پوشه‌های storage و bootstrap/cache به‌درستی تنظیم شده باشد.

دستور php artisan migrate در هاست اجرا نمی‌شود، چرا؟

در هاست‌های اشتراکی ممکن است دستوراتی مانند php artisan migrate که نیاز به اجرای خط فرمان دارند، امکان‌پذیر نباشد. برای انجام این عملیات می‌توانید از phpMyAdmin استفاده کنید و دستی پایگاه داده و جداول لاراول را ایجاد و وارد کنید.

خطای “Class ‘App\Http\Controllers\Controller’ not found” چیست؟

این خطا معمولاً زمانی رخ می‌دهد که فضای نام (namespace) در فایل‌های کنترلر اشتباه وارد شده باشد. اطمینان حاصل کنید که کنترلرها فضای نام صحیح (مانند namespace App\Http\Controllers;) را دارند و هیچ‌کدام از فایل‌ها حذف یا جابجا نشده است.

چرا نمی‌توانم به فایل‌های storage دسترسی پیدا کنم؟

اگر پروژه شما به پوشه storage نیاز دارد، ممکن است مشکل از ایجاد Symlink یا تنظیمات دسترسی نادرست باشد. مطمئن شوید که یک لینک سمبولیک (Symlink) درست برای پوشه storage ایجاد کرده‌اید یا دسترسی‌های مربوطه به این پوشه در هاست شما به درستی تنظیم شده است.

خطای “The file or directory is corrupted” در هنگام بارگذاری پروژه چه معنایی دارد؟

این خطا ممکن است به دلیل آسیب دیدگی فایل‌های پروژه یا نادرست بودن نحوه فشرده‌سازی و آپلود فایل‌ها رخ دهد. برای رفع این مشکل، فایل ZIP را مجدداً فشرده‌سازی کنید و مطمئن شوید که تمام فایل‌ها به‌درستی بارگذاری شده‌اند.