parchex / doctrine-extension
Componentes de Doctrine para aplicaciones basadas en DDD/Hexagonal Architecture
Requires
- php: ^7.3
- acelaya/doctrine-enum-type: ^2.2
- doctrine/common: ^2.7
- doctrine/data-fixtures: ^1.4
- doctrine/migrations: ^2.2
- doctrine/orm: ^2.7
- jdorn/sql-formatter: ^1.2
- parchex/basics: ^0.1
- parchex/common: ^0.1
- psr/log: ^1.1
- symfony/yaml: ^5.0
Requires (Dev)
- bamarni/composer-bin-plugin: ^1.3
- phpunit/phpunit: ^9.0
- roave/security-advisories: dev-master
README
Componentes y utilidades para Doctrine
Guía para el desarrollo
Requisitos
Instalar Docker para poder ejecutar la versión concreta para el proyecto de PHP...
https://docs.docker.com/engine/installation/
Instalación
Inicialización e instalación del proyecto
make install
Con esto tendríamos desplegado el proyecto con las dependencias y herramientas necesarias para su ejecución...
- Utilidades necesarias para desarrollo y pruebas en el directorio
bin
...- composer
- testing tools (phpunit)
- Dependencias instaladas (composer)
[!] Para generar la configuración para un entorno de desarrollo mejor con make install-dev
[!] Sí quisiéramos borrar la instalación generada podemos recurrir ejecutando make uninstall
Instalación con Docker
make install-docker-dev
Instala el proyecto generando la imagen necesaria de PHP con Docker donde se ejecutaran todos los procesos PHP, en concreto todos los tests desarrollados que prueban el proyecto.
Ejecución
Están disponibles diferentes targets en make que simplifican las tareas comunes y uso de las principales herramientas de desarrollo y pruebas...
make help
A través del fichero de aliases.sh
podemos disponer de varios comandos de para ejecutar PHP
usando la virtualización con Docker para usar la versión concreta del proyecto...
source aliases.sh
- php-cli: Podemos ejecutar cualquier script PHP con la versión PHP del proyecto.
php-cli bin/phpunit php-cli bin/composer
- composer: lanza composer usando la version de PHP del contenedor de la aplicaión
composer update composer show
Testing
Para poder ejecutar el set de pruebas generadas tenemos...
make test
make test-verbose
make test-coverage
O a través del alias en el fichero alieases.sh
...
phpunit
Construido con 🛠️
- Docker - Virtualización
- Composer - Gestor de dependencias
- PHPUnit - xUnit testing framework
- Doctrine - Database storage and object mapping
Versionado 📌
Usamos SemVer para el versionado. Para todas las versiones disponibles, mira los tags en el repositorio.
Licencia 📄
Este proyecto está bajo la Licencia (WTFPL) - mira el archivo LICENSE.md para detalles
⌨️ con ❤️ por Oxkhar 😊