The "Symfony Demo Application" is a reference application created to show how to develop applications following the Symfony Best Practices.
- PHP 8.0.2 or higher;
- PDO-SQLite PHP extension enabled;
- and the usual Symfony application requirements.
Download Symfony to install the symfony
binary on your computer and run
this command:
$ symfony new --demo my_project
Alternatively, you can use Composer:
$ composer create-project symfony/symfony-demo my_project
There's no need to configure anything to run the application. If you have installed Symfony binary, run this command:
$ cd my_project/
$ symfony serve
Then access the application in your browser at the given URL (https://localhost:8000 by default).
If you don't have the Symfony binary installed, run php -S localhost:8000 -t public/
to use the built-in PHP web server or configure a web server like Nginx or
Apache to run the application.
Execute this command to run tests:
$ cd my_project/
$ ./bin/phpunit
If you use the .gitlab.ci.yml file (with GitLab CI) to push the application in production, you will need a server with Docker, Docker-compose and Traefik installed.
Add these environment variables in your CI application:
- APP_ENV (prod)
- APP_MAINTENANCE (0 or 1)
- APP_URL (domain for traefik)
- PRODUCTION_SERVER_PATH (the path where the application will be installed)