Add support for custom Artisan executable path

- Update git-hooks.php to include a new configuration option 'artisan_path', allowing users to set the path for the Artisan executable within Laravel or Laravel Zero applications. This improves compatibility with different project structures.
- Modify hook template and related source code to use the configured 'artisan_path' instead of the default base_path('artisan').
- Add a test case to validate proper installation of hook files with a custom Artisan path.
- Update Pest.php and TestCase.php to respect the configured 'artisan_path'.

Author: igorsgm

config/git-hooks.php

@@ -204,4 +204,21 @@
         ],
     ],
 
+    /*
+    |--------------------------------------------------------------------------
+    | Artisan Executable Path
+    |--------------------------------------------------------------------------
+    |
+    | This configuration option allows you to set the path of the Artisan
+    | executable within your Laravel or Laravel Zero application.
+    |
+    | By default, the path is set to the base_path('artisan') which corresponds
+    | to the main Artisan executable in a standard Laravel installation.
+    |
+    | In case you are using a Laravel Zero CLI tool, you may need to change
+    | this value to match the path of your main executable file instead
+    | of artisan.php.
+    |
+    */
+    'artisan_path' => base_path('artisan'),
 ];

src/Console/Commands/stubs/hook

@@ -4,4 +4,4 @@ if sh -c ": >/dev/tty" >/dev/null 2>/dev/null; then
     exec < /dev/tty
 fi
 
-php {path}/artisan {command} $@ >&2
+php {artisanPath} {command} $@ >&2

src/GitHooks.php

@@ -56,8 +56,8 @@ public function install(string $hookName)
 
         $hookPath = $this->getGitHooksDir().'/'.$hookName;
         $hookScript = str_replace(
-            ['{command}', '{path}'],
-            [$command, base_path()],
+            ['{command}', '{artisanPath}'],
+            [$command, config('git-hooks.artisan_path')],
             $this->getHookStub()
         );
 

tests/Features/Commands/RegisterHooksTest.php

@@ -37,3 +37,19 @@
         ->toBeFile()
         ->toContainHookArtisanCommand($hookName);
 })->with('registrableHookTypes');
+
+test('Installs hook file in .git/hooks folder with custom artisan path', function ($hookClass, $hookName) {
+    $this->config->set('git-hooks.'.$hookName, [
+        $hookClass,
+    ]);
+
+    $this->config->set('git-hooks.artisan_path', base_path('custom-artisan-path'));
+
+    $this->artisan('git-hooks:register')->assertSuccessful();
+
+    $hookFile = base_path('.git/hooks/'.$hookName);
+
+    expect($hookFile)
+        ->toBeFile()
+        ->toContainHookArtisanCommand($hookName);
+})->with('registrableHookTypes');

tests/Pest.php

@@ -34,7 +34,7 @@
 
 expect()->extend('toContainHookArtisanCommand', function ($hookName) {
     $this->value = file_get_contents($this->value);
-    $artisanCommand = sprintf('php %s git-hooks:%s $@ >&2', base_path('artisan'), $hookName);
+    $artisanCommand = sprintf('php %s git-hooks:%s $@ >&2', config('git-hooks.artisan_path'), $hookName);
 
     return $this->toContain($artisanCommand);
 });

tests/TestCase.php

@@ -51,6 +51,7 @@ public function defineEnvironment($app)
             'post-merge' => [],
             'pre-push' => [],
             'code_analyzers' => [],
+            'artisan_path' => base_path('artisan'),
         ]);
 
         $this->config = $app['config'];