Plantilla .gitignore de Laravel explicada

Laravel.gitignore es para aplicaciones Laravel que instalan dependencias con Composer y npm. Tiene reglas parecidas al .gitignore que trae por defecto un proyecto Laravel, más archivos de entornos de desarrollo como Homestead y Vagrant.

Lo más importante es .env. Laravel lee de .env la contraseña de la base de datos, APP_KEY y las claves de API de correo y pagos, así que si este archivo se confirma, quedan expuestos todos los secretos de la aplicación.

Explicación regla por regla

Patrón	Qué ignora y por qué
/vendor/node_modules/	DependenciasSon carpetas que se regeneran con composer install y npm install. Confirma composer.lock y package-lock.json para que se instalen las mismas versiones.
.env.env.backup.env.production	Archivos de entornoSon los secretos de la aplicación y la configuración por entorno. La lista de variables se comparte con .env.example, y esta plantilla no ignora ese archivo.
public/storagepublic_html/storagestorage/*.key	Enlace y claves de almacenamientoSon el enlace simbólico que crea php artisan storage:link y la clave privada OAuth de Passport (oauth-private.key). El enlace se vuelve a crear en cada servidor y la clave es secreta.
/public/buildpublic/hotpublic_html/hotnpm-debug.logyarn-error.log	Compilación del frontendSon los resultados de compilación de Vite y el archivo hot, que indica que el servidor de desarrollo está en marcha. Si se confirma el archivo hot, el servidor de producción intentará cargar los recursos desde un servidor de desarrollo que no existe.
.phpunit.result.cache/.phpunit.cache	Caché de pruebasEs la caché con la que PHPUnit recuerda, entre otras cosas, el orden de las pruebas fallidas.
Homestead.yamlHomestead.json/.vagrant.phpactor.json/storage/pail	Entorno de desarrollo y herramientasSon la configuración personal de Homestead, el estado de Vagrant, la configuración de Phpactor y los archivos de registro de Laravel Pail.
auth.json	Autenticación de ComposerEs el archivo de autenticación de Composer donde se guardan los tokens y contraseñas de repositorios de paquetes privados.
bootstrap/compiled.phpapp/storage/	Rutas heredadasSon el archivo compilado y la ruta de almacenamiento de la época de Laravel 4. No aparecen en las versiones recientes.

Precauciones en la práctica

• En .env.example pon marcadores en lugar de valores reales y confírmalo.
• Las carpetas app, framework y logs bajo storage/ tienen .gitignore de subdirectorio que Laravel incluye por defecto; no los borres.
• Si .env quedó en el historial, cambia APP_KEY con php artisan key:generate y sustituye también las contraseñas de base de datos y API.

Plantilla original

/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

Plantillas que suelen usarse juntas

Otras plantillas explicadas