README

A reusable Symfony bundle providing authentication, user management, and master data loading functionality.

Features

JWT Authentication: Complete authentication system with login, register, password reset
User Management: User entity, repository, and service layer
Master Data Loading: Flexible master data loading from PHP configuration files
Database Tools: Git branch-based database naming, database copy command
Health Checks: API health check endpoints
Fully Tested: 35 tests with 96 assertions (100% passing)

Installation

Via Composer (from Packagist)

composer require larsvandersangen/project-template-bundle

Requirements

PHP >= 8.5
Symfony >= 7.4
Doctrine ORM >= 3.6
Lexik JWT Authentication Bundle >= 3.2

Quick Start

1. Register the Bundle

Add to config/bundles.php:

return [
    // ...
    LarsVanDerSangen\ProjectTemplateBundle\ProjectTemplateBundle::class => ['all' => true],
];

2. Configure the Bundle

Create config/packages/project_template.yaml:

project_template:
    mailer_sender: 'noreply@example.com'

3. Import Routes

Add to config/routes.yaml:

project_template:
    resource: '@ProjectTemplateBundle/config/routes.yaml'
    prefix: /

4. Configure Security

Update config/packages/security.yaml:

security:
    password_hashers:
        LarsVanDerSangen\ProjectTemplateBundle\User\Entity\User: 'auto'
    
    providers:
        app_user_provider:
            entity:
                class: LarsVanDerSangen\ProjectTemplateBundle\User\Entity\User
                property: email
    
    firewalls:
        public:
            pattern: ^/(api/health|api/auth/(login|register|forgot-password|reset-password))
            security: false
        
        api:
            pattern: ^/api
            stateless: true
            provider: app_user_provider
            custom_authenticators:
                - LarsVanDerSangen\ProjectTemplateBundle\Auth\Security\JwtAuthenticator
            entry_point: LarsVanDerSangen\ProjectTemplateBundle\Auth\Security\JwtAuthenticator
    
    access_control:
        - { path: ^/api/health, roles: PUBLIC_ACCESS }
        - { path: ^/api/auth/(login|register|forgot-password|reset-password), roles: PUBLIC_ACCESS }
        - { path: ^/api, roles: ROLE_USER }

5. Generate JWT Keys

mkdir -p config/jwt
openssl genrsa -out config/jwt/private.pem -aes256 -passout pass:changeme 4096
openssl rsa -pubout -in config/jwt/private.pem -out config/jwt/public.pem -passin pass:changeme

6. Configure JWT

Create config/packages/lexik_jwt_authentication.yaml:

lexik_jwt_authentication:
    secret_key: '%kernel.project_dir%/config/jwt/private.pem'
    public_key: '%kernel.project_dir%/config/jwt/public.pem'
    pass_phrase: 'changeme'

7. Run Migrations

php bin/console doctrine:migrations:migrate

8. Load Master Data

php bin/console app:master-data:load

Usage

Authentication Endpoints

The bundle provides the following authentication endpoints:

Register

POST /api/auth/register
Content-Type: application/json

{
    "email": "user@example.com",
    "password": "SecurePass123!",
    "firstName": "John",
    "lastName": "Doe"
}

Login

POST /api/auth/login
Content-Type: application/json

{
    "email": "user@example.com",
    "password": "SecurePass123!"
}

Response:

{
    "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9...",
    "user": {
        "id": 1,
        "email": "user@example.com",
        "firstName": "John",
        "lastName": "Doe"
    }
}

Forgot Password

POST /api/auth/forgot-password
Content-Type: application/json

{
    "email": "user@example.com"
}

Reset Password

POST /api/auth/reset-password
Content-Type: application/json

{
    "token": "reset-token-from-email",
    "password": "NewSecurePass123!"
}

Protected Endpoints

Use the JWT token in the Authorization header:

GET /api/users/1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9...

License

MIT

Support

Issues: GitHub Issues
Source: GitHub Repository

larsvandersangen / project-template-bundle-dev

Maintainers

Details