راهنمای کامل نصب لاراول (روی سرور لینوکس و دایرکت ادمین)

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

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

پیش‌نیازهای نصب لاراول

قبل از شروع، مطمئن شوید که سرور شما پیش‌نیازهای زیر را دارد:

یک سرور لینوکس (اوبونتو، AlmaLinux یا …).
یک وب‌سرور مانند آپاچی یا Nginx.
PHP نسخه 8.1 یا بالاتر.
ابزار Composer (مدیر وابستگی‌های PHP).
یک پایگاه داده مانند MySQL یا MariaDB.

در ادامه، ما تمام این موارد را قدم به قدم نصب خواهیم کرد.

روش اول: نصب لاراول روی سرور لینوکس (اوبونتو)

این روش به شما کنترل کامل بر روی تمام جنبه‌های سرور را می‌دهد و برای توسعه‌دهندگان حرفه‌ای توصیه می‌شود.

قدم ۱: نصب پکیج‌های مورد نیاز (LAMP Stack)

ابتدا، پکیج‌های لازم از جمله آپاچی، MySQL، PHP و افزونه‌های مورد نیاز لاراول را نصب می‌کنیم.

sudo apt update && sudo apt upgrade -y
sudo apt install apache2 mysql-server php php-mbstring php-xml php-curl php-zip php-gd php-mysql git -y

قدم ۲: ایجاد دیتابیس برای پروژه

یک پایگاه داده و کاربر مجزا برای پروژه لاراول خود ایجاد کنید.

# وارد محیط MySQL شوید
sudo mysql

# دستورات زیر را با اطلاعات دلخواه خود جایگزین کنید
CREATE DATABASE laravel_db;
CREATE USER 'laravel_user'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON laravel_db.* TO 'laravel_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

قدم ۳: نصب Composer

Composer ابزار مدیریت پکیج برای PHP است. آن را به صورت سراسری نصب کنید:

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

قدم ۴: نصب و پیکربندی لاراول

به دایرکتوری وب‌سرور بروید و با استفاده از Composer، یک پروژه جدید لاراول ایجاد کنید:
```
cd /var/www
sudo composer create-project --prefer-dist laravel/laravel my-project
```

دسترسی‌های لازم را به پوشه پروژه بدهید:

sudo chown -R www-data:www-data /var/www/my-project
sudo chmod -R 775 /var/www/my-project/storage

فایل تنظیمات محیطی (environment) را ویرایش کنید:
```
cd /var/www/my-project
sudo nano .env
```
در این فایل، اطلاعات دیتابیسی را که در قدم ۲ ساختید، وارد کنید:
```
DB_DATABASE=laravel_db
DB_USERNAME=laravel_user
DB_PASSWORD=your_strong_password
```

قدم ۵: پیکربندی وب‌سرور آپاچی

یک فایل Virtual Host جدید برای سایت خود ایجاد کنید تا آپاچی بداند چگونه به درخواست‌ها پاسخ دهد.

sudo nano /etc/apache2/sites-available/laravel.conf

محتوای زیر را در فایل کپی کنید:

<VirtualHost *:80>
    ServerName your_domain.com
    DocumentRoot /var/www/my-project/public

    <Directory /var/www/my-project>
        AllowOverride All
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/laravel-error.log
    CustomLog ${APACHE_LOG_DIR}/laravel-access.log combined
</VirtualHost>

در نهایت، سایت جدید را فعال کرده، ماژول Rewrite را روشن و آپاچی را ری‌استارت کنید:

sudo a2ensite laravel.conf
sudo a2enmod rewrite
sudo systemctl restart apache2

اکنون با مراجعه به دامنه خود، باید صفحه پیش‌فرض لاراول را مشاهده کنید.

روش دوم: نصب لاراول در دایرکت ادمین

نصب لاراول روی کنترل پنل دایرکت ادمین بسیار ساده‌تر است، زیرا بسیاری از پیش‌نیازها از قبل نصب شده‌اند.

قدم ۱: نصب Composer

از طریق SSH به سرور متصل شوید و Composer را نصب کنید:

curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer

قدم ۲: ایجاد پروژه لاراول

وارد دایرکتوری public_html هاست مورد نظر خود شوید. توجه: نام کاربری و دامنه را با مقادیر واقعی جایگزین کنید.
```
cd /home/USERNAME/domains/YOUR_DOMAIN/public_html/
```
با استفاده از Composer پروژه لاراول را در همین مسیر نصب کنید:
```
composer create-project --prefer-dist laravel/laravel .
```

قدم ۳: پیکربندی دایرکت ادمین برای لاراول

ریشه (Document Root) پروژه‌های لاراول، پوشه public است. باید این موضوع را به دایرکت ادمین اطلاع دهیم.

وارد کنترل پنل دایرکت ادمین با دسترسی ادمین یا کاربر شوید.
به بخش Domain Setup بروید و روی دامنه مورد نظر کلیک کنید.
در پایین صفحه، روی لینک Custom HTTPD Configurations کلیک کنید.
در کادر متنی، کد زیر را وارد کرده و روی Save کلیک کنید:
```
|?DOCROOT=`HOME`/domains/`DOMAIN`/public_html/public|
```

این تنظیم به دایرکت ادمین می‌گوید که به جای public_html، از پوشه public_html/public به عنوان ریشه سایت استفاده کند. با سرور مجازی فنلاند که از موقعیت‌های پرطرفدار برای میزبانی است، می‌توانید پروژه‌های لاراول خود را با سرعت و پایداری بالا اجرا کنید.

فهرست تیترها