Laravel에서 유용한 Console 명령어 정리 updated_at: 2024-12-14 03:25

Laravel에서 자주 사용하는 Artisan & Composer 명령어 정리

Laravel 개발/운영 환경에서 알아두면 매우 유용한 명령어들을 간결하게 정리한 문서입니다.
CLI를 사용할 때 php artisan, npm, composer 기반으로 구성된 명령어들이며, 자주 사용하는 목적별로 분류하였습니다.


Laravel 버전 확인

php artisan --version

Webpack / Mix 빌드

# 개발자 모드
npm run dev
npm run development

# 운영 배포 모드 (minify 포함)
npm run prod
npm run production

설정 캐시 및 초기화

php artisan config:cache     # config 파일 및 .env 캐싱
php artisan config:clear     # 캐시 제거 (개발 중에는 clear 사용)

.env 또는 config 파일 변경 시에는 반드시 clear → cache 순으로 적용해야 합니다.


사이트 점검 모드 (유지보수 모드)

php artisan down     # 사이트 점검 모드 진입
php artisan up       # 점검 모드 종료

라우트(Route) 명령어

php artisan route:list     # 라우트 리스트 확인
php artisan route:clear    # 라우트 캐시 제거
php artisan route:cache    # 라우트 캐싱

마이그레이션(Migrations)

php artisan migrate             # 마이그레이션 실행
php artisan migrate:status      # 현재 마이그레이션 상태 확인
php artisan migrate:generate    # (패키지 필요) 모델 기반 마이그레이션 생성

캐시 관련

php artisan cache:clear       # 전체 캐시 제거
php artisan view:clear        # 뷰 캐시 제거
php artisan config:clear      # 설정 캐시 제거
php artisan route:clear       # 라우트 캐시 제거
php artisan optimize:clear    # 최적화 캐시 전체 제거

기타 Artisan 명령어

php artisan list          # 사용 가능한 전체 Artisan 명령어 리스트
php artisan key:generate  # .env의 APP_KEY 생성 및 갱신
php artisan storage:link  # storage → public/storage 심볼릭 링크 생성
php artisan env           # 현재 Laravel 환경 출력

Debugbar 관련

php artisan debugbar:clear   # 디버그 로그 및 스토리지 초기화

Composer 명령어

패키지 설치 및 삭제

composer require [패키지명]
composer require --dev [패키지명]
composer remove [패키지명]

오토로딩 관련

composer dump-autoload -o     # class not found 문제 해결용 최적화
composer dumpautoload         # 오토로더 재생성

배포 최적화

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

--no-dev 옵션은 운영환경에서 devDependencies를 설치하지 않게 합니다.


에러 해결 순서 추천

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

여러 캐시 충돌, 환경변수 반영 문제 등을 해결할 수 있습니다.


참고: Laravel 공식 문서 (laravel.com)

평점을 남겨주세요
평점 : 5.0
총 투표수 : 1

질문 및 답글