دستورات Artisan پرکاربرد در Laravel 12 — راهنمای خط فرمان

php artisan رابط خط فرمان (CLI) لاراول است — از ساختن کلاس‌ها تا migrate دیتابیس و پاک کردن cache. کسی که Artisan را بلد است، کارهای تکراری را با یک دستور انجام می‌دهد و خیلی سریع‌تر فیچر می‌سازد. این مقاله cheatsheet عملی دستورات پرکاربرد Laravel 12 است، گروه‌بندی‌شده بر اساس کار روزمره.

کشف دستورات

php artisan list
php artisan help migrate
php artisan --version
php artisan about

about نسخه Laravel و PHP، محیط (env) و وضعیت cacheها را یک‌جا نشان می‌دهد — اولین دستور وقتی پروژه‌ای را تحویل می‌گیرید.

دستورات make — scaffold

php artisan make:model Post -mfc
# -m migration, -f factory, -c controller

php artisan make:controller PostController --resource
php artisan make:request StorePostRequest
php artisan make:middleware EnsureUserIsAdmin
php artisan make:policy PostPolicy --model=Post
php artisan make:command SendWeeklyReport
php artisan make:job ProcessVideoUpload
php artisan make:event OrderPlaced
php artisan make:listener SendOrderNotification --event=OrderPlaced
php artisan make:enum OrderStatus
php artisan make:class Services/InvoiceService

ترکیب flagها در make:model وقت زیادی در شروع CRUD صرفه‌جویی می‌کند. make:enum و make:class از Laravel 11 اضافه شده‌اند. در Laravel 12 فایل routes/api.php به‌صورت پیش‌فرض وجود ندارد؛ با php artisan install:api ساخته می‌شود.

دیتابیس

php artisan migrate
php artisan migrate:fresh --seed
php artisan migrate:rollback --step=1
php artisan migrate:status
php artisan db:seed
php artisan db:seed --class=UserSeeder
php artisan db:show
php artisan db:table posts

migrate:fresh همه جداول را drop می‌کند — فقط local! migrate:status نشان می‌دهد کدام migrationها اجرا شده‌اند. ساخت داده تست با factory و seeder در Factory و Seeder پیشرفته آمده است.

Routing و debug

php artisan route:list
php artisan route:list --name=posts
php artisan serve --port=8080
php artisan tinker

بعد از تعریف route، route:list اولین ابزار debug است. tinker یک کنسول تعاملی با کل اپلیکیشن باز می‌کند — برای امتحان سریع یک query یا مدل بدون ساختن route.

کش و config

php artisan config:clear
php artisan config:cache
php artisan cache:clear
php artisan view:clear
php artisan optimize:clear
php artisan optimize

production بعد از deploy: php artisan optimize — در Laravel 12 همزمان config، route، view و event را cache می‌کند (معادل اجرای config:cache و route:cache و بقیه). local: بعد از تغییر .env حتماً config:clear. مراحل کامل در Deploy لاراول روی Ubuntu.

Queue

php artisan queue:work
php artisan queue:listen
php artisan queue:restart
php artisan queue:failed
php artisan queue:retry all

در production با Supervisor اجرا می‌شود نه دستی؛ بعد از هر deploy، queue:restart workerها را وادار می‌کند کد جدید را بارگذاری کنند. مفاهیم پایه در آموزش Queue در Laravel.

تولید و maintenance

php artisan key:generate
php artisan storage:link
php artisan down --secret="token"
php artisan up
php artisan schedule:list
php artisan schedule:run
php artisan schedule:work

روی سرور، cron هر دقیقه schedule:run را اجرا می‌کند؛ روی سیستم خودتان schedule:work همین کار را بدون cron انجام می‌دهد. تنظیم کامل در زمان‌بندی کارها با cron.

کیفیت کد

php artisan test
./vendor/bin/pint

دستورات سفارشی

با make:command command خودتان را در app/Console/Commands می‌سازید — مثلاً import روزانه از API.

اشتباهات رایج

• migrate:fresh روی production
• فراموش optimize:clear بعد از debug عجیب
• queue:work بدون restart بعد از deploy کد جدید
• config:cache روی local و سردرگمی با .env

جمع‌بندی

Artisan extension دست شماست — make برای سرعت، migrate برای schema، optimize برای production. env: راهنمای .env.

استقرار Laravel — کمک می‌کنم.