qizuna / symfony-starter-kit
Installs: 40
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 2
Forks: 0
Open Issues: 0
Language:Twig
Type:project
Requires
- php: >=8.3
- ext-ctype: *
- ext-iconv: *
- ext-intl: *
- doctrine/annotations: ^1.0
- doctrine/doctrine-bundle: ^2.7
- doctrine/doctrine-migrations-bundle: ^3.2
- doctrine/orm: ^2.13
- easycorp/easyadmin-bundle: ^4.10
- endroid/qr-code: ^5.0
- gedmo/doctrine-extensions: ^3.11
- gotenberg/gotenberg-php: ^1.1
- knplabs/knp-paginator-bundle: ^6.0
- knplabs/knp-time-bundle: ^2.0
- league/csv: ^9.8
- league/flysystem-aws-s3-v3: ^3.28
- league/flysystem-bundle: ^3.3
- meilisearch/meilisearch-php: ^1.1
- nyholm/psr7: ^1.0
- openai-php/symfony: ^0.10.0
- php-http/guzzle7-adapter: ^1.0
- phpdocumentor/reflection-docblock: ^5.3
- phpoffice/phpspreadsheet: ^2.1
- phpstan/phpdoc-parser: ^1.13
- scheb/2fa-bundle: ^7.5
- scheb/2fa-email: ^7.5
- scheb/2fa-google-authenticator: ^7.5
- scheb/2fa-totp: ^7.5
- scheb/2fa-trusted-device: ^7.5
- symfony/apache-pack: ^1.0
- symfony/asset: 7.1.*
- symfony/console: 7.1.*
- symfony/doctrine-messenger: 7.1.*
- symfony/dotenv: 7.1.*
- symfony/expression-language: 7.1.*
- symfony/flex: ^2
- symfony/form: 7.1.*
- symfony/framework-bundle: 7.1.*
- symfony/http-client: 7.1.*
- symfony/intl: 7.1.*
- symfony/mailer: 7.1.*
- symfony/messenger: 7.1.*
- symfony/mime: 7.1.*
- symfony/monolog-bundle: ^3.0
- symfony/notifier: 7.1.*
- symfony/password-hasher: 7.1.*
- symfony/process: 7.1.*
- symfony/property-access: 7.1.*
- symfony/property-info: 7.1.*
- symfony/proxy-manager-bridge: 6.4.*
- symfony/runtime: 7.1.*
- symfony/security-bundle: 7.1.*
- symfony/serializer: 7.1.*
- symfony/string: 7.1.*
- symfony/translation: 7.1.*
- symfony/twig-bundle: 7.1.*
- symfony/uid: 7.1.*
- symfony/ux-autocomplete: ^2.7
- symfony/ux-chartjs: ^2.18
- symfony/ux-live-component: ^2.18
- symfony/ux-react: ^2.18
- symfony/ux-toggle-password: ^2.18
- symfony/ux-twig-component: ^2.9
- symfony/validator: 7.1.*
- symfony/web-link: 7.1.*
- symfony/webpack-encore-bundle: ^2.1
- symfony/workflow: 7.1.*
- symfony/yaml: 7.1.*
- symfonycasts/reset-password-bundle: ^1.0
- twig/cssinliner-extra: ^3.4
- twig/extra-bundle: ^3.6
- twig/inky-extra: ^3.4
- twig/intl-extra: ^3.6
- twig/twig: ^2.12|^3.0
Requires (Dev)
- doctrine/doctrine-fixtures-bundle: ^3.4
- fakerphp/faker: ^1.20
- liip/test-fixtures-bundle: *
- pestphp/pest: ^2.0
- roave/security-advisories: dev-latest
- symfony/browser-kit: 7.1.*
- symfony/css-selector: 7.1.*
- symfony/debug-bundle: 7.1.*
- symfony/maker-bundle: ^1.0
- symfony/phpunit-bridge: ^6.1
- symfony/stopwatch: 7.1.*
- symfony/web-profiler-bundle: 7.1.*
Conflicts
README
A quoi sert ce starter kit ?
Ce kit sert à deployer rapidement une nouvelle application. L'objectif de ce starter kit est d'etre configurable sur de multiple points pour pouvoir déployer une base d'application dans un délai rapide.
Elements compris dans le starter kit
- Symfony
- Security ( login / logout / utilisateurs )
- Reset Password
- Administration
- Webpack Encore ( compilation des assets)
- Tailwind CSS
- Outils qualité
- Testing (PHPUnit)
- Makefile (by YoanDev)
Pré-requis à l'utilisation
- Avoir une installation de PHP 8.1 configurée
- Avoir un environnement Docker fonctionnel
- Disposer de la commande
Make
Comment utiliser ce starter kit ?
composer create-project qizuna/starter-kit ./myNewProjectFolder
Laisser le projet s'installer puis
make first-install
Votre navigateur devrait s'ouvrir et afficher l'écran de connexion de l'application 😀. A vous de commencer votre travail maintenant !
Les outils qualité (QA)
S'il est possible d'appeller les outils qualité directement via docker, il est également possible de les
appeler via des commandes préparées dans le fichier Makefile
Les vérifications avec before-commit
La commande la plus utile sera certainement make before-commit
. Cette commande lancera plusieurs outils QA les uns après les autres et lancera au final la suite de tests.
Les tests avec make tests
et make tests-coverage
Une autre commande utile : make tests
ou make test-coverage
. Ces deux commandes reconstruisent la base de données de test, et lancent la suite de tests sur le projet.
Problème connus
Ports Docker déjà utilisés
Error response from daemon: driver failed programming external connectivity on endpoint xxx-mailer-1 (9dc1c1f5399ba8ccab04afcde5d5456c71d03b331f47e40c4530d4d6331061fb):
Bind for 0.0.0.0:1080 failed: port is already allocated
Dans ce cas précis, le port demandé par un container docker est déja occupé par une autre application.
Vous pouvez reconfigurer les ports dans le fichier docker-composer.override.yml