Laravel에서 유용한 Console 명령어 정리
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
여러 캐시 충돌, 환경변수 반영 문제 등을 해결할 수 있습니다.