Installation

Requirements

• PHP 8.4 or higher
• Symfony 8.0 or higher
• Composer

Install via Composer

composer require outcomer/symfony-json-schema-validation

Bundle Registration

If using Symfony Flex (recommended), the bundle will be automatically registered. Otherwise, add it manually:

// config/bundles.php
return [
    // ...
    Outcomer\ValidationBundle\OutcomerValidationBundle::class => ['all' => true],
];

Configuration

Create a configuration file to customize the bundle settings:

# config/packages/outcomer_validation.yaml
outcomer_validation:
    schemas_path: '%kernel.project_dir%/config/validation/schemas'
    schema_domain: 'https://your-domain.com/schemas'
    filters:
        trim: Outcomer\ValidationBundle\Filter\TrimFilter
        lowercase: Outcomer\ValidationBundle\Filter\LowercaseFilter

Configuration Options

Option	Default	Description
schemas_path	%kernel.project_dir%/config/validation/schemas	Directory containing JSON schema files
schema_domain	null	Base URL for schema references
filters	{}	Custom data filters for preprocessing

Directory Structure

Create the schemas directory:

mkdir -p config/validation/schemas

Your project structure should look like:

your-project/
├── config/
│   ├── packages/
│   │   └── outcomer_validation.yaml
│   └── validation/
│       └── schemas/
│           ├── user-create.json
│           ├── user-update.json
│           └── product-search.json
├── src/
│   └── Controller/
│       └── ApiController.php
└── ...

Verify Installation

Create a simple test schema and controller to verify everything works:

# config/validation/schemas/test.json
{
  "type": "object",
  "properties": {
    "body": {
      "type": "object",
      "properties": {
        "message": { "type": "string" }
      },
      "required": ["message"]
    }
  }
}

# src/Controller/TestController.php
<?php

use Outcomer\ValidationBundle\Attribute\MapRequest;
use Outcomer\ValidationBundle\Model\ValidatedRequest;
use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\Routing\Attribute\Route;

class TestController extends AbstractController
{
    #[Route('/test', methods: ['POST'])]
    public function test(#[MapRequest('test.json')] ValidatedRequest $request): JsonResponse
    {
        return $this->json([
            'received' => $request->getPayload()->getBody()->message
        ]);
    }
}

Test with curl:

curl -X POST http://localhost/test \
  -H "Content-Type: application/json" \
  -d '{"message":"Hello World"}'

Next Steps

• Quick Start → - Create your first validation
• Configuration → - Learn about all configuration options
• Schema Basics → - Understand JSON Schema fundamentals