simple todo

Simples TODO

Simples TODO é um WebApp muito minimalista. Ele foi construído para demonstrar o processo de construção de um webApp usando o `PHP orientado a objetos. No entanto, esse aplicativo é de natureza muito minimalista, ele contém todas as propriedades básicas de um bom aplicativo da Web. Ele foi construído de maneira totalmente orientada a objetos usando PHP puro (nenhuma estrutura foi usada além da phpunit, que é apenas uma estrutura de teste), HTML, CSS e JavaScript. Atualmente, este aplicativo suporta vários bons recursos. Vou descrevê -los abaixo.

Ao vivo

Eu hospedei o aplicativo no Heroku e estou usando integração contínua para enviar alterações automaticamente e instantaneamente (mais sobre isso mais tarde). Você pode visitar o aplicativo usando o seguinte link:

http://simple-todo rs.herokuapp.com/

Recursos suportados pelo simples TODO

Recursos de back -end

No back -end, construí as seguintes coisas:

1. Um mecanismo de roteamento personalizado
2. Suporte bonito da URL
3. Suporte de middleware (genérico e específico de rota)
4. Controlador para lidar com o pedido
5. Rotas nomeadas
6. Proteção de CSRF através do middleware
7. Um pequeno mas extensível e eficiente do motor
8. Uma maneira conveniente de OOP de acessar variáveis ​​globais (Nota: da maneira como a implementei, é extensa, mas ainda não completa).

O aplicativo é construído usando uma maneira totalmente orientada a objetos e tem um forte suporte de tipo que pode detectar quebras durante a fase de desenvolvimento e, assim, aumentar a velocidade.

Recursos de front -end

1. Uma interface do usuário muito recente, rápida e consistente.
2. Mecanismo de armazenamento em cache para cache os dados do lado do cliente.
3. Chamadas de rede otimizadas (ou seja, DB).

Testando suporte e comentários

Para testes de unidade, estou usando phpunit. No entanto, eu já comecei a escrever testes e continuar, mas ainda assim levaria algum tempo para cobrir toda a base de código.

Sobre os comentários, como o aplicativo cobre muitos recursos, tentei escrever o código verbosamente, para que não seja necessário comentários para entender o código (para gerenciar meu tempo de desenvolvimento). Mas ainda comentando é o de fato para Doc. Vou tentar levar a base de código inteira sob comentários com o tempo.

Testes automatizados e implantação contínua

1. Suporte de teste automatizado usando ações do GitHub e phpunit.
2. Suporte de implantação contínua usando ações do GitHub e sistema de implantação baseado em Heroku Git.

[Nota: o aplicativo executa testes automatizados em cada push, mas apenas implanta para o Heroku se o teste for bem -sucedido].

Banco de dados

Para o banco de dados, usei o PostgreSQL. E para lidar com operações de banco de dados, usei o PHP PDO com Perfom Insert, exclua, atualiza etc. operações.

Como nota lateral, para gerenciar Composer de dependência, foi usado.

Para uso ou desenvolvimento local

Se você deseja executar este aplicativo localmente para seu próprio uso ou desenvolvimento, pode fazê -lo facilmente. Verifique se você instalou o PHP, o compositor e o PostgreSQL instalado no seu PC e uma conexão com a Internet.

No primeiro compositor de execução para instalar as dependências:

$ php composer.phar install

Agora, crie um .env no diretório raiz do projeto e coloque suas informações de banco de dados da seguinte forma:

DATABASE_URL=postgres:// < username > : < password > @ < hostname > : < port > / < dbname >

Você também pode querer colocar outras informações em seu arquivo .env (faça conforme sua necessidade)

E então corra:

$ php database/migrate.php

Depois de criar a tabela de banco de dados, você pode executar os testes:

$ ./vendor/bin/phpunit

Se os testes forem bem -sucedidos, você poderá executar o aplicativo usando o servidor da web de desenvolvimento do PHP da seguinte forma:

$ php -c < path-to-php.ini > -t public/ -S 127.0.0.1:8000

Agora visite 127.0.0.1:8000 no seu navegador para usar o WebApp.

Agradecimentos

Eu usei Phpunit para testes de unidade e um script ligeiramente editado (de acordo com minha necessidade) do devCoder-xyz/php-dotenv para analisar o arquivo .env .

LICENÇA

Este repositório é publicado sob MIT License . Para saber mais sobre licença, visite este link.

Contribuindo

Estou pensando em explicar toda a arquitetura deste projeto a todos que estão interessados ​​no desenvolvimento da WebApp. Estou pensando em planejar um livro (ou tipo de recurso tutorial) sobre como criar um aplicativo da Web a partir do zero. Se você tem algo para contribuir ou aconselhar, sou todos ouvidos. Apenas me dê uma batida.