نصب و راه‌اندازی Laravel: راهنمای جامع

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

پیش‌نیازها

قبل از شروع نصب Laravel، اطمینان حاصل کنید که پیش‌نیازهای زیر را بر روی سیستم خود دارید:

• PHP: نسخه 8.1 یا بالاتر.
• Composer: مدیر بسته PHP که برای نصب و مدیریت وابستگی‌های Laravel ضروری است.
• پایگاه داده: یکی از پایگاه‌های داده پشتیبانی شده توسط Laravel مانند MySQL، PostgreSQL، SQLite یا SQL Server.
• وب سرور: یک وب سرور مانند Apache یا Nginx برای میزبانی اپلیکیشن Laravel.
• PHP Extensions: برخی از افزونه‌های PHP مانند OpenSSL، PDO، Tokenizer، XML، Mbstring و JSON باید فعال باشند.

نصب Composer

Composer را می‌توان از طریق وب‌سایت رسمی آن (https://getcomposer.org/) دانلود و نصب کرد. پس از نصب، مطمئن شوید که Composer به درستی در مسیر سیستم شما قرار دارد تا بتوانید از طریق خط فرمان به آن دسترسی داشته باشید.

بررسی PHP و Extensions

برای بررسی نسخه PHP و افزونه‌های فعال، می‌توانید از دستور زیر در خط فرمان استفاده کنید:

php -v

برای بررسی افزونه‌های PHP، می‌توانید یک فایل PHP با محتوای زیر ایجاد کنید و آن را از طریق وب سرور اجرا کنید:

<?php
phpinfo();
?>

این فایل اطلاعات کاملی در مورد پیکربندی PHP و افزونه‌های فعال نمایش می‌دهد.

روش‌های نصب Laravel

Laravel را می‌توان به روش‌های مختلفی نصب کرد. در اینجا به دو روش اصلی اشاره می‌کنیم:

1. نصب از طریق Composer

این روش رایج‌ترین و توصیه شده‌ترین روش برای نصب Laravel است. با استفاده از Composer، می‌توانید Laravel را به راحتی دانلود و نصب کنید و وابستگی‌های آن را مدیریت کنید.

برای نصب Laravel از طریق Composer، دستور زیر را در خط فرمان اجرا کنید:

composer create-project --prefer-dist laravel/laravel your-project-name

در این دستور، your-project-name نام پوشه‌ای است که Laravel در آن نصب خواهد شد. Composer به طور خودکار Laravel و تمام وابستگی‌های آن را دانلود و نصب می‌کند.

2. نصب از طریق Laravel Installer

Laravel Installer یک ابزار خط فرمان است که به شما امکان می‌دهد پروژه‌های Laravel را به سرعت ایجاد کنید. برای استفاده از Laravel Installer، ابتدا باید آن را به صورت سراسری نصب کنید:

composer global require laravel/installer

پس از نصب Laravel Installer، می‌توانید از دستور زیر برای ایجاد یک پروژه جدید Laravel استفاده کنید:

laravel new your-project-name

این دستور یک پروژه جدید Laravel با نام your-project-name ایجاد می‌کند.

پیکربندی Laravel

پس از نصب Laravel، باید آن را پیکربندی کنید تا با محیط توسعه و پایگاه داده شما سازگار شود.

فایل .env

فایل .env یک فایل پیکربندی است که حاوی اطلاعات حساس مانند کلید برنامه، اطلاعات پایگاه داده و تنظیمات دیگر است. این فایل نباید در مخزن کد شما قرار گیرد.

پس از نصب Laravel، یک فایل .env.example در ریشه پروژه ایجاد می‌شود. این فایل را به .env کپی کنید و مقادیر را مطابق با محیط خود تغییر دهید.

مهم‌ترین تنظیمات در فایل .env عبارتند از:

• APP_NAME: نام برنامه شما.
• APP_ENV: محیط برنامه (local، development، production).
• APP_DEBUG: فعال یا غیرفعال کردن حالت دیباگ.
• APP_URL: آدرس URL برنامه شما.
• DB_CONNECTION: نوع پایگاه داده (mysql، postgresql، sqlite، sqlsrv).
• DB_HOST: آدرس سرور پایگاه داده.
• DB_PORT: پورت پایگاه داده.
• DB_DATABASE: نام پایگاه داده.
• DB_USERNAME: نام کاربری پایگاه داده.
• DB_PASSWORD: رمز عبور پایگاه داده.

کلید برنامه (Application Key)

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

php artisan key:generate

این دستور یک کلید برنامه جدید تولید می‌کند و آن را در فایل .env ذخیره می‌کند.

مهاجرت‌های پایگاه داده (Database Migrations)

مهاجرت‌های پایگاه داده به شما امکان می‌دهند ساختار پایگاه داده خود را به صورت کد تعریف کنید و آن را به راحتی تغییر دهید. برای اجرای مهاجرت‌های پایگاه داده، دستور زیر را در خط فرمان اجرا کنید:

php artisan migrate

این دستور تمام مهاجرت‌های موجود در پوشه database/migrations را اجرا می‌کند و جداول پایگاه داده را ایجاد می‌کند.

راه‌اندازی وب سرور

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

Apache

برای پیکربندی Apache، باید یک فایل .htaccess در پوشه public پروژه Laravel ایجاد کنید. این فایل به Apache می‌گوید که تمام درخواست‌ها را به فایل index.php هدایت کند.

همچنین، باید ماژول mod_rewrite را در Apache فعال کنید.

Nginx

برای پیکربندی Nginx، باید یک بلوک سرور جدید در فایل پیکربندی Nginx ایجاد کنید. این بلوک سرور باید به پوشه public پروژه Laravel اشاره کند و درخواست‌ها را به فایل index.php هدایت کند.

تست نصب

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

نکات تکمیلی

• Caching: برای بهبود عملکرد برنامه خود، از سیستم کش Laravel استفاده کنید.
• Queueing: برای پردازش وظایف زمان‌بر به صورت پس‌زمینه، از سیستم صف Laravel استفاده کنید.
• Logging: برای ثبت خطاها و اطلاعات مهم برنامه خود، از سیستم لاگ Laravel استفاده کنید.
• Security: برای محافظت از برنامه خود در برابر حملات، از ویژگی‌های امنیتی Laravel استفاده کنید.

با دنبال کردن این راهنما، می‌توانید Laravel را به راحتی نصب و راه‌اندازی کنید و از قدرت و انعطاف‌پذیری این فریم‌ورک برای توسعه وب‌اپلیکیشن‌های مدرن و مقیاس‌پذیر بهره‌مند شوید.