نصب فریم‌ورک Laravel روی هاست اشتراکی cPanel

هنگام ساخت یک وب‌اپلیکیشن مدرن با PHP، ابزارها و فریم‌ورک‌های زیادی وجود دارد؛ اما بسیاری از توسعه‌دهندگان Laravel را به‌عنوان یک انتخاب قدرتمند برای پروژه‌های Full-Stack در نظر می‌گیرند.
در این آموزش یاد می‌گیرید Laravel را روی هاست اشتراکی cPanel نصب کنید (مثل سرویس‌های هاست لینوکس cPanel در پارس آپتایم) هم با روش ساده‌تر Softaculous و هم روش حرفه‌ای‌تر Composer از طریق SSH.

نکته خیلی مهم:
روی هاست اشتراکی، صرفاً «نصب» کافی نیست؛ برای اینکه سایت درست بالا بیاید باید مسیر اجرای دامنه روی پوشه public پروژه تنظیم شود (یا معادل امن آن پیاده‌سازی شود).

Laravel چیست؟

Laravel یک فریم‌ورک وب با سینتکس خوانا و توسعه‌پسند است که هدف اصلی‌اش ارائه تجربه بهتر برای توسعه‌دهنده در کنار قابلیت‌هایی مثل Dependency Injection، لایه انتزاعی دیتابیس، Queue و Scheduled Jobs،
تست‌های Unit/Integration و موارد دیگر است.

پیش‌نیازها قبل از نصب

• نسخه PHP باید با نسخه Laravel سازگار باشد:
  • Laravel 10: حداقل PHP 8.1+
  • Laravel 11: حداقل PHP 8.2+

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

• Composer (برای روش نصب دستی)
• دسترسی SSH (اختیاری ولی پیشنهاد‌شده)

روش‌های نصب Laravel روی هاست اشتراکی

1. نصب با Softaculous (مناسب‌تر برای شروع)
2. نصب با Composer از طریق SSH (حرفه‌ای‌تر و منعطف‌تر)

روش ۱: نصب Laravel با Softaculous

مراحل کلی نصب با Softaculous در cPanel:

1. وارد cPanel شوید.
2. از بخش Software گزینه Softaculous Apps Installer را باز کنید.

3. در دسته Frameworks، گزینه Laravel را انتخاب کنید.

4. روی Install کلیک کنید.

5. اگر می‌خواهید Laravel روی دامنه اصلی نصب شود، مقدار پیش‌فرض پوشه (مثلاً laravel) را از فیلد مسیر پاک کنید تا نصب داخل مسیر اصلی انجام شود.

6. در نهایت Install را بزنید.

نکته: ممکن است آخرین نسخه Laravel فوراً در Softaculous ارائه نشود؛ اگر نسخه جدیدتر می‌خواهید، روش Composer معمولاً بهتر است.

روش ۲: نصب Laravel با Composer از طریق SSH

Laravel برای مدیریت وابستگی‌ها از Composer استفاده می‌کند. در بعضی شرکت‌های هاستینگ ممکن است پورت SSH غیر پیش‌فرض باشد.
(مثال: در یک نمونه، پورت سفارشی 17177 استفاده می‌شود.) بنابراین مشخصات SSH سرویس خودتان را بررسی کنید.

نمونه دستور اتصال:

ssh USER@SERVER_IP_OR_HOST -p PORT

برای بررسی نسخه PHP در SSH:

php -v

ساخت پروژه جدید با Composer

ساخت پروژه:

composer create-project laravel/laravel example-app

اگر نسخه PHP شما محدود است، نسخه Laravel را مشخص کنید تا نصب Fail نشود (مثال):

composer create-project laravel/laravel:^10.0 example-app

ورود به پوشه پروژه:

cd example-app

هشدار کاربردی: دستور زیر برای توسعه محلی است و روی هاست اشتراکی/Production روش استاندارد اجرا نیست؛ وب‌سرور شما باید پوشه public را سرو کند:

php artisan serve

مهم‌ترین بخش روی هاست اشتراکی: تنظیم Document Root روی public

ساختار امن Laravel این است که وب‌سرور فقط پوشه public را در دسترس اینترنت قرار دهد و فایل‌هایی مثل .env و پوشه‌های storage/vendor از وب قابل دسترسی نباشند.

حالت ایده‌آل

اگر در cPanel امکان تغییر مسیر دامنه را دارید، Document Root را روی مسیر زیر بگذارید:

/home/USER/example-app/public

اگر امکان تغییر Document Root ندارید

در این حالت بهتر است از پشتیبانی بخواهید مسیر دامنه را روی public تنظیم کند. اگر پروژه‌تان جدی است (Queue/Worker/Cron)، معمولاً سرور مجازی انتخاب حرفه‌ای‌تری است:
سرور مجازی لینوکس ایران.

کارهای ضروری بعد از نصب (برای اینکه پروژه درست و امن بالا بیاید)

۱) ساخت کلید برنامه (APP_KEY)

php artisan key:generate

۲) تنظیم فایل .env

• APP_ENV=production
• APP_DEBUG=false
• تنظیمات دیتابیس (DB_HOST, DB_DATABASE, DB_USERNAME, DB_PASSWORD)

۳) دسترسی نوشتن برای storage و bootstrap/cache

روی هاست اشتراکی معمولاً لازم است این مسیرها قابل نوشتن باشند؛ در غیر این صورت با خطاهای Permission روبه‌رو می‌شوید.

۴) بهینه‌سازی برای Production

php artisan config:cache
php artisan route:cache
php artisan view:cache

مزایای فریم‌ورک Laravel

سریع و ساده

محبوبیت بالای Laravel باعث شده بسیاری از توسعه‌دهندگان با آن آشنا باشند. ساختار استاندارد و پکیج‌های متنوع، زمان توسعه را کاهش می‌دهد و سریع‌تر به نتیجه می‌رسید.

امنیت بالا

Laravel امکانات امنیتی خوبی ارائه می‌دهد (مثل Hashing، احراز هویت و سطح‌بندی دسترسی). در کنار آن، امنیت هاست/سرور هم اهمیت زیادی دارد.
برای مطالعه بیشتر درباره cPanel:
همه چیز در مورد کنترل پنل هاستینگ cPanel

Performance بهتر

امکان Cache و پیاده‌سازی بهینه‌سازی‌ها باعث می‌شود به Performance بهتر و SEO مطلوب‌تر برسید.

انعطاف‌پذیری و اکوسیستم پکیج‌ها

از سایت‌های ساده تا پروژه‌های بزرگ، پکیج‌های متعدد در اکوسیستم Laravel دست شما را باز می‌گذارد.

هزینه کمتر

Laravel متن‌باز است و هزینه لایسنس ندارد؛ هزینه اصلی معمولاً توسعه و نگهداری است که با ساختار استاندارد می‌تواند در بلندمدت اقتصادی‌تر باشد.

جمع‌بندی

Laravel انتخاب بسیار خوبی برای پروژه‌های مقیاس‌پذیر و سریع است. روی هاست اشتراکی هم قابل نصب است؛ اما موفقیت شما به سازگاری نسخه PHP و مهم‌تر از همه تنظیم صحیح مسیر دامنه روی پوشه public بستگی دارد.

اگر قصد استفاده از هاست اشتراکی دارید: هاست لینوکس ایران (cPanel)
و اگر به کنترل و منابع بیشتر نیاز دارید: سرور مجازی لینوکس ایران.

لینک‌های پیشنهادی مرتبط:

• میزبانی وب (هاست لینوکس و ویندوز)

• خرید لایسنس اشتراکی CloudLinux