tiran133/phpwebterm

Simple PHP Web Terminal for Server and Docker

0.1.1 2024-11-29 09:03 UTC

Requires

• php: ^8.0
• ext-pcntl: *
• ext-posix: *
• guzzlehttp/guzzle: ^7.9
• illuminate/collections: 10.0|^11.0
• illuminate/support: ^11.34
• ratchet/rfc6455: ^0.3.1
• react/child-process: ^0.6.5
• react/event-loop: ^1.5
• react/socket: ^1.16

MIT

• Alexander Wolff

README

A simple php web terminal application with laravel support.

Install

composer require tiran133/phpwebterm

Basic Usage

PHP

require __DIR__.'/../vendor/autoload.php';

$config = [
    'port' => 8034,
    'listen' => '0.0.0.0',
    'scheme' => 'http',
    // SSL/TLS context
    'certificate' => [
        'local_cert' => 'server.crt',
        'local_pk' => 'server.key',
        'passphrase' => '',
    ],
];

//Create new websocket server
$websocketServe = new Server(new ServerConfig($config));

// Add route: Uses a simple approach to spawn the process.
$websocketServe->addRoute('/server-shell', ServerShellProcess::class);

//Startwebsocket server

$websocketServe->start();

JS

import {TerminalManager} from '/../dist/TerminalManager.es.js';

// If the config is not supplied, it will read the config from ENV variable during vite build process
const config = {
    WEBSOCKET_SCHEME: 'http',
    WEBSOCKET_HOST: '127.0.0.1',
    WEBSOCKET_PORT: '8034',
}

// Instantiate and expose the manager
const terminalManager = new TerminalManager(config);

window.connectServerShell = terminalManager.newEndpoint('server-shell');

// Opens a shell to a server
window.connectServerShell({
    host: '<IP>',
    port: 22,
    username: 'dashboard',
    jump_proxy: '<USER>@<IP>:<PORT>',
    ssh_key_path: '<PATH TO FILE>'
});

See example directory for more details.