README

Está é uma biblioteca que faz uso do protocolo SSH (Secure Shell) para gerenciamento de máquinas remotas.

Está biblioteca segue os padrões descritos na PSR-2, logo, isso implica que a mesma está em conformidade com a PSR-1.

As palavras-chave "DEVE", "NÃO DEVE", "REQUER", "DEVERIA", "NÃO DEVERIA", "PODERIA", "NÃO PODERIA", "RECOMENDÁVEL", "PODE", e "OPCIONAL" neste documento devem ser interpretadas como descritas no RFC 2119. Tradução livre RFC 2119 pt-br.

1. Referências
2. Funcionalidades
3. Requisitos (recomendados)
4. Baixando o pacote crphp/ssh para o servidor
5. Exemplos de uso
6. Licença (MIT)

1 - Referências

• PSR-1
• PSR-2
• RFC 2119. Tradução livre RFC 2119 pt-br

2 - Funcionalidades

• Consultar RAM
• Consultar CPU (em análise)
• Consultar Disco Rígido (em análise)
• Listar Serviços (em análise)
• Stop / Start de serviço (em análise)
• Listar processos (em análise)
• Matar / Finalizar processos (em análise)
• Lançar processos (em análise)
• Listar e matar sessões (em análise)

3 - Requisitos

❗ Os requisitos sugeridos logo abaixo representam as versões utilizadas em nosso ambiente de desenvolvimento e produção, logo não garantimos que a solução aqui apresentada irá rodar integralmente caso as versões dos elementos abaixo sejam outras.

3.1 - Requisitos (recomendados)

Servidor

• REQUER Apache >= 2.4.10
• REQUER PHP >= 5.5.12

Cliente

• REQUER servidor SSH
• É RECOMENDÁVEL ativar as bibliotecas mcrypt, gmp ou bcmath

4 - Baixando o pacote crphp/wmi para o servidor

Para a etapa abaixo estou pressupondo que você tenha o composer instalado e saiba utilizá-lo:

composer require crphp/wmi

Ou se preferir criar um projeto:

composer create-project --prefer-dist crphp/wmi nome_projeto

Caso ainda não tenha o composer instalado, obtenha este em: https://getcomposer.org/download/

5 - Exemplos de uso

Consultar Memória Ram:

use Crphp\Ssh\Conector\Ssh;
use Crphp\Ssh\Sistema\MemoriaRam;

$ssh = new Ssh;
$ssh->conectar('endereco_do_servidor', 'usuario', 'senha');

if($ssh->status()) {
    $ram = new MemoriaRam($ssh);
    echo "<pre>";
    print_r($ram->detalhes());
    echo "</pre>";
    
} else {
    echo $ssh->mensagemErro();
}

Você DEVE sempre instânciar o conector Ssh e a classe referente ao elemento que deseja manipular.

Também é possível executar suas próprias consultas customizadas

use Crphp\Ssh\Conector\Ssh;

$ssh = new Ssh;
$ssh->conectar('endereco_do_servidor', 'usuario', 'senha');
echo $ssh->executar('pwd');

6 - Licença (MIT)

Para maiores informações, leia o arquivo de licença disponibilizado junto desta biblioteca.