leandrocosta/lhweb

A lightweight web framework.

Sobre

Um Framework Web, simples, bem enchuto, desenvolvido para meus próprios projetos, que venho disponibilizar para quem achar interessente utilizá-lo. Tenho aqui reunir o máximo de boas práticas de programação que conheço e que acho conveniente. Qualquer sugestão só entrar em contato. Muitos podem argumentar que é reinventar a roda, mas minha grande motivação para criação meu próprio framework é a de ter uma ferramenta personalizada para minhas necessidades, e bem enchuta., _(*1)

Requerimentos

Todo o desenvolvimento do framework está sendo feito com php 5.5.26 em uma instalação do Fedora 20. E utilizando a camada de PDO para o banco de dados. Todo o resto é php puro., _(*2)

Instalação

A instalação pode ser feita atravéz do git ou baixando o arquivo zip no GitHUB:, _(*3)

git clone https://github.com/lokidarkeden/lhweb, _(*4)

ou, _(*5)

wget https://github.com/lokidarkeden/lhweb/archive/master.zip && unzip master.zip, _(*6)

ou ainda através do composer, adicionando o requerimento no seu projeto., _(*7)

Utilização

Temos um exemplo de uso na pasta web/index.php do próprio projeto. Para ter acesso as classes basta incluir o autoloader, que fica em inc/autoloader.php., _(*8)

Temos 3 pacotes principais:, _(*9)

lhweb\actions composto hoje de uma única classe, a WebAction. Cujo objetivo será tratar a request vinda dos usuários, validar e formatar os dados, e deverá ser extendida por suas classes que cuidarão desta tarefa., _(*10)

lhweb\controller é onde fica a classe para para suas classes de négocio, vocẽ deverá criar seus controladores extendendo a class AbstractController, e neles desenvolver a lógica de negócio da sua aplicação., _(*11)

lhweb\database é onde temos as classes de conexão com o banco de dados. a LHDB extende a classe PDO adicionando algumas funcionalidades, como por exemplo, manter uma lista de conexões criadas para serem utilizadas pelas entidades. Temos a classe GenericQuery que é basicamente uma fabrica de sql, com ele podemos contruir consultas sql de forma orientada a objetos, veja exemplos abaixo., _(*12)

O primeiro passo é a criação de uma classe entidade, que irá representar uma tabela do seu banco de dados, ela deve extender use lhweb\database\LHWebEntity;, vamos a um exemplo rápido:, _(*13)

use lhweb\database\LHWebEntity;

class MeuUsuario extends LHWebEntity {
    public $id;
    public $nome;
    public $login;
    public $senha;
}

Pronto, essa classe será mapeada pelo controlador automaticamente da seguinte forma: - Tabela nome meuusuario - campos: id, nome, login, senha. - chave primária: id, por padrão a chave primaria é chamada id, e o tipo int., _(*14)

Para criar um controlador padrão, capaz de operações CRUD, basta fazer o seguinte:, _(*15)

use lhweb\controller\LHWebController;

$ctl = new LHWebController(MeuUsuario::class);

$primeiro = $ctl->primeiro(); // Obtem o primeiro registro ordenado pela Chave Primária.
$ultimo = $ctl->ultimo(); // Obtem o último registro ordenado pela Chave Primária.
$porpkk = $ctl->getByPK(5); // Obtem o registro pela chave primária passada como parâmetro.
$proximo = $ctl->proximo($porpkk->id); // Obtem o registro posterior da id passada.
$proximo = $ctl->anterior($porpkk->id); // Obtem o registro anterior da id passada.

// Efetuando um update em um registro
$usuario = $ctl->getByPK(5); // Obtem o Usuário
$usuario->nome = "Alterando o Nome";
$ctl->salvar($usuario);


// Removento um Registro
$ctl->apagar(5);

// Cadastrando um novo registro.
$u = new MeuUsuario();
$u->nome = "Usuario Novo";
$u->login = "Login do Usuario";
$u->senha = "123";
$u = $ctl->salvar($u); // Recebe o usuário salvo com a id gerada pelo banco de dados.

Em breve estarei postando exemplos mais avançados de relacionamentos entre tabelas., _(*16)