lorisleiva / artisan-ui
Run your artisan commands by pressing buttons.
Fund package maintenance!
lorisleiva
Installs: 3 486
Dependents: 0
Suggesters: 0
Security: 0
Stars: 219
Watchers: 5
Forks: 22
Open Issues: 3
Language:Blade
Requires
- php: ^8.0
- illuminate/contracts: ^8.0
- spatie/laravel-package-tools: ^1.9
Requires (Dev)
- orchestra/testbench: ^6.0
- pestphp/pest: ^0.3.14
- phpunit/phpunit: ^9.3.10
README
Installation
composer require lorisleiva/artisan-ui php artisan artisan-ui:install
Usage
Just go to /artisan
and enjoy! 🌺
Configure access
By default, Artisan UI is only available on local environments. You can provide your own custom authorization logic by providing a callback to the ArtisanUI::auth
method. As usual, you may add this logic to any of your service providers.
The following example allows any user on local environments but only admin users on other environments.
use Lorisleiva\ArtisanUI\Facades\ArtisanUI; ArtisanUI::auth(function ($request) { if (app()->environment('local')) { return true; } return $request->check() && $request->user()->isAdmin(); });
Configure routes
You may change the path and domain of the Artisan UI routes to suit your need using the configuration file located in config/artisan-ui.php
.
Additionally, you may use this configuration file to update the middleware of these routes. By default, the web
middleware group is used as well as the AuthorizeArtisanUI
middleware which protects the Artisan UI routes using the callback provided to the ArtisanUI::auth
method above. Feel free to override that middleware for more custom authorization logic but remember that, without it, the Artisan UI routes will be available to everyone!
Update assets
If you've recently updated the package and something doesn't look right, it might be because the CSS file for the package is not up-to-date and needs to be re-published. Worry not, simply run the artisan-ui:install
command again and you're good to go. You can even do that from the UI now! 🤯
php artisan artisan-ui:install