Env. gitignore (#8)

README.md

@@ -2,7 +2,6 @@
 
 ![image](https://github.com/user-attachments/assets/ad617e05-5d45-4b2c-a6b9-5cd095719fa3)
 
-
 [![Latest Version on Packagist](https://img.shields.io/packagist/v/msamgan/laravel-env-keys-checker.svg?style=flat-square)](https://packagist.org/packages/msamgan/laravel-env-keys-checker)
 [![GitHub Tests Action Status](https://img.shields.io/github/actions/workflow/status/msamgan/laravel-env-keys-checker/run-tests.yml?branch=main&label=tests&style=flat-square)](https://github.com/msamgan/laravel-env-keys-checker/actions?query=workflow%3Arun-tests+branch%3Amain)
 [![Total Downloads](https://img.shields.io/packagist/dt/msamgan/laravel-env-keys-checker.svg?style=flat-square)](https://packagist.org/packages/msamgan/laravel-env-keys-checker)
@@ -14,10 +13,30 @@ and you want to make sure that all the keys are available across all the .env fi
 With a team of developers, it is possible that some developers might forget to add the keys they used in their .env file
 to the .env.example file or the other way around.
 
+## Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+- [Usage](#usage)
+    - [To check if all the keys are available across all the .env files.](#to-check-if-all-the-keys-are-available-across-all-the-env-files)
+    - [To check if the .env and other provided files are present in .gitignore.](#to-check-if-the-env-and-other-provided-files-are-present-in-gitignore)
+- [In Test](#in-test)
+    - [To check if all the keys are available across all the .env files.](#to-check-if-all-the-keys-are-available-across-all-the-env-files-1)
+    - [To check if the .env and other provided files are present in .gitignore.](#to-check-if-the-env-and-other-provided-files-are-present-in-gitignore-1)
+- [Configuration](#configuration)
+- [Testing](#testing)
+- [Changelog](#changelog)
+- [Contributing](#contributing)
+- [Security Vulnerabilities](#security-vulnerabilities)
+- [Credits](#credits)
+- [License](#license)
+
 ## Features
 
 - Check if all the keys are available across all the .env files.
 - Add the missing keys to the .env files automatically (configurable) considering the line numbers and empty lines.
+- Check if the .env and other provided files are present in .gitignore, so that they are not committed to git by
+  mistake.
 
 ## Installation
 
@@ -35,13 +54,24 @@ php artisan vendor:publish --tag="env-keys-checker-config"
 
 ## Usage
 
+### To check if all the keys are available across all the .env files.
+
 ```bash
 php artisan env:keys-check
 ```
 
+### To check if the .env and other provided files are present in .gitignore.
+
+```bash
+php artisan env:in-git-ignore
+```
+
 ## In Test
 
-You can also use this package in your test cases to make sure that all the keys are available across all the .env files.
+You can also use this package in your test cases to make sure the required feature is working as expected.
+
+### To check if all the keys are available across all the .env files.
+
 Add the following code to your test case.
 
 Make sure to add ``--auto-add=none`` to override the default configuration.
@@ -52,6 +82,16 @@ it('tests that the .env key are same across all .env files.', function () {
 });
 ```
 
+### To check if the .env and other provided files are present in .gitignore.
+
+Add the following code to your test case.
+
+```php
+it('tests that the .env and other provided files are present in .gitignore.', function () {
+    $this->artisan('env:in-git-ignore')->assertExitCode(0);
+});
+```
+
 ## Configuration
 
 You can configure the package by publishing the configuration file.
@@ -80,6 +120,14 @@ You can configure the package by publishing the configuration file.
 'auto_add' => 'ask',
 ```
 
+```php
+# config/env-keys-checker.php
+# List of all the .env.* files to be checked if they
+# are present in the .gitignore file.
+
+'gitignore_files' => ['.env'],
+```
+
 ## Testing
 
 ```bash

composer.json

@@ -72,7 +72,7 @@
     "extra": {
         "laravel": {
             "providers": [
-                "Msamgan\\LaravelEnvKeysChecker\\LaravelEnvKeysCheckerServiceProvider"
+                    "Msamgan\\LaravelEnvKeysChecker\\LaravelEnvKeysCheckerServiceProvider"
             ],
             "aliases": {
                 "LaravelEnvKeysChecker": "Msamgan\\LaravelEnvKeysChecker\\Facades\\LaravelEnvKeysChecker"
@@ -81,4 +81,4 @@
     },
     "minimum-stability": "dev",
     "prefer-stable": true
-}
+}

config/env-keys-checker.php

@@ -12,4 +12,8 @@
     // auto: will add the missing keys automatically
     // none: will not add the missing keys
     'auto_add' => 'ask',
+
+    // List of all the .env.* files to be checked if they
+    // are present in the .gitignore file
+    'gitignore_files' => ['.env'],
 ];

src/Commands/EnvInGitIgnoreCommand.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace Msamgan\LaravelEnvKeysChecker\Commands;
+
+use Illuminate\Console\Command;
+
+class EnvInGitIgnoreCommand extends Command
+{
+    public $signature = 'env:in-git-ignore';
+
+    public $description = 'Check if .env file is in .gitignore file.';
+
+    public function handle(): int
+    {
+        $gitIgnoreFile = base_path('.gitignore');
+
+        if (! file_exists($gitIgnoreFile)) {
+            $this->error('!! .gitignore file not found.');
+
+            return self::FAILURE;
+        }
+
+        $gitIgnoreContent = array_map('trim', file($gitIgnoreFile));
+
+        $filesToCheck = config('env-keys-checker.gitignore_files', ['.env']);
+
+        $missingFiles = collect();
+        collect($filesToCheck)->each(function ($file) use ($gitIgnoreContent, $missingFiles) {
+            if (! in_array($file, $gitIgnoreContent)) {
+                $missingFiles->push($file);
+            }
+        });
+
+        if ($missingFiles->isEmpty()) {
+            $this->info('=> All files are present in .gitignore file.');
+
+            return self::SUCCESS;
+        }
+
+        $this->error('!! ' . $missingFiles->implode(', ') . ' file(s) not found in .gitignore file.');
+
+        return self::FAILURE;
+    }
+}

src/Commands/LaravelEnvKeysCheckerCommand.php → src/Commands/KeysCheckerCommand.php

@@ -11,7 +11,7 @@
 use Msamgan\LaravelEnvKeysChecker\Actions\CheckKeys;
 use Msamgan\LaravelEnvKeysChecker\Actions\GetKeys;
 
-class LaravelEnvKeysCheckerCommand extends Command
+class KeysCheckerCommand extends Command
 {
     public $signature = 'env:keys-check {--auto-add=}';
 

src/LaravelEnvKeysCheckerServiceProvider.php

@@ -2,7 +2,8 @@
 
 namespace Msamgan\LaravelEnvKeysChecker;
 
-use Msamgan\LaravelEnvKeysChecker\Commands\LaravelEnvKeysCheckerCommand;
+use Msamgan\LaravelEnvKeysChecker\Commands\EnvInGitIgnoreCommand;
+use Msamgan\LaravelEnvKeysChecker\Commands\KeysCheckerCommand;
 use Spatie\LaravelPackageTools\Package;
 use Spatie\LaravelPackageTools\PackageServiceProvider;
 
@@ -18,6 +19,7 @@ public function configurePackage(Package $package): void
         $package
             ->name('laravel-env-keys-checker')
             ->hasConfigFile()
-            ->hasCommand(LaravelEnvKeysCheckerCommand::class);
+            ->hasCommand(KeysCheckerCommand::class)
+            ->hasCommand(EnvInGitIgnoreCommand::class);
     }
 }