Bienvenido a GluePHP, un framework para el desarrollo de aplicaciones web de una sola página empleando el paradigma de la programación dirigida por eventos.
- PHP 7.1
- MIT
Tenga en cuenta que el proyecto se encuentra en una fase inestable.
La instalación de GluePHP se realiza mediante composer. Para esto es necesario declarar las siguientes dependencias en el archivo composer.json.
{
"require": {
"glueapps/composed-views": "dev-0.1a",
"glueapps/glue-php": "dev-0.1a"
}
}
Seguidamente se debe ejecutar el comando:
$ composer update
El desarrollo de GluePHP está basado en la metodología de desarrollo guiado por pruebas(TDD), por lo que cada funcionalidad del framework se encuentra cubierta por al menos una prueba. Para las pruebas al código PHP se emplea PHPUnit mientras que para el código JavaScript se emplea MochaJS, Chai y SinonJS. Para las pruebas a las funcionalidades full-stack se emplean las tecnologías PHPUnit, Selenium Server con Chrome Driver.
El código JavaScript está basado mayormente en ES5 con el objetivo de lograr compatibilidad con la mayoría de navegadores posibles, no obstante, también se han empleado algunas funcionalidades de ES6 pero que se encuentran ampliamente soportadas.
Para el código JavaScript existen algunas tareas automatizadas con GulpJS por lo que antes de hacer alguna modificación debe ejecutar el comando:
$ gulp
- Hacer un fork de este repositorio.
- Clonar en local el nuevo repositorio que se ha creado en su cuenta de GitHub.
- Realizar las modificaciones con sus respectivas pruebas.
- Hacer push al origen.
- Crear un pull request.
Una vez que ha clonado localmente el repositorio debe realizar la instalación de las siguientes aplicaciones:
$ composer update
$ npm update
$ bower install
$ php -S localhost:8085
$ java -jar <ruta_al_archivo>/selenium-server-standalone-x.x.x.jar
$ php vendor/phpunit/phpunit/phpunit
Tenga en cuenta que algunos antivirus pueden hacen fallar ciertas pruebas por lo que puede ser necesario que añada alguna excepción al respecto.