Laravel .gitignore 템플릿 해설

Laravel.gitignore는 Composer와 npm으로 의존성을 설치하는 Laravel 애플리케이션용이다. Laravel 프로젝트에 기본으로 들어 있는 .gitignore와 비슷한 규칙에, Homestead·Vagrant 같은 개발 환경 파일이 더해져 있다.

가장 중요한 것은 .env다. Laravel은 DB 비밀번호, APP_KEY, 메일·결제 API 키를 모두 .env에서 읽으므로 이 파일이 커밋되면 애플리케이션의 비밀이 전부 노출된다.

규칙별 해설

패턴	무엇을, 왜 무시하나
/vendor/node_modules/	의존성composer install과 npm install로 다시 만들어지는 폴더다. composer.lock과 package-lock.json은 커밋해 같은 버전을 설치하게 한다.
.env.env.backup.env.production	환경 파일애플리케이션 비밀과 환경별 설정이다. 변수 목록은 .env.example로 공유하며, 이 템플릿은 그 파일을 무시하지 않는다.
public/storagepublic_html/storagestorage/*.key	스토리지 링크·키php artisan storage:link가 만드는 심볼릭 링크와 Passport의 OAuth 개인 키(oauth-private.key)다. 링크는 서버마다 다시 만들고, 키는 비밀이다.
/public/buildpublic/hotpublic_html/hotnpm-debug.logyarn-error.log	프런트엔드 빌드Vite가 만든 빌드 결과와, 개발 서버가 떠 있음을 알리는 hot 파일이다. hot 파일이 커밋되면 운영 서버가 존재하지 않는 개발 서버에서 에셋을 불러오려 한다.
.phpunit.result.cache/.phpunit.cache	테스트 캐시PHPUnit이 실패한 테스트 순서 등을 기억하는 캐시다.
Homestead.yamlHomestead.json/.vagrant.phpactor.json/storage/pail	개발 환경·도구개인 Homestead 설정, Vagrant 상태, Phpactor 설정, Laravel Pail 로그 파일이다.
auth.json	Composer 인증비공개 패키지 저장소의 토큰과 비밀번호가 저장되는 Composer 인증 파일이다.
bootstrap/compiled.phpapp/storage/	레거시 경로Laravel 4 시절의 컴파일 파일과 스토리지 경로다. 최신 버전에서는 생기지 않는다.

실무에서 주의할 점

• .env.example에는 실제 값 대신 자리표시자를 두고 커밋한다.
• storage/ 아래의 app, framework, logs 폴더에는 Laravel이 기본으로 넣어 둔 하위 .gitignore가 있으니 지우지 않는다.
• .env가 이력에 남았다면 php artisan key:generate로 APP_KEY를 바꾸고 DB·API 비밀번호도 교체한다.

원본 템플릿

/vendor/node_modules/npm-debug.logyarn-error.log# Laravel 4 specificbootstrap/compiled.phpapp/storage/# Laravel 5 & Lumen specificpublic/storagepublic/hot# Laravel 5 & Lumen specific with changed public pathpublic_html/storagepublic_html/hotstorage/*.key.envHomestead.yamlHomestead.json/.vagrant.phpunit.result.cache/.phpunit.cache/public/build/storage/pail.env.backup.env.production.phpactor.jsonauth.json

함께 쓰는 템플릿

다른 템플릿 해설