php-symfony
Symfony framework mastery - Doctrine, DI container, Messenger, and enterprise architecture
When & Why to Use This Skill
This Claude skill provides comprehensive mastery of the Symfony framework, enabling developers to build robust, enterprise-grade PHP applications. It offers expert guidance and automated code generation for core components including Doctrine ORM, Dependency Injection (DI) containers, the Messenger component for asynchronous processing, and API Platform integration, supporting the latest Symfony 6.4 LTS and 7.x versions.
Use Cases
- Architecting enterprise-level PHP applications using Symfony's best practices for security, routing, and modular dependency injection.
- Designing complex database schemas and implementing efficient data persistence layers with Doctrine ORM, migrations, and advanced mapping.
- Building scalable asynchronous systems and microservices using the Symfony Messenger component for reliable message handling and background tasks.
- Developing standardized, high-performance RESTful and GraphQL APIs quickly using integrated API Platform features.
- Refactoring legacy PHP code into modern Symfony architectures using advanced DI container features like compiler passes, decorators, and service subscribers.
| name | php-symfony |
|---|---|
| version | "2.0.0" |
| description | Symfony framework mastery - Doctrine, DI container, Messenger, and enterprise architecture |
| sasmp_version | "1.3.0" |
| bonded_agent | 03-php-symfony |
| bond_type | PRIMARY_BOND |
| atomic | true |
| category | framework |
Symfony Framework Skill
Atomic skill for mastering enterprise-grade Symfony applications
Overview
Comprehensive skill for building robust Symfony applications. Covers Symfony 6.4 LTS and 7.x with focus on Doctrine ORM, dependency injection, and API Platform.
Skill Parameters
Input Validation
interface SkillParams {
topic:
| "doctrine" // ORM, DBAL, migrations
| "di-container" // Services, autowiring, tags
| "routing" // Routes, controllers
| "security" // Voters, firewalls
| "messenger" // Async messaging
| "api-platform" // REST/GraphQL APIs
| "forms"; // Form types, validation
level: "beginner" | "intermediate" | "advanced";
symfony_version?: "6.4" | "7.0" | "7.1" | "7.2";
project_type?: "webapp" | "api" | "microservice";
}
Validation Rules
validation:
topic:
required: true
allowed: [doctrine, di-container, routing, security, messenger, api-platform, forms]
level:
required: true
symfony_version:
default: "7.1"
Learning Modules
Module 1: Doctrine ORM
beginner:
- Entity creation with attributes
- Basic relationships
- Repository basics
intermediate:
- DQL and QueryBuilder
- Lifecycle events
- Custom repository methods
advanced:
- Inheritance mapping
- Second-level cache
- Event subscribers
Module 2: Dependency Injection
beginner:
- Service basics
- Autowiring
- Constructor injection
intermediate:
- Service tags
- Factory services
- Decorators
advanced:
- Compiler passes
- Service subscribers
- Lazy services
Module 3: Messenger Component
beginner:
- Messages and handlers
- Sync vs async transports
intermediate:
- Message middleware
- Retry strategies
- Multiple transports
advanced:
- Custom transports
- Saga patterns
Execution Flow
graph TD
A[Skill Invoked] --> B{Validate}
B -->|Invalid| C[Return Error]
B -->|Valid| D[Load Content]
D --> E{Topic Router}
E --> F[Generate Examples]
F --> G[Add Console Commands]
Error Handling & Retry Logic
errors:
CONTAINER_ERROR:
code: "SYMFONY_001"
recovery: "Run cache:clear, check services.yaml"
DOCTRINE_ERROR:
code: "SYMFONY_002"
recovery: "Run doctrine:schema:validate"
retry:
max_attempts: 3
backoff:
type: exponential
initial_delay_ms: 100
Code Examples
Doctrine Entity
<?php
declare(strict_types=1);
namespace App\Entity;
use App\Repository\ProductRepository;
use Doctrine\ORM\Mapping as ORM;
use Symfony\Component\Validator\Constraints as Assert;
#[ORM\Entity(repositoryClass: ProductRepository::class)]
#[ORM\HasLifecycleCallbacks]
class Product
{
#[ORM\Id]
#[ORM\GeneratedValue]
#[ORM\Column]
private ?int $id = null;
#[ORM\Column(length: 255)]
#[Assert\NotBlank]
private string $name;
#[ORM\ManyToOne(inversedBy: 'products')]
#[ORM\JoinColumn(nullable: false)]
private Category $category;
#[ORM\Column]
private \DateTimeImmutable $createdAt;
public function __construct()
{
$this->createdAt = new \DateTimeImmutable();
}
}
Service with DI
<?php
declare(strict_types=1);
namespace App\Service;
use App\Repository\ProductRepository;
use Doctrine\ORM\EntityManagerInterface;
use Psr\Log\LoggerInterface;
use Symfony\Component\DependencyInjection\Attribute\Autowire;
final readonly class ProductService
{
public function __construct(
private ProductRepository $repository,
private EntityManagerInterface $entityManager,
private LoggerInterface $logger,
#[Autowire('%app.tax_rate%')]
private float $taxRate,
) {}
public function createProduct(array $data): Product
{
$product = new Product();
$product->setName($data['name']);
$this->entityManager->persist($product);
$this->entityManager->flush();
$this->logger->info('Product created', ['id' => $product->getId()]);
return $product;
}
}
Messenger Handler
<?php
declare(strict_types=1);
namespace App\MessageHandler;
use App\Message\SendOrderConfirmation;
use App\Service\EmailService;
use Symfony\Component\Messenger\Attribute\AsMessageHandler;
#[AsMessageHandler]
final readonly class SendOrderConfirmationHandler
{
public function __construct(
private EmailService $emailService,
) {}
public function __invoke(SendOrderConfirmation $message): void
{
$this->emailService->sendOrderConfirmation($message->orderId);
}
}
Test Templates
<?php
declare(strict_types=1);
namespace App\Tests\Functional;
use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
final class ProductControllerTest extends WebTestCase
{
public function testListProducts(): void
{
$client = static::createClient();
$client->request('GET', '/api/products');
$this->assertResponseIsSuccessful();
}
}
Troubleshooting
| Problem | Solution |
|---|---|
| Service not found | Run debug:container, check autowiring |
| Doctrine mapping error | Run doctrine:schema:validate |
| Route not found | Run debug:router, check firewall |
Quality Metrics
| Metric | Target |
|---|---|
| Code accuracy | 100% |
| Symfony conventions | 100% |
| DI best practices | 100% |
Usage
Skill("php-symfony", {topic: "messenger", level: "advanced"})