📌 Artisan چیست؟

Artisan به شما این امکان را می‌دهد که بسیاری از وظایف معمول و تکراری پروژه‌های لاراول را به راحتی از طریق خط فرمان انجام دهید. این دستورات شامل ایجاد فایل‌های مختلف (مثل مدل‌ها، کنترلرها، مهاجرت‌ها، و ...) و انجام وظایف مربوط به عملیات‌های دیتابیس، کش، تولید مستندات و غیره می‌شود.

🛠️ دستورات معمول Artisan

1. php artisan list

این دستور تمام دستورات موجود در Artisan را لیست می‌کند.

bash
CopyEdit
php artisan list

2. php artisan make:*

دستورات make برای ایجاد فایل‌ها و کلاس‌های مختلف در لاراول استفاده می‌شود. به کمک این دستورات می‌توانید فایل‌های کنترلر، مدل، مایگریشن و غیره را به‌سرعت بسازید.

• ایجاد مدل:

  bash
  CopyEdit
  php artisan make:model ModelName
  

• ایجاد کنترلر:

  bash
  CopyEdit
  php artisan make:controller ControllerName
  

• ایجاد مایگریشن:

  bash
  CopyEdit
  php artisan make:migration migration_name
  

• ایجاد فکتوری:

  bash
  CopyEdit
  php artisan make:factory FactoryName
  

• ایجاد مشاهده (view):

  bash
  CopyEdit
  php artisan make:view view_name
  

3. php artisan migrate

این دستور برای اجرای مهاجرت‌ها (migrations) استفاده می‌شود و به شما این امکان را می‌دهد که تغییرات دیتابیس را در پروژه اعمال کنید.

bash
CopyEdit
php artisan migrate

• برای برگشتن از آخرین مهاجرت‌ها:

  bash
  CopyEdit
  php artisan migrate:rollback
  

• برای بازنشانی کامل مهاجرت‌ها:

  bash
  CopyEdit
  php artisan migrate:reset
  

4. php artisan serve

این دستور برای راه‌اندازی سرور توسعه محلی (local development server) استفاده می‌شود.

bash
CopyEdit
php artisan serve

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

5. php artisan tinker

ابزار Tinker به شما این امکان را می‌دهد که به صورت تعاملی با اپلیکیشن لاراول خود ارتباط برقرار کنید و دستورات PHP را به طور مستقیم اجرا کنید.

bash
CopyEdit
php artisan tinker

در این محیط، می‌توانید کدهای PHP را تست کنید، مدل‌ها را فراخوانی کرده و به داده‌ها دسترسی پیدا کنید.

6. php artisan cache:clear

این دستور برای پاک‌سازی کش‌های مختلف اپلیکیشن (مثل کش پیکربندی، کش ویوها، کش روت‌ها) استفاده می‌شود.

bash
CopyEdit
php artisan cache:clear

7. php artisan config:cache

این دستور کش پیکربندی را ایجاد می‌کند تا بارگذاری تنظیمات اپلیکیشن سریع‌تر شود.

bash
CopyEdit
php artisan config:cache

8. php artisan route:cache

این دستور کش روت‌ها را ایجاد می‌کند تا درخواست‌های HTTP سریع‌تر پردازش شوند.

bash
CopyEdit
php artisan route:cache

9. php artisan view:cache

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

bash
CopyEdit
php artisan view:cache

10. php artisan db:seed

این دستور برای پر کردن دیتابیس با داده‌های آزمایشی (seeds) استفاده می‌شود. به کمک این دستور، می‌توانید داده‌های پیش‌فرض یا آزمایشی در جدول‌های دیتابیس وارد کنید.

bash
CopyEdit
php artisan db:seed

🧩 دستورات دیگر Artisan

• php artisan queue:work: برای اجرای صف‌های کاری (job queues).

• php artisan make:middleware: برای ایجاد Middleware.

• php artisan make:command: برای ایجاد دستورات سفارشی Artisan.

• php artisan make:event: برای ایجاد رویدادها (Events).

• php artisan make:listener: برای ایجاد شنوندگان (Listeners).

• php artisan make:job: برای ایجاد وظایف (Jobs).

• php artisan make:policy: برای ایجاد قوانین دسترسی (Policies).

🛠️ ایجاد دستورات سفارشی در Artisan

اگر نیاز به ایجاد دستورات شخصی‌سازی شده برای پروژه خود دارید، می‌توانید دستورات سفارشی در Artisan ایجاد کنید. برای این کار، از دستور make:command استفاده می‌کنید.

1. ایجاد دستور سفارشی

bash
CopyEdit
php artisan make:command MyCustomCommand

این دستور یک کلاس جدید در مسیر app/Console/Commands ایجاد می‌کند. شما می‌توانید این کلاس را برای انجام هر نوع عملیاتی که می‌خواهید پیاده‌سازی کنید.

2. تعریف عملیات در دستور سفارشی

در فایل MyCustomCommand.php، متد handle() را برای تعریف عملیات مورد نظر خود پیاده‌سازی می‌کنید.

php
CopyEdit
public function handle()
{
    $this->info('This is my custom command!');
}

3. اجرای دستور سفارشی

بعد از تعریف دستور خود، می‌توانید آن را از طریق خط فرمان اجرا کنید.

bash
CopyEdit
php artisan my:custom-command

✅ جمع‌بندی

• Artisan یک ابزار خط فرمان قدرتمند است که کار با پروژه‌های لاراولی را بسیار ساده‌تر و سریع‌تر می‌کند.

• دستورات مختلف مانند php artisan make:, php artisan migrate, php artisan serve, و php artisan tinker به شما این امکان را می‌دهند که به راحتی عملیات مختلف پروژه را انجام دهید.

• شما می‌توانید دستورات سفارشی برای نیازهای خاص پروژه خود بسازید.

این ابزار به توسعه‌دهندگان لاراول کمک می‌کند تا بسیاری از وظایف رایج را به سرعت و به آسانی انجام دهند.