README

LaravelWebConsole

Laravel Web Console is a package for Laravel applications that allow user to connect to the server via browser.

What is this package useful for?

Despite the fact that cloud hosting is now growing up and many people use VPS / Dedicated Server hosting, most people still use Sharing hosting without SSH connection. Using this package you can execute shell commands from your browser. Using Laravel Middleware features you can protect your system from danger from outside.

Features

• Enable / Disable custom login
• Multi-account support
• Home dir selection
• Home dir selection for multiple accounts
• Custom password hashing

Supported Laravel Versions

• 5.7.*
• 5.8.*
• 6.*
• 7.*
• 8.*

Installation

Manually:

• Download the last release: https://github.com/alkhachatryan/laravel-web-console/releases/latest
• Upload the compressed file to the server.
• Unzip the files into /vendor/alkhachatryan/laravel-web-console (Without version number)
• Add maintance for this package into composer autoloaders -- In /vendor/composer/autoload_namespaces.php add in the array this line:

   'Alkhachatryan\\LaravelWebConsole\\' => array($vendorDir . '/alkhachatryan/laravel-web-console/src'),

  -- In /vendor/composer/autoload_psr4.php add in the array this line:

   'Alkhachatryan\\LaravelWebConsole\\' => array($vendorDir . '/alkhachatryan/laravel-web-console/src'),

• Update the /config/app.php and add the service provider into providers array

  Alkhachatryan\LaravelWebConsole\LaravelWebConsoleServiceProvider::class,

• Remove the cache: delete the following files: /bootstrap/cache/packages.php /bootstrap/cache/services.php

Or Via Composer:

$ composer require alkhachatryan/laravel-web-console

Configuration

Publish the config file

• Copy /vendor/alkhachatryan/laravel-web-console/config file to your /config folder

  OR via command line:

  php artisan vendor:publish --tag=webconsole

• Edit the /config/laravelwebconsole.php file, create your credentials in .env file.

      // Single-user credentials (REQUIRED)
      'user' => [
          'name' => env('CONSOLE_USER_NAME', 'root'),
          'password' => env('CONSOLE_USER_PASSWORD', 'root')
      ],

!!! ATTENTION !!!! These user credentials ARE NOT your server user credentials. You can type here everything you want. This method of custom login is a small addition in the protection. Anyway you can disable it. Set no_login value TRUE

     // Disable login (don't ask for credentials, be careful)
    'no_login' => true,

Usage

use Alkhachatryan\LaravelWebConsole\LaravelWebConsole;

class HomeController extends Controller
{
    public function index() {
       return LaravelWebConsole::show();
    }
}

Change log

Please see the changelog for more information on what has changed recently.

Security

If you discover any security related issues, please email info@khachatryan.org instead of using the issue tracker.

Credits

• Alexey Khachatryan

Open source tools included

• jQuery JavaScript Library: https://github.com/jquery/jquery
• jQuery Terminal Emulator: https://github.com/jcubic/jquery.terminal
• jQuery Mouse Wheel Plugin: https://github.com/brandonaaron/jquery-mousewheel
• PHP JSON-RPC 2.0 Server/Client Implementation: https://github.com/sergeyfast/eazy-jsonrpc
• Normalize.css: https://github.com/necolas/normalize.css
• Nickola/Web-console https://github.com/nickola/web-console

License

MIT. Please see the license file for more information.