amazing79/simplex

Implementacion del framework mediante el tutorial de symfony mas un bonus

v2.0.1 2025-09-29 16:50 UTC

Requires

• php: >=8.1
• php-di/php-di: ^7.1
• symfony/event-dispatcher: ^7.3
• symfony/http-foundation: ^7.3
• symfony/http-kernel: ^7.3
• symfony/routing: ^7.3
• vlucas/phpdotenv: ^5.6

Requires (Dev)

• phpunit/phpunit: ^11.0

MIT

• amazing79

README

Proyecto base en PHP con estructura mínima de carpetas (app, src, config, public, test ), pensado para iniciarlo rápido con Composer.

🚀 Instalación

Podés crear un nuevo proyecto a partir de este template con:

composer create-project amazing79/simplex [nombre_proyecto]

Idea

La idea fue replicar el tutorial Create your own Framework de Symfony. Con esta base, se propuso ajustar el framework para actualizar pequeñas aplicaciones que teniamos en php plano y mejorarlas sin la necesidad de requerir a frameworks gigantescos como laravel o láminas.

Segun el tutorial, tenemos dos puntos importantes:

• Un framework funcional con poco codigo
• Un Framework funcional pero que termina siendo un wrapper de la clase HttpKernel de Symfony

Se optó por continuar el desarrollo desde el primer punto pero agregando algunas funcionalidades más:

• Agregar libreria para soporte de archivos .env
• Agregar soporte de Inyectores de dependencias PHP-DI
• Cambiar el punto de acceso de la App de /web/front.php a /public/index.php.
• Como chiche, se incluyo un archivo ".htaccess_example" para reescribir las rutas de la app y cambiar el index.php/url por /url. Esto es opcional.
• El framework consta con test propios para validar que funcione ante eventuales cambios.
• Además, agregamos algunos scripts dentro de la configuracion de composer.

Dentro de los scripts podemos:

Probar la app de bienvenida

composer start

Correr los tests del framework

composer tests

Modo de trabajo

Se incluyo un ejemplo de una página index con su controlador, a modo de entender un poco el funcionamiento. En corto:

• Configurar las dependencias según necesitemos (modelos, nuevos eventos, etc.).
• Reemplazar template de IndexController (welcome) y usar uno propio (también podemos editarlo, como prefieras).
• La metodologia es el patron MVC. Seguir este enfoque, y guardar los scripts en sus respectivas carpetas según su proposito.
• No soporta manejo de sesiones de forma nativa. Esto requiere que lo implementemos nosotros.
• Los tests actualmente están funcionando, pero solo verifican el funcionamiento del framework desde el punto base. Modificaciones al framework por parte de uno podria incluir modificar los tests.
• No incluye layouts, ya que las páginas que debemos actualizar tienen estructura muy simple (pero se puede incorporar a futuro).
• Se modificó parte del codigo del tutorial para trabajar con Inyectores de dependencias y asi ser más flexible la configuracion del framework.

Para marcar el punto desde donde empezamos a usarlo como framework, largamos la release de la version v2.0.0. Con esta version procedimos a actualizar un par de apps.