lorisleiva/artisan-ui

Run your artisan commands by pressing buttons.

Fund package maintenance!
lorisleiva

Installs: 3 354

Dependents: 0

Suggesters: 0

Security: 0

Stars: 207

Watchers: 5

Forks: 18

Open Issues: 3

Language:Blade

v0.3 2021-06-17 14:00 UTC

This package is auto-updated.

Last update: 2024-03-17 20:00:53 UTC


README

Latest Version on Packagist GitHub Tests Action Status Total Downloads

artisan-ui

Installation

composer require lorisleiva/artisan-ui
php artisan artisan-ui:install

Usage

Just go to /artisan and enjoy! 🌺

Capture 2021-06-13T21 53 30 3

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