v1.0.0

Author: fabiojaniolima

.gitignore

@@ -0,0 +1,4 @@
+/vendor
+/nbproject
+.DS_Store
+/testes

composer.json

@@ -0,0 +1,28 @@
+{
+    "name": "crphp/ssh",
+    "type": "library",
+    "description": "Biblioteca SSH para gerenciamento de máquina remota",
+    "keywords": ["ssh", "acesso remoto", "linux"],
+    "license": "MIT",
+    "support": {
+        "issues": "https://github.com/crphp/ssh/issues",
+        "source": "https://github.com/crphp/ssh"
+    },
+    "authors": [
+        {
+            "name": "Fábio Jânio",
+            "email": "contato@fabiojanio.com"
+        }
+    ],
+    "require": {
+        "php": ">=5.5.12",
+        "crphp/core": "^1.0",
+        "phpseclib/phpseclib": "^2.0"
+    },
+    "autoload": {
+        "psr-4": {
+            "Crphp\\Ssh\\": "src/"
+            }
+    },
+    "minimum-stability": "dev"
+}

license

@@ -0,0 +1,20 @@
+The MIT License (MIT) 
+Copyright (c) fabiojanio.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

readme.md

@@ -0,0 +1,95 @@
+# crphp/ssh
+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](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)
+1. [Funcionalidades](#funcionalidades)
+1. [Requisitos (recomendados)](#requisitos)
+1. [Baixando o pacote crphp/ssh para o servidor](#ssh)
+1. [Exemplos de uso](#exemplos)
+1. [Licença (MIT)](#licenca)
+
+## 1 - <a id="referencias"></a>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 - <a id="funcionalidades"></a>Funcionalidades
+- [x] 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 - <a id="preparando-o-servidor"></a>Requisitos
+> :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.
+
+### 3.1 - <a id="requisitos"></a>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 - <a id="ssh"></a>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 - <a id="exemplos"></a>Exemplos de uso
+
+**Consultar Memória Ram**:
+```php
+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**
+```php
+use Crphp\Ssh\Conector\Ssh;
+
+$ssh = new Ssh;
+$ssh->conectar('endereco_do_servidor', 'usuario', 'senha');
+echo $ssh->executar('pwd');
+```
+
+## 6 - <a id="licenca">Licença (MIT)
+Para maiores informações, leia o arquivo de licença disponibilizado junto desta biblioteca.

src/Auxiliares/Transformar.php

@@ -0,0 +1,21 @@
+<?php
+
+/**
+ * Classe utilizada para formatar valores, tais como unidades de medida, data,
+ * hora, etc
+ * 
+ * @package     crphp
+ * @subpackage  wmi
+ * @author      Fábio J L Ferreira <contato@fabiojanio.com>
+ * @license     MIT (consulte o arquivo license disponibilizado com este pacote)
+ * @copyright   (c) 2016, Fábio J L Ferreira
+ */
+
+namespace Crphp\Ssh\Auxiliares;
+
+use Crphp\Core\Auxiliares\Capacidade;
+
+class Transformar extends Capacidade
+{
+    // Pendente de implementação
+}

src/Conector/Ssh.php

@@ -0,0 +1,71 @@
+<?php
+
+/**
+ * Essa classe fornece uma interface de conexão SSH com máquinas Linux, Unix e 
+ * qualquer outro sistema que suporte conexões SSH. Possibilitando dessa forma a 
+ * execução de comandos remotos de forma rápida, eficiente e segura
+ * 
+ * @package     crphp
+ * @subpackage  ssh
+ * @author      Fábio J L Ferreira <contato@fabiojanio.com>
+ * @license     MIT (consulte o arquivo "license" disponibilizado com este pacote)
+ * @copyright   (c) 2016, Fábio J L Ferreira
+ */
+
+namespace Crphp\Ssh\Conector;
+
+use \Exception;
+use \RuntimeException;
+use phpseclib\Net\SSH2;
+use Crphp\Core\Sistema\Conector;
+
+class Ssh extends Conector
+{
+    /**
+     * Estabelece conexão via SSH
+     * 
+     * @param   string  $host
+     * @param   string  $usuario
+     * @param   string  $senha
+     * @param   int     $porta
+     * @param   int     $timeout
+     * @return  null
+     */
+    public function conectar($host, $usuario = null, $senha = null, $porta = 22, $timeout = 10)
+    {
+        try {
+            $this->conexao = new SSH2($host, $porta, $timeout);
+            if (!$this->conexao->login($usuario, $senha)) {
+                throw new Exception("O login falhou!");
+            }
+            
+        } catch (Exception $e) {
+            $this->conexao = false;
+            $this->mensagemErro = $e->getMessage();
+        }
+    }
+
+    /**
+     * Executa a instrução remotamente
+     * 
+     * @param   string         $instrucao
+     * @return  object|string  em caso de erro retorna uma string
+     */
+    public function executar($instrucao)
+    {
+        try {
+            if (!$this->conexao) {
+                throw new RuntimeException("Antes de executar uma instrução é necessário instanciar uma conexão!");
+            }
+
+            // @see http://php.net/manual/en/ref.com.php
+            if (!$retorno = $this->conexao->exec($instrucao)) {
+                throw new RuntimeException("O host remoto não retornou dados!");
+            }
+
+            return $retorno;
+        } catch (RuntimeException $e) {
+            return $e->getMessage();
+        }
+    }
+}