[Laravel] 필수 명령어 총정리: 개발자라면 꼭 알아야 할 명령어들

1. 개요

Laravel의 Artisan CLI를 활용한 다양한 명령어들을 아래와 같이 정리하였습니다. 각 항목별로 번호와 제목 태그를 추가하여 필요 시 위치 이동 및 참조가 용이하도록 구성되어 있습니다.

---

2. 기본 명령어 사용법

2-1. 모델, 마이그레이션, 컨트롤러 생성

모델, 마이그레이션, 팩토리, 시더를 동시에 생성하려면 아래 명령어를 사용합니다.

php artisan make:model {모델명} -mfs

여기서 -m은 마이그레이션, -f는 팩토리, -s는 시더를 각각 생성합니다.

컨트롤러를 생성하려면 다음 명령어를 사용합니다.

php artisan make:controller {컨트롤러명}

미들웨어를 생성하려면 아래와 같이 입력합니다.

php artisan make:middleware {미들웨어명}

2-2. 마이그레이션 관련 명령어

마이그레이션을 실행하려면

php artisan migrate

마이그레이션을 롤백할 때는 --step 옵션을 이용하여 원하는 단계만 롤백할 수 있습니다.

php artisan migrate:rollback --step=1

2-3. 서버 실행

기본 서버 실행은 아래와 같이 실행합니다.

php artisan serve

모든 IP에서 접근 가능한 서버를 실행하려면

php artisan serve --host=0.0.0.0

2-4. 캐시 및 설정 관련 명령어

캐시를 비우려면 다음 명령어들을 순서대로 실행합니다.

php artisan cache:clear
php artisan config:clear
php artisan route:clear
php artisan view:clear

오토로드 파일 재생성을 위해서는 composer를 사용합니다.

composer dump-autoload

2-5. 스케줄러 및 큐 작업

작업 스케줄러를 실행하려면

php artisan schedule:work

기본 큐 워커를 실행하려면

php artisan queue:work

타임아웃 설정과 함께 큐 워커를 실행하려면

php artisan queue:work --timeout=1000

큐 설정 변경은 config/queue.php에서 'default' 값을 database로 변경하고, .env 파일에서 QUEUE_CONNECTION=database로 설정합니다.

---

3. 추가하면 유용한 명령어들

3-1. 리소스 컨트롤러 생성

CRUD가 포함된 리소스 컨트롤러를 생성하려면 다음 명령어를 사용합니다.

php artisan make:controller {컨트롤러명} --resource

3-2. 폼 요청(Request) 클래스 생성

사용자 입력 검증용 클래스를 생성하려면

php artisan make:request {Request클래스명}

3-3. 이벤트와 리스너 생성

이벤트를 생성하려면

php artisan make:event {이벤트명}

리스너를 생성하려면

php artisan make:listener {리스너명}

3-4. 시더와 팩토리 실행

데이터베이스 시더 전체 실행은

php artisan db:seed

특정 시더만 실행하려면

php artisan db:seed --class={시더클래스명}

팩토리를 사용해 데이터를 생성하려면, 예를 들어 User 모델의 경우 아래와 같이 실행합니다.

\App\Models\User::factory(10)->create();

3-5. 로그 정리

Linux나 Ubuntu 환경에서 로그를 확인하려면

tail -f storage/logs/laravel.log

---

 

4. 추가로 유용한 Laravel 명령어들

4-1. 서비스 프로바이더 및 파사드 생성

서비스 프로바이더를 생성하려면

php artisan make:provider {서비스프로바이더명}

파사드를 생성하려면

php artisan make:facade {파사드명}

4-2. 디버깅 및 로그 확인

디버깅 시 dd() 함수를 활용하여 변수 덤프 후 종료할 수 있습니다.

변수 예제: dd($variable);

로그 레벨을 변경하려면 .env 파일에 다음 항목을 추가하거나 수정합니다.

APP_DEBUG=true
LOG_CHANNEL=stack
LOG_LEVEL=debug

4-3. 모델 관련 명령어

모델 팩토리를 생성하려면

php artisan make:factory {모델명}Factory

모델 시더를 실행하려면

php artisan db:seed --class={모델명}Seeder

4-4. CORS 설정

CORS 설정을 위한 패키지를 설치하려면

composer require fruitcake/laravel-cors

설치 후 config/cors.php 파일에서 필요한 설정을 추가합니다.

4-5. 테스트 관련 명령어

전체 테스트를 실행하려면

php artisan test

특정 테스트 파일만 실행하려면

php artisan test --filter {Test클래스명}

테스트 클래스를 생성하려면

php artisan make:test {테스트클래스명}

---

 

5. 환경 설정 관련

5-1. .env 파일 캐시 및 설정 적용

설정 파일들을 캐시하려면 다음을 실행합니다.

php artisan config:cache
php artisan route:cache
php artisan view:cache

설정 캐시를 비우려면

php artisan config:clear

5-2. 파일 퍼미션 관리

Laravel의 storage 및 bootstrap/cache 폴더에 대한 권한을 설정하려면

chmod -R 775 storage bootstrap/cache

 

---

6. 배포 및 최적화 관련

6-1. 프로덕션 환경 최적화

의존성 최적화 및 패키지 설치는 아래 명령어로 실행합니다.

composer install --optimize-autoloader --no-dev

라우트, 뷰, 설정 캐시를 생성합니다.

php artisan config:cache
php artisan route:cache
php artisan view:cache

6-2. 배포 후 데이터베이스 마이그레이션

배포 후 강제 마이그레이션 실행은

php artisan migrate --force

6-3. 세션 및 캐시 클리어

배포 후 최적화 클리어 명령어는

php artisan optimize:clear

 

---

7. 기타 유용한 명령어들

7-1. 배치 작업 실행

배치 작업(큐 대기)을 실행하려면

php artisan queue:listen

7-2. 데이터베이스 백업 및 복원

데이터베이스 백업은 일반적으로 추가 패키지가 필요하며, 실행은

php artisan backup:run

백업된 데이터베이스를 복원하려면

php artisan backup:restore

7-3. 작업 큐 상태 확인

큐 작업 상태를 확인하려면

php artisan queue:failed

실패한 큐 작업을 삭제하려면

php artisan queue:flush

7-4. 미들웨어 상태 확인

현재 활성화된 미들웨어 목록은 아래 명령어로 확인할 수 있습니다.

php artisan route:list