The package allows you to execute artisan commands remotely, using HTTP, and receiving propagating output on the page.
Your command execution won't run into server's MAX_EXECUTION_TIME, allowing you to preserve original server configuration.
In general, the package could very well assist transitioning your project to CI/CD with auto-scaling, when supporters have no direct access to the server terminal.
Use composer to install Remotisan to your Laravel project. php7.4+ is required.
composer require paymeservice/remotisanYou can publish the config file with:
php artisan vendor:publish --tag="remotisan-config"Optionally, you can publish the views using. The views will be published into /resources/views/vendor/remotisan/ directory for your further adjustments.
php artisan vendor:publish --tag="remotisan-views"-
Remotisan allows you to customize default routes prefix, by adjusting base_url_prefix setting, do not forget to clear cached routes afterwards.
-
Add any command you wish to be exposed to Remotisan in config, by adjusting the following part.
Note: UserRoles class is NOT provided, for demonstration purpose only!
[
"commands" => [
"allowed" => [ // command level ACL.
"COMMAND_NAME" => ["roles" => [UserRoles::TECH_SUPPORT]],
"COMMAND_FOR_DEVOPS_ONLY" => ["roles" => [UserRoles::DEV_OPS]],
"COMMAND_SHARED" => ["roles" => [UserRoles::TECH_SUPPORT, UserRoles::DEV_OPS]]
]
]
]Use roles to define who is allowed to execute the command.
You are able to configure environment specific commands by simply static json string in your .env file with name REMOTISAN_ALLOWED_COMMANDS.
REMOTISAN_ALLOWED_COMMANDS='{"artisanCommandName":{"roles":[]}, "artisanSecondCommand":{"roles":[]}}'Inside your AppServiceProvider::boot() add calls to \Remotisan::authWith($role, $callable).
Callable receive a \Illuminate\Http\Request instance and should return true if the request (probably by the user) matches the given role.
The roles MUST be matching to the roles you've defined in Remotisan config.
\Remotisan::authWith(UserRoles::TECH_SUPPORT, function(\Illuminate\Http\Request $request) {
$user = $request->user('web');
return $user && $user->isAllowed(UserPermissions::TECH_SUPPORT);
});
\Remotisan::authWith(UserRoles::DEV_OPS, function(\Illuminate\Http\Request $request) {
$user = $request->user('web');
return $user && $user->isAllowed(UserPermissions::DEV_OPS);
});composer testPlease see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
The MIT License (MIT). Please see License File for more information.