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

php artisan CLI لاراول است — از scaffold کردن کلاس تا migrate و clear cache. توسعه‌دهندگانی که artisan را بلدند، ده برابر سریع‌تر فیچر می‌سازند. این مقاله cheatsheet عملی است، نه لیست خشک — هر دستور را با سناریویی که در پروژه واقعی دیده‌ام همراه می‌کنم.

کشف دستورات

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

دستورات 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

ترکیب flagها در make:model وقت زیادی در شروع CRUD صرفه‌جویی می‌کند.

دیتابیس

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

migrate:fresh همه جداول را drop می‌کند — فقط local!

Routing و debug

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

بعد از تعریف route، route:list اولین ابزار debug است.

کش و 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: config:cache و route:cache. local: بعد از تغییر .env حتماً config:clear.

Queue

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

در production با Supervisor اجرا می‌شود نه دستی.

تولید و 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 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 — کمک می‌کنم.