feat(laravel): add setting to override the php command (#14146)

Aliases always ran `php artisan`, so users of Laravel Herd (`herd php`)
or a versioned binary (`php8.4`) couldn't use them. The new
`zstyle ':omz:plugins:laravel' php` setting replaces `php` in every
alias; without it the aliases are unchanged.

plugins/laravel/README.md

@@ -6,6 +6,21 @@ This plugin adds aliases and autocompletion for Laravel [Artisan](https://larave
 plugins=(... laravel)
 ```
 
+## Settings
+
+By default the aliases run `php artisan`. To use a different PHP command, such as
+`herd php` (which runs the PHP version the [Laravel Herd](https://herd.laravel.com) site
+is isolated to, instead of Herd's global version) or a specific version like `php8.4`,
+set this before Oh My Zsh is sourced:
+
+```zsh
+zstyle ':omz:plugins:laravel' php 'herd php'
+```
+
+`php` in the aliases below is then replaced with that command.
+
+## Aliases
+
 | Alias | Description |
 |:-:|:-:|
 | `artisan`  | `php artisan`  |

plugins/laravel/laravel.plugin.zsh

@@ -1,51 +1,56 @@
 #!zsh
-alias artisan='php artisan'
+# Command used to run artisan, e.g. `herd php` or `php8.4` (default: `php`)
-alias bob='php artisan bob::build'
+zstyle -s ':omz:plugins:laravel' php _omz_laravel_php || _omz_laravel_php=php
+
+alias artisan="$_omz_laravel_php artisan"
+alias bob="$_omz_laravel_php artisan bob::build"
 
 # Development
-alias pas='php artisan serve'
+alias pas="$_omz_laravel_php artisan serve"
-alias pad='php artisan dev'
+alias pad="$_omz_laravel_php artisan dev"
-alias pats='php artisan test'
+alias pats="$_omz_laravel_php artisan test"
 
 # Database
-alias pam='php artisan migrate'
+alias pam="$_omz_laravel_php artisan migrate"
-alias pamf='php artisan migrate:fresh'
+alias pamf="$_omz_laravel_php artisan migrate:fresh"
-alias pamfs='php artisan migrate:fresh --seed'
+alias pamfs="$_omz_laravel_php artisan migrate:fresh --seed"
-alias pamr='php artisan migrate:rollback'
+alias pamr="$_omz_laravel_php artisan migrate:rollback"
-alias pads='php artisan db:seed'
+alias pads="$_omz_laravel_php artisan db:seed"
-alias padw='php artisan db:wipe'
+alias padw="$_omz_laravel_php artisan db:wipe"
 
 # Makers
-alias pamm='php artisan make:model'
+alias pamm="$_omz_laravel_php artisan make:model"
-alias pamc='php artisan make:controller'
+alias pamc="$_omz_laravel_php artisan make:controller"
-alias pams='php artisan make:seeder'
+alias pams="$_omz_laravel_php artisan make:seeder"
-alias pamt='php artisan make:test'
+alias pamt="$_omz_laravel_php artisan make:test"
-alias pamfa='php artisan make:factory'
+alias pamfa="$_omz_laravel_php artisan make:factory"
-alias pamp='php artisan make:policy'
+alias pamp="$_omz_laravel_php artisan make:policy"
-alias pame='php artisan make:event'
+alias pame="$_omz_laravel_php artisan make:event"
-alias pamj='php artisan make:job'
+alias pamj="$_omz_laravel_php artisan make:job"
-alias paml='php artisan make:listener'
+alias paml="$_omz_laravel_php artisan make:listener"
-alias pamn='php artisan make:notification'
+alias pamn="$_omz_laravel_php artisan make:notification"
-alias pampp='php artisan make:provider'
+alias pampp="$_omz_laravel_php artisan make:provider"
-alias pamcl='php artisan make:class'
+alias pamcl="$_omz_laravel_php artisan make:class"
-alias pamen='php artisan make:enum'
+alias pamen="$_omz_laravel_php artisan make:enum"
-alias pami='php artisan make:interface'
+alias pami="$_omz_laravel_php artisan make:interface"
-alias pamtr='php artisan make:trait'
+alias pamtr="$_omz_laravel_php artisan make:trait"
-alias pamv='php artisan make:view'
+alias pamv="$_omz_laravel_php artisan make:view"
-alias pammig='php artisan make:migration'
+alias pammig="$_omz_laravel_php artisan make:migration"
 
 
 # Clears
-alias pacac='php artisan cache:clear'
+alias pacac="$_omz_laravel_php artisan cache:clear"
-alias pacoc='php artisan config:clear'
+alias pacoc="$_omz_laravel_php artisan config:clear"
-alias pavic='php artisan view:clear'
+alias pavic="$_omz_laravel_php artisan view:clear"
-alias paroc='php artisan route:clear'
+alias paroc="$_omz_laravel_php artisan route:clear"
-alias paopc='php artisan optimize:clear'
+alias paopc="$_omz_laravel_php artisan optimize:clear"
 
 # queues
-alias paqf='php artisan queue:failed'
+alias paqf="$_omz_laravel_php artisan queue:failed"
-alias paqft='php artisan queue:failed-table'
+alias paqft="$_omz_laravel_php artisan queue:failed-table"
-alias paql='php artisan queue:listen'
+alias paql="$_omz_laravel_php artisan queue:listen"
-alias paqr='php artisan queue:retry'
+alias paqr="$_omz_laravel_php artisan queue:retry"
-alias paqt='php artisan queue:table'
+alias paqt="$_omz_laravel_php artisan queue:table"
-alias paqw='php artisan queue:work'
+alias paqw="$_omz_laravel_php artisan queue:work"
+
+unset _omz_laravel_php