crphp/wmi

Biblioteca wmi para gerenciamento remoto de máquinas Windows

crphp/wmi

Está é uma biblioteca que faz uso do WQL (WMI Query Language) para manipulação do instrumento WMI em máquinas Windows. Em outras palavras, essa biblioteca permite o gerenciamento remoto de máquinas Windows, dispensando a instalação de agentes e plugins nas máquinas clientes., _(*1)

Caso sua intenção seja somente consultar os recursos de uma máquina remota, recomendo fortemente que analise a possibilidade de utilizar crphp/wmic em razão da performance., _(*2)

crphp/wmi e crphp/wmic possuem os mesmos recursos de consulta, porém, somente crphp/wmi tem a capacidade de gerenciar recursos remotos, como parar serviços, matar processos etc., _(*3)

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

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

1. Referências
2. Funcionalidades
3. Requisitos (recomendados)
4. Configurando o servidor
5. Preparando a máquina cliente
6. Baixando o pacote crphp/wmi para o servidor
7. Exemplos de uso
8. Licença (MIT)

1 - Referências

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

2 - Funcionalidades

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

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

3.1 - Requisitos (recomendados)

Servidor - REQUER Windows (desktop >= Windows 7 ou Windows Server >= 2003) - REQUER Apache >= 2.4.10 - REQUER PHP >= 5.5.12, _(*7)

Cliente - REQUER Windows (desktop >= Windows 7 ou Windows Server >= 2003) - NÃO REQUER a instalação de nenhum componente, _(*8)

4 - Configurando o servidor

No arquivo php.ini DEVE ser adicionada alinha:, _(*9)

extension=php_com_dotnet.dll

Você DEVE verificar se o arquivo php_com_dotnet.dll está presente no diretório php/ext, _(*10)

5 - Preparando a máquina cliente

As configurações deste tópico DEVEM ser executadas em todas as máquinas alvos de gerenciamento remoto, ou seja, em todas as máquinas cliente., _(*11)

5.1 - Liberando regra de firewall nos clientes

Caminho para as regras de firewall:, _(*12)

Painel de Controle > Ferramentas Administrativas > Firewall do Windows com Segurança Avançada

Para permitir as conexões WMI teremos que habilitar as Regras de Entrada:, _(*13)

Instrumentação de Gerenciamento do Windows (DCOM-In)
Instrumentação de Gerenciamento do Windows (WMI-In)

E as Regras de Saída:, _(*14)

Instrumentação de Gerenciamento do Windows (WMI-Saída)

Para não ter problema, é RECOMENDÁVEL que o usuário de conexão remota tenha privilégio de administrador na máquina de destino. Obviamente você PODE configurar o contexto de acesso caso tenha alguma familiridade com este assunto., _(*15)

6 - Baixando o pacote crphp/wmi para o servidor

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

composer require crphp/wmi

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

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

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

7 - Exemplos de uso

Consultar CPU:, _(*19)

use Crphp\Wmi\Sistema\Cpu;
use Crphp\Wmi\Conector\Wmi;

$wmi = new Wmi;
$wmi->conectar('ip_ou_hostname', 'usuario', 'senha');

if($wmi->status()) {

    $cpu = new Cpu($wmi);
    echo "<pre>";
    print_r($cpu->detalhes());
    echo "</pre>";

} else {
    echo $wmi->mensagemErro();
}

Todas as demais classes funcionam praticamente da mesma forma., _(*20)

Consultar Disco Rígido, _(*21)

use Crphp\Wmi\Conector\Wmi;
use Crphp\Wmi\Sistema\DiscoRigido;

$wmi = new Wmi;
$wmi->conectar('ip_ou_hostname', 'usuario', 'senha');

if($wmi->status())
{
    // Letra de unidade opcional
    $obj = new DiscoRigido($wmi, "C");
    echo "

";
    print_r($obj->detalhes());
    echo "

";

} else {
    echo $wmi->mensagemErro();
}

Listar ou encerrar processo, _(*22)

use Crphp\Wmi\Conector\Wmi;
use Crphp\Wmi\Sistema\Processos;

$wmi = new Wmi;
$wmi->conectar('ip_ou_hostname', 'usuario', 'senha');

if($wmi->status()) {
    $obj = new Processos($wmi);

    echo "<pre>";
    print_r($obj->detalhes());
    //print_r($obj->killProcesso());
    echo "</pre>";

} else {
    echo $wmi->mensagemErro();
}

Você DEVE sempre instânciar o conector Wmi e a classe referente ao elemento que deseja manipular, _(*23)

Também é possível executar suas próprias consultas customizadas, _(*24)

use Crphp\Wmi\Conector\Wmi;

$wmi = new Wmi;
$wmi->conectar('ip_ou_hostname', 'usuario', 'senha');

if($wmi->status()) {
    $memoria = $wmi->executar("select AvailableBytes from Win32_PerfRawData_PerfOS_Memory");
    // Será retornado um objeto em caso de sucesso ou uma string em caso de erro
} else {
    echo $wmi->mensagemErro();
}

8 - Licença (MIT)

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