راه‌اندازی اولین پروژه لاراول

دسته‌بندی‌ها

راه‌اندازی اولین پروژه لاراول

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

مراحل راه‌اندازی اولین پروژه لاراول

1. پیش‌نیازها

برای استفاده از لاراول باید مطمئن شوید که پیش‌نیازهای زیر نصب شده‌اند:

PHP نسخه 8.1 یا بالاتر
Composer (مدیر بسته‌های PHP)
یک پایگاه داده (مانند MySQL یا SQLite)

2. نصب PHP و Composer

اگر PHP و Composer را نصب نکرده‌اید، می‌توانید آن‌ها را از لینک‌های زیر دانلود و نصب کنید:

بعد از نصب Composer، با استفاده از دستور زیر می‌توانید نسخه آن را بررسی کنید:

bash
composer --version

3. نصب لاراول

برای نصب لاراول، ابتدا باید از Composer استفاده کنید. دستور زیر را در ترمینال اجرا کنید:

bash
composer create-project --prefer-dist laravel/laravel my-project

در اینجا، my-project نام پوشه‌ای است که پروژه در آن قرار می‌گیرد. این دستور پروژه لاراول را با تمام وابستگی‌های لازم نصب می‌کند.

4. تنظیم محیط پروژه

بعد از نصب لاراول، به پوشه پروژه وارد شوید:

bash
cd my-project

در پروژه لاراول یک فایل به نام .env وجود دارد که تنظیمات محیط پروژه (مثل اتصال به پایگاه داده و تنظیمات مختلف) در آن قرار دارد. برای تنظیمات اولیه، می‌توانید فایل .env.example را کپی کرده و به .env تغییر نام دهید:

bash
cp .env.example .env

بعد از آن، کلید اپلیکیشن لاراول را با دستور زیر تولید کنید:

bash
php artisan key:generate

این دستور یک کلید تصادفی برای اپلیکیشن شما تولید می‌کند و در فایل .env ذخیره می‌شود.

5. تنظیم اتصال به پایگاه داده

اگر می‌خواهید از پایگاه داده استفاده کنید (مثل MySQL)، باید تنظیمات مربوط به پایگاه داده را در فایل .env انجام دهید. به عنوان مثال:

env
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_database_username
DB_PASSWORD=your_database_password

6. اجرای سرور محلی

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

bash
php artisan serve

پس از اجرای این دستور، پروژه شما به طور پیش‌فرض در آدرس http://127.0.0.1:8000 در دسترس خواهد بود.

7. ایجاد اولین Route

برای ایجاد اولین مسیر در لاراول، به فایل routes/web.php بروید و یک مسیر ساده ایجاد کنید:

php
Route::get('/', function () {
    return view('welcome');
});

در اینجا، این مسیر به صفحه welcome که به طور پیش‌فرض در لاراول وجود دارد، هدایت می‌کند.

8. اجرای Migration ها

لاراول از Migrations برای مدیریت پایگاه داده استفاده می‌کند. برای اجرای migration‌های پیش‌فرض و ایجاد جدول‌های اولیه، از دستور زیر استفاده کنید:

bash
php artisan migrate

این دستور جداول اولیه لاراول را مانند users, password_resets و دیگر جداول مورد نیاز را در پایگاه داده شما ایجاد می‌کند.

9. ایجاد اولین کنترلر

برای ایجاد یک کنترلر در لاراول، از دستور artisan استفاده کنید. به عنوان مثال:

bash
php artisan make:controller MyController

این دستور یک کنترلر جدید به نام MyController در پوشه app/Http/Controllers ایجاد می‌کند.

10. ایجاد اولین View

برای ایجاد اولین View، می‌توانید یک فایل Blade در پوشه resources/views ایجاد کنید. به عنوان مثال، یک فایل به نام home.blade.php ایجاد کنید:

php
<!-- resources/views/home.blade.php -->

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Home Page</title>
</head>
<body>
    <h1>Welcome to Laravel!</h1>
</body>
</html>

حالا می‌توانید مسیر مربوطه را در routes/web.php ایجاد کنید تا این View نمایش داده شود:

php
Route::get('/home', function () {
    return view('home');
});

11. اولین فرم در لاراول

برای ایجاد یک فرم ساده، ابتدا یک مسیر جدید به کنترلر اضافه کنید تا صفحه‌ای را که فرم در آن قرار دارد، نمایش دهد:

php
Route::get('/form', function () {
    return view('form');
});

Route::post('/submit', function (Request $request) {
    return $request->input('name');
});

سپس، فایل Blade برای فرم را در resources/views ایجاد کنید:

php
<!-- resources/views/form.blade.php -->

<form action="/submit" method="POST">
    @csrf
    <input type="text" name="name" placeholder="Enter your name">
    <button type="submit">Submit</button>
</form>

12. استفاده از Seederها برای داده‌های تست

لاراول امکان استفاده از Seederها برای پر کردن پایگاه داده با داده‌های پیش‌فرض را فراهم می‌کند. برای ایجاد Seeder جدید، از دستور زیر استفاده کنید:

bash
php artisan make:seeder UserSeeder

بعد از ایجاد Seeder، می‌توانید داده‌های پیش‌فرض را به آن اضافه کرده و با دستور زیر آن‌ها را در پایگاه داده وارد کنید:

bash
php artisan db:seed

نتیجه‌گیری

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