dev only
Getting started
Install and configure the boilerplate in minutes using Docker.
Installation
Clone the repository and start the Docker environment in three commands:
-
1
Clone the repository
git clone https://github.com/Manguet/symfony-saas-boilerplate.git -
2
Start the Docker containers
make up -
3
Install dependencies, run migrations and load fixtures
make install
The application is available at http://symfony-boilerplate.dev.
Configuration
Copy .env to .env.local and fill in the following variables:
cp .env .env.local
| Variable | Description | Example |
|---|---|---|
DATABASE_URL |
PostgreSQL connection | postgresql://app:app@postgres:5432/app |
REDIS_URL |
Redis connection | redis://redis:6379 |
MAILER_DSN |
Mail transport | smtp://mailpit:1025 |
STRIPE_SECRET_KEY |
Stripe secret key | sk_test_… |
STRIPE_WEBHOOK_SECRET |
Stripe webhook secret | whsec_… |
Make commands
All common operations are available as Make targets. They run inside the Docker container.
| Command | Description |
|---|---|
make up | Start containers |
make down | Stop containers |
make install | Full install (deps, migrate, seed, assets) |
make migrate | Run Doctrine migrations |
make seed | Load fixtures |
make test-db | Create test database and run migrations |
make test | Full test suite (Unit + Integration + E2E) |
make test-unit | Unit tests only |
make test-integration | Integration tests only (requires test-db) |
make test-functional | E2E / functional tests only (requires test-db) |
make lint | PHP CS Fixer (check) + PHPStan |
make lint-fix | PHP CS Fixer (auto-fix) |
make cc | Clear Symfony cache |
make doctor | Check services health |
make shell | Shell into the PHP container |