crphp/core

Esqueleto básico para montar classes especializadas em gerenciamento de máquinas remotas

crphp/core

No contexto deste documento, o termo "classe" refere-se a todas as classes, interfaces e traits., _(*1)

Está biblioteca representa um esqueleto inicial para se trabalhar com gerenciamento de hosts remotos. Já a biblioteca crphp/wmi é um bom exemplo de implementação que usa está coleção de classes., _(*2)

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., _(*3)

1. Referências
2. Funcionalidades
3. Requisitos (recomendados)
4. Baixando o pacote crphp/core 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

No contexto desta biblioteca as funcionalides abaixo são classe que precisam ser implementadas. Conforme já foi dito, a biblioteca crphp/wmi é um bom exemplo de implementação que usa está coleção de classes genéricas:, _(*4)

• [x] Consultar CPU
• [x] Consultar RAM
• [x] Consultar Disco Rígido
• [x] Listar Serviços
• [x] Stop / Start de serviço
• [x] Listar processos
• [x] Alterar prioridade do processo
• [x] Matar / Finalizar processos
• [x] Transformação de unidades
• [x] Transformação de timestamp Windows para data/hora

3 - Preparando o servidor

:exclamation: 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., _(*5)

3.1 - Requisitos (recomendados)

Servidor - REQUER Apache >= 2.4.10 - REQUER PHP >= 5.5.12, _(*6)

Cliente - NÃO REQUER instalar nenhum componente, _(*7)

4 - Baixando o pacote crphp/core para o servidor

Para a etapa abaixo estou pressupondo que você tenha o composer instalado e saiba utilizá-lo:, _(*8)

composer require crphp/core

Ou se preferir criar um projeto:, _(*9)

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

Caso ainda não tenha o composer instalado, obtenha este em: https://getcomposer.org/download/, _(*10)

5 - Exemplos de uso

Temos dois bons exemplos de bibliotecas que implementam este core, são respectivamente crphp/wmi e crphp/ssh., _(*11)

Veja um exemplo de implementação utilizado pela biblioteca crphp/wmi:, _(*12)

use COM;
use \Exception;
use \RuntimeException;
use Crphp\Core\Sistema\Conector;

class Wmi extends Conector
{
    public function conectar($host, $usuario = null, $senha = null, $porta = 135, $timeout = 10)
    {
        // Aqui você abre uma comunicação com o host remoto
    }

    public function executar($instrucao)
    {
        // Aqui você executa uma instrução remotamente
    }

    /*
     * Os métodos status() e mensagemErro() possuem um comportamento genérico, provavelmente 
     * você não irá precisar reescrevê-los
     */
}

Veja um exemplo de implementação utilizado pela biblioteca crphp/ssh:, _(*13)

use \Exception;
use \RuntimeException;
use phpseclib\Net\SSH2;
use Crphp\Core\Sistema\Conector;

class Ssh extends Conector
{
    public function conectar($host, $usuario = null, $senha = null, $porta = 135, $timeout = 10)
    {
        // Aqui você abre uma comunicação com o host remoto
    }

    public function executar($instrucao)
    {
        // Aqui você executa uma instrução remotamente
    }

    /*
     * Os métodos status() e mensagemErro() possuem um comportamento genérico, provavelmente 
     * você não irá precisar reescrevê-los
     */
}

6 - Licença (MIT)

Para maiores informações, leia o arquivo de licença disponibilizado junto desta biblioteca., _(*14)