simple todo

Simple TODO

Simple TODO es una aplicación web muy minimalista. Se ha construido para demostrar el proceso de construcción de una aplicación web utilizando 'PHP' orientado a objetos. Sin embargo, esta aplicación es de naturaleza muy minimalista, contiene todas las propiedades básicas de una buena aplicación web. Se ha construido una forma totalmente orientada a objetos utilizando PHP puro (no se ha utilizado ningún marco que no sea PhPunit, que es solo un marco de prueba), HTML, CSS y JavaScript. En la actualidad, esta aplicación admite varias buenas características. Los voy a describir a continuación.

Vivir

He alojado la aplicación en Heroku y estoy usando una integración continua para enviar cambios de forma automática e instantánea (más sobre esto más adelante). Puede visitar la aplicación usando el siguiente enlace:

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

Características compatibles con Simple TODO

Características de backend

En el backend he construido las siguientes cosas:

1. Un motor de enrutamiento personalizado
2. Bastante soporte de URL
3. Soporte de middleware (tanto genérico como específico de ruta)
4. Controlador para manejar la solicitud
5. Rutas nombradas
6. Protección de CSRF a través del middleware
7. Un motor de plantilla pequeño pero extensible y eficiente
8. Una forma conveniente de OOP para acceder a las variables globales (nota: la forma en que lo implementé, es extensible, pero aún no está completa).

La aplicación se crea utilizando una forma totalmente orientada a objetos y tiene un soporte de tipo fuerte que puede detectar descansos durante la fase de desarrollo y, por lo tanto, aumentar la velocidad.

Características frontend

1. Una interfaz de usuario muy receptiva, rápida y consistente.
2. Mecanismo de almacenamiento en caché para almacenar datos en el lado del cliente.
3. Llamadas de red optimizada (es decir, DB).

Prueba de soporte y comentarios

Para las pruebas unitarias, estoy usando phpunit. Sin embargo, ya comencé a escribir pruebas y continuando, pero aún así tomaría algún tiempo cubrir toda la base de código.

Sobre los comentarios, como la aplicación cubre muchas funciones, he intentado escribir el código verbosamente, para que uno no necesite comentarios para comprender el código (para administrar mi tiempo de desarrollo). Pero aún comentando es el de facto de Doc. Intentaré tomar toda la base de código en comentarios con el tiempo.

Pruebas automatizadas e implementación continua

1. Soporte de pruebas automatizadas utilizando acciones de GitHub y PhPunit.
2. Soporte de implementación continua utilizando acciones de GitHub y un sistema de implementación basado en Git de Heroku.

[Nota: la aplicación ejecuta pruebas automatizadas en cada empuje, pero solo implementa en Heroku si la prueba es exitosa].

Base de datos

Para la base de datos he usado PostgreSQL. Y para manejar las operaciones de la base de datos, he usado PHP PDO para obtener operaciones de inserción, eliminación, actualización, etc.

Como nota al margen, para la gestión Composer de dependencia se ha utilizado.

Para uso local o desarrollo

Si desea ejecutar esta aplicación localmente para su propio uso o desarrollo, puede hacerlo fácilmente. Asegúrese de instalar PHP, compositor y PostgreSQL instalado en su PC y una conexión a Internet.

Al principio, ejecute el compositor para instalar las dependencias:

$ php composer.phar install

Ahora, cree un .env en el directorio raíz del proyecto y coloque su información de DB allí de la siguiente manera:

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

También es posible que desee poner otra información en su archivo .env (haga lo que sea necesario)

Y luego corre:

$ php database/migrate.php

Después de crear la tabla DB, puede ejecutar las pruebas:

$ ./vendor/bin/phpunit

Si las pruebas son exitosas, puede ejecutar la aplicación utilizando el servidor web de desarrollo de PHP de la siguiente manera:

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

Ahora visite 127.0.0.1:8000 en su navegador para usar la aplicación web.

Expresiones de gratitud

He usado PhPUnit para pruebas unitarias y un script ligeramente editado (según mis necesidades) de DevCoder-XYZ/PHP-Dotenv para analizar el archivo .env .

LICENCIA

Este repositorio se publica bajo MIT License . Para saber más sobre la licencia, visite este enlace.

Que contribuye

Estoy pensando en explicar toda la arquitectura de este proyecto a todos los interesados ​​en el desarrollo de la aplicación web. Estoy pensando en planificar un libro (o tipo de recurso tutorial) sobre cómo crear una aplicación web desde cero. Si tiene algo que contribuir o asesorar, soy todos los oídos. Solo dame un golpe.