آموزش نصب لاراول در سی پنل

آموزش نصب و اجرای لاراول 12 در سی پنل cPanel

فریم‌ورک لاراول (Laravel) یکی از محبوب‌ترین فریم‌ورک‌های PHP هست که برای توسعه اپلیکیشن‌های مدرن وب استفاده میشه. اگر قصد دارید پروژه لاراولی خودتون رو روی هاست سی‌پنل وان سرور اجرا کنید، در این آموزش مرحله به مرحله پیش میریم: (همچنین در انتهای این صفحه میتونید آموزش ویدیویی رو مشاهده کنید)

پیش‌نیازها

• هاستتون باید از php 8.2 و بالاتر پشتیبانی کنه، چون لاراول 12 حداقل نیازش php 8.2 هستش.

• فعال بودن Composer در هاست (بر روی هاست‌های وان‌سرور فعال هست)

• دسترسی به Terminal از سی‌پنل باشه

1- تنظیمات ورژن php:

ابتدا در cpanel بخش MultiPHP Manager

ما در این آموزش قصد داریم پروژه لاراولی رو از طریق ترمینال سی پنل با استفاده از کامپوزر دانلود کنیم، پس ابتدا از بخش Select PHP Version نسخه Current PHP version رو بر روی 8.2 یا بالاتر تنظیم کنید. سپس در تب Extensions توابعی که برای لاراول نیاز میباشد (پیش نیازهای لاراول) را فعال کنید. حال وارد بخش MultiPHP Manager بشید و نسخه php دامنه مورد نظر رو بر روی PHP 8.2 (alt-php82) یا PHP 8.2 (ea-php82) قرار بدید.

2- ایجاد دیتابیس:

به بخش MySQL® Databases بروید، یک دیتابیس جدید بسازید، سپس یک یوزر دیتابیس ایجاد کنید و پسورد براش تعیین کنید. و در نهایت یوزر رو به دیتابیس متصل کنید و تمام دسترسی‌ها رو فعال کنید.(حتما پسورد رو در جایی یادداشت کنید که در مراحل بعدی نصب لاراول به آن احتیاج داریم)

3- ساخت پروژه لاراول:

در محیط سی پنل به دنبال Terminal بگردید و با کلیک بر روی آن وارد محیط ترمینال یا ssh سی پنل خودتان میشوید. حالا باید با استفاده از composer پروژه لاراول رو دریافت و در فایل منیجر هاست قرار بدید.
همانطور که اطلاع دارید دامنه اصلی هاست شما پوشه public_html را میخواند. پس دقت کنید که وجود تمام فایلهای لاراول شما در این دایرکتوری میتواند خطرات امنیتی داشته باشد. پس برای امنیت بیشتر این مراحل رو انجام میدیم:

ما کل پروژه لاراول رو در مسیر روت اصلی هاستمون (قبل از public_html) داخل یک فولدر قرار میدیم و سپس محتویات پوشه public پروژه مون رو به public_html انتقال میدیم و با کمی تغییرات دیتاهای قرار داده در پوشه رو فراخوانی میکنیم.

پس ابتدا در ترمینال دستور زیر رو وارد میکنیم:

composer global require laravel/installer

بعد از اینکه به درستی دانلود انجام شد با استفاده از دستور زیر پروژه رو در دایرکتوری مورد نظر ایجاد و نصب میکنیم:

composer create-project ==prefer-dist laravel/laravel laravel-app

منتظر بمونید تا نصب کامل بشه و اگر نسخه php درست تنظیم شده باشه و دستور کامپوزر هم به درستی انجام شده باشه پروژه دانلود و درون پوشه ای بنام laravel-app قرار میگیره.
الان کافیه فقط وارد File Manager هاستتون بشید و سپس وارد پوشه laravel-app بشید. فایل .env.example رو پیدا و به .env تغییر بدید و سپس با ویرایشگر فایل منیجر باز کنید و مشخصات دیتابیسی که در مرحله 2 ساختید رو جایگزین کنید.
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=DB
DB_USERNAME=DB_USER
DB_PASSWORD=DB_PASSWORD

توجه: اگر فایل .env.example رو پیدا نکردید باید hidden رو در فایل منیجرتون بر روی show بزارید. برای همین طبق عکس زیر بر روی settings کلیک کنید و گزینه Show Hidden Files (dotfiles) رو فعال کنید:

حالا باید با استفاده از دستور php artisan migrate در دایرکتوری پروژه از ترمینال دیتابیس های دیفالت پروژه رو در دیتابیس ایجاد کنید. به طور مثال در پروژه ای که ساختیم:

cd laravel-app
php artisan migrate

3- انتقال دایرکتوری public:

در این بخش نیاز هست که محتویات داخل public پروژه لاراول رو به پوشه public_html هاست انتقال بدیم.
برای ین کار ابتفا در سی پنل وارد file manager بشید و داخل دایرکتوری لاراولتون که در اینجا laravel-app/public هست را کامل کپی و به دایرکتوری public_html انتقال بدید.
حال فایل index.php رو در پوشه Public_html ادیت کنید و خط های زیر رو به این شکل تغییر بدید:

if (file_exists($maintenance = __DIR__.'/storage/framework/maintenance.php')) {
    require $maintenance;
}
به
if (file_exists($maintenance = __DIR__.'/../sys_one/storage/framework/maintenance.php')) {
    require $maintenance;
}
======
require __DIR__.'/vendor/autoload.php';
به
require __DIR__.'/../sys_one/vendor/autoload.php';
======
$app = require_once __DIR__.'/sys_one/bootstrap/app.php';
به
$app = require_once __DIR__.'/../sys_one/bootstrap/app.php';

الان اگر دامنه رو باز کنید باید صفحه پیش‌فرض لاراول 12 رو ببینید 🎉 🤩
با این روش شما می‌تونید به راحتی پروژه‌های لاراول 12 رو روی هاست سی‌پنل اجرا کنید.
پیشنهاد میشه برای پروژه‌های حرفه‌ای از هاست لاراول وان سرور استفاده کنید که هم از Composer پشتیبانی می‌کنه و هم منابع اختصاصی در اختیارتون می‌ذاره.