symfony

name	symfony
description	Symfony framework with PestPHP testing and Clean Architecture patterns
license	MIT
compatibility	opencode
metadata	{"type":"backend","framework":"symfony","language":"php"}

SKILL: Symfony

🛠 Tech Stack

• Testing: PestPHP
• Validation: Symfony Validator Component

⚡ Arquitectura & Logs

1. Carpetas: src/ con Domain/, Application/, Infrastructure/.
2. Log: (Configurado en monolog.yaml para output json)

   {
       "message": "User login failed",
       "context": {
           "username": "[e-mail]",
           "reason": "Invalid credentials",
           "correlationId": "xyz-456"
       },
       "level": 400,
       "level_name": "ERROR",
       "channel": "app",
       "datetime": "...",
       "extra": {}
   }
   

✅ Patrones (Snippets Reales)

A. TDD Workflow (PestPHP)

// 1. Muestra el test fallando (RED)
// tests/Application/Service/DiscountCalculatorTest.php
use App\Application\Service\DiscountCalculator;

it('calculates a 10% discount correctly', function () {
    $calculator = new DiscountCalculator();
    
    // El test pasa después de implementar la lógica
    expect($calculator->calculate(100, 10))->toBe(90.0);
});

B. Secure Controller (Symfony Validator)

// 2. Validación de DTO en un controlador
// src/Infrastructure/Http/Controller/CreateUserController.php
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Annotation\Route;
use Symfony\Component\Validator\Validator\ValidatorInterface;
use App\Application\DTO\CreateUserDTO; // Un DTO con Asserts

#[Route('/api/users', name: 'user_create', methods: ['POST'])]
public function __invoke(Request $request, ValidatorInterface $validator): Response
{
    try {
        $data = json_decode($request->getContent(), true);
        $dto = new CreateUserDTO($data['email'], $data['password']);

        $errors = $validator->validate($dto);
        if (count($errors) > 0) {
            // Devolver errores de validación
            return new Response((string) $errors, Response::HTTP_BAD_REQUEST);
        }
        
        // ... llamar al caso de uso de aplicación
        return new Response('', Response::HTTP_CREATED);

    } catch (\Exception $e) {
        // Loggear y devolver error genérico
        return new Response('An error occurred', Response::HTTP_INTERNAL_SERVER_ERROR);
    }
}

Errores Comunes Symfony

1. DI Container no detecta cambios en services

Problema: Se modifica services.yaml o cycle.yaml pero Symfony sigue con la config vieja. Solución: Siempre limpiar cache después de cambios en configuración:

php bin/console cache:clear

2. Servicio factory no se resuelve

Problema: Un servicio creado vía factory: no es autowireable. Solución: Registrar el servicio explícitamente con argumentos nombrados:

services:
    # Factory que crea el servicio
    my.service.internal:
        class: Some\Internal\Service
        factory: ['@Some\Factory', 'create']
        arguments: [SomeEntity]

    # Wrapper público que usa el servicio factory
    App\MyService:
        arguments:
            $internalService: '@my.service.internal'

3. Verificar que el container compila

Después de cualquier cambio en services o configuración DI:

php bin/console cache:clear && php bin/console debug:container --tag=controller.service_arguments