PHPackages                             crphp/wmic - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. crphp/wmic

ActiveLibrary

crphp/wmic
==========

Está biblioteca disponibiliza um mecanismo para CONSULTAR máquinas Windows remotamente

v1.0.0(9y ago)023MITPHPPHP &gt;=5.5.12

Since Nov 29Pushed 9y agoCompare

[ Source](https://github.com/crphp/wmic)[ Packagist](https://packagist.org/packages/crphp/wmic)[ RSS](/packages/crphp-wmic/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (1)Dependencies (1)Versions (2)Used By (0)

crphp/wmic
==========

[](#crphpwmic)

Está biblioteca faz uso do **WQL (WMI Query Language)** para disparar exclusivamente **consultas**remotas a máquinas Windows.

> **crphp/wmi** e **crphp/wmic** possuem os mesmos recursos de consulta, porém, somente [crphp/wmi](https://github.com/crphp/wmi) tem a capacidade de gerenciar recursos remotos, como parar serviços, matar processos etc.

Está biblioteca segue os padrões descritos na [PSR-2](http://www.php-fig.org/psr/psr-2/), logo, isso implica que a mesma está em conformidade com a [PSR-1](http://www.php-fig.org/psr/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](http://tools.ietf.org/html/rfc2119). Tradução livre [RFC 2119 pt-br](http://rfc.pt.webiwg.org/rfc2119).

1. [Referências](#referencia)
2. [Funcionalidades](#funcionalidades)
3. [Requisitos (recomendados)](#requisitos)
4. [Compilando e testando o WMIC](#compilando)
5. [Preparando as máquinas cliente](#preparando-a-maquina-cliente)
6. [Baixando o pacote crphp/wmic para o servidor](#wmic)
7. [Exemplos de uso](#exemplos)
8. [Licença (MIT)](#licenca)

1 - Referências
----------------------------------------------------

[](#1---referências)

- [PSR-1](http://www.php-fig.org/psr/psr-1/)
- [PSR-2](http://www.php-fig.org/psr/psr-2/)
- [RFC 2119](http://tools.ietf.org/html/rfc2119). Tradução livre [RFC 2119 pt-br](http://rfc.pt.webiwg.org/rfc2119)

2 - Funcionalidades
------------------------------------------------------------

[](#2---funcionalidades)

- Consultar CPU
- Consultar RAM
- Consultar Disco Rígido
- Consultar Serviço
- Listar Serviços
- Consultar processo
- Listar processos
- Transformação de timestamp Windows para data/hora
- Listar sessões

3 - Preparando o servidor
------------------------------------------------------------------------

[](#3---preparando-o-servidor)

> ❗ 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)

[](#31---requisitos-recomendados)

Servidor

- REQUER Debian &gt;= 8.5.0 (32 ou 64 Bits)
- REQUER wmi-1.3.14 (código fonte)
- REQUER Apache &gt;= 2.4.10
- REQUER PHP &gt;= 5.5.12

Cliente

- REQUER Windows (desktop &gt;= Windows 7 ou Windows Server &gt;= 2003)
- NÃO REQUER a instalação de nenhum componente

4 - Compilando e testando o WMIC
--------------------------------------------------------------------

[](#4---compilando-e-testando-o-wmic)

Estou presupondo que você já tem uma distribuição GNU/Linux, preferencialmente Debian, com Apache e PHP devidamente configurados.

### 4.1 - autoconf

[](#41---autoconf)

Instalando autoconf, make e gcc:

```
# apt-get install autoconf
# apt-get install make
# apt-get install gcc

```

### 4.2 - wmi-1.3.14

[](#42---wmi-1314)

**Etapa 1** - download e extração dos fonts do WMIC:

```
$ wget http://www.openvas.org/download/wmi/wmi-1.3.14.tar.bz2
$ tar -xvf wmi-1.3.14.tar.bz2
```

**Etapa 2** - Configurar GNUmakefile

```
$ cd wmi-1.3.14/
$ sed -i "1s/^/ZENHOME=..\/..\n/" GNUmakefile
```

**Etapa 3** - Compilar WMIC

```
$ make "CPP=gcc -E -ffreestanding"
```

Ao fim da execução do comando make você saberá que terá corrido tudo bem caso as ultimas 3 linhas de output sejam algo parecido com:

```
cp: o alvo “../../lib/python” não é um diretório
GNUmakefile:43: recipe for target 'pywmi-installed' failed
make: *** [pywmi-installed] Error 1

```

**Etapa 4** - Renomear binário e testando:

```
$ mv bin wmic
$ ./wmic -U usuario%'senha' //ip "SELECT Caption FROM Win32_OperatingSystem"
```

Output do comando executado acima:

```
CLASS: Win32_OperatingSystem
Caption
Microsoft« Windows Server« 2008 Enterprise

```

**Obs**: Caso ocorra erro de conexão consulte o tópico 5 para liberar regra de firewall no cliente

**Etapa 5** - Adicionando binário a um diretório de "sistema":

```
$ mv wmic /usr/bin/
```

5 - Preparando a máquina cliente
--------------------------------------------------------------------------------------

[](#5---preparando-a-máquina-cliente)

Essas configurações DEVE ser executadas em todas as máquinas (cliente) alvos de gerenciamento remoto.

Caminho para as regras de firewall:

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

```

Para permitir as conexões externa teremos que habilitar as **Regras de Entrada**:

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

```

E as **Regras de Saída**:

```
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.

6 - Baixando o pacote crphp/wmic para o servidor
------------------------------------------------------------------------------

[](#6---baixando-o-pacote-crphpwmic-para-o-servidor)

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

```
composer require crphp/wmic

```

Ou se preferir criar um projeto:

```
composer create-project --prefer-dist crphp/wmic nome_projeto

```

Caso ainda não tenha o composer instalado, obtenha este em:

7 - Exemplos de uso
-----------------------------------------------------

[](#7---exemplos-de-uso)

**Consultar CPU**:

```
use Crphp\Wmic\Sistema\Cpu;
use Crphp\Wmic\Conector\Wmic;

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

if($wmi->status()) {
    $cpu = new Cpu($wmi);
    echo "";
    print_r($cpu->detalhes());
    echo "";
} else {
    echo $wmi->mensagemErro();
}
```

Todas as demais classes funcionam praticamente da mesma forma.

**Consultar Disco Rígido**

```
use Crphp\Wmic\Conector\Wmic;
use Crphp\Wmic\Sistema\DiscoRigido;

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

if($wmi->status())
{
    $obj = new DiscoRigido($wmi, "C"); // a unidade pode ser omitida
    echo "";
    print_r($obj->detalhes());
    echo "";
} else {
    echo $wmi->mensagemErro();
}
```

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

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

```
use Crphp\Wmic\Conector\Wmic;

$wmi = new Wmic;
$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)
--------------------------------------------------

[](#8---licença-mit)

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

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

3453d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/afc2603c34c8359e5d94024e23f6ec145b83b17eb4f1a952e47d9f5e3cd76975?d=identicon)[fabiojaniolima](/maintainers/fabiojaniolima)

---

Top Contributors

[![fabiojaniolima](https://avatars.githubusercontent.com/u/21073371?v=4)](https://github.com/fabiojaniolima "fabiojaniolima (2 commits)")

---

Tags

wmiwmicwmiacesso remoto

### Embed Badge

![Health badge](/badges/crphp-wmic/health.svg)

```
[![Health](https://phpackages.com/badges/crphp-wmic/health.svg)](https://phpackages.com/packages/crphp-wmic)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
