api-platform:make-processor
Génère un State Processor API Platform pour personnaliser la persistence des données
- License 许可
- MIT
- 最近更新
- 2026-03-02
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- api-platform:make-processor
- model
- sonnet
- license
- MIT
- version
- 1.0.0
- description
- Génère un State Processor API Platform pour personnaliser la persistence des données
- allowed-tools
- [ "AskUserQuestion", "Bash", "Read", "Write", "Edit", "Grep", "Glob" ]
- argument-hint
- <nom-resource>
03 SKILL.md 正文
API Platform Make Processor
Génère un State Processor personnalisé pour API Platform. Les processors sont responsables de la persistence des données pour les opérations d'écriture (POST, PUT, PATCH, DELETE).
Variables
- {ResourceName} - Nom de la resource en PascalCase
- {namespace} - Namespace du projet (défaut: App)
Outputs
src/State/{ResourceName}Processor.php
Instructions à Exécuter
IMPORTANT : Exécute ce workflow étape par étape :
1. Identifier la resource cible
- Si
$ARGUMENTSest fourni, utiliser comme nom de la resource - Sinon, utiliser AskUserQuestion :
Question: "Pour quelle resource créer un State Processor ?" Header: "Resource"
2. Vérifier la resource existante
- Chercher
src/Entity/{ResourceName}.phpousrc/ApiResource/{ResourceName}.phpavec Glob - Si la resource existe, lire le fichier pour comprendre sa structure
- Si la resource n'existe pas, informer l'utilisateur
3. Choisir la stratégie de processing
- Utiliser AskUserQuestion :
Question: "Quelle stratégie de processing ?" Header: "Stratégie" Options: - "Décorer Doctrine (Recommandé)" : "Ajouter de la logique avant/après la persistence Doctrine" - "Custom complet" : "Logique de persistence entièrement personnalisée" - "Messenger (async)" : "Dispatcher un message Symfony Messenger au lieu de persister directement"
4. Identifier les opérations à gérer
- Utiliser AskUserQuestion (multiSelect: true) :
Question: "Quelles opérations le processor doit-il gérer ?" Header: "Opérations" Options: - "Création (POST)" : "Logique spécifique à la création de la resource" - "Mise à jour (PUT/PATCH)" : "Logique spécifique à la modification" - "Suppression (DELETE)" : "Logique spécifique à la suppression (soft delete, cascade, etc.)"
5. Détecter le namespace du projet
- Lire
composer.jsonavec Read - Extraire le namespace depuis
autoload.psr-4
6. Générer le State Processor
Processor décorant Doctrine :
<?php
declare(strict_types=1);
namespace {namespace}\State;
use ApiPlatform\Metadata\DeleteOperationInterface;
use ApiPlatform\Metadata\Operation;
use ApiPlatform\State\ProcessorInterface;
/**
* @implements ProcessorInterface<{ResourceName}, {ResourceName}|void>
*/
final readonly class {ResourceName}Processor implements ProcessorInterface
{
public function __construct(
private ProcessorInterface $decorated,
) {
}
public function process(mixed $data, Operation $operation, array $uriVariables = [], array $context = []): mixed
{
if ($operation instanceof DeleteOperationInterface) {
return $this->processDelete($data, $operation, $uriVariables, $context);
}
// Logique avant persistence
$this->beforePersist($data, $operation, $context);
$result = $this->decorated->process($data, $operation, $uriVariables, $context);
// Logique après persistence
$this->afterPersist($result, $operation, $context);
return $result;
}
private function beforePersist(mixed $data, Operation $operation, array $context): void
{
// Ex: enrichir les données, valider, auditer
}
private function afterPersist(mixed $result, Operation $operation, array $context): void
{
// Ex: envoyer un email, dispatcher un event, invalider un cache
}
private function processDelete(mixed $data, Operation $operation, array $uriVariables, array $context): void
{
// Ex: soft delete au lieu de suppression physique
$this->decorated->process($data, $operation, $uriVariables, $context);
}
}
Processor avec Messenger :
<?php
declare(strict_types=1);
namespace {namespace}\State;
use ApiPlatform\Metadata\Operation;
use ApiPlatform\State\ProcessorInterface;
use Symfony\Component\Messenger\MessageBusInterface;
use {namespace}\Message\Create{ResourceName}Message;
/**
* @implements ProcessorInterface<{ResourceName}, {ResourceName}>
*/
final readonly class {ResourceName}Processor implements ProcessorInterface
{
public function __construct(
private MessageBusInterface $messageBus,
) {
}
public function process(mixed $data, Operation $operation, array $uriVariables = [], array $context = []): mixed
{
$this->messageBus->dispatch(new Create{ResourceName}Message($data));
return $data;
}
}
7. Configurer le service (si décoration Doctrine)
- Informer de la configuration :
# config/services.yaml
services:
App\State\{ResourceName}Processor:
arguments:
$decorated: '@api_platform.doctrine.orm.state.persist_processor'
# Pour la suppression :
# $decorated: '@api_platform.doctrine.orm.state.remove_processor'
8. Mettre à jour la resource
- Ajouter le processor dans l'attribut
#[ApiResource]:
#[ApiResource(
processor: {ResourceName}Processor::class,
)]
9. Afficher le résumé
State Processor {ResourceName}Processor généré
Fichiers créés :
- src/State/{ResourceName}Processor.php
Configuration requise :
- Vérifier config/services.yaml (si décoration Doctrine)
Prochaines étapes :
- Implémenter la logique métier dans process()
- Créer le provider associé : /api-platform:make-provider {ResourceName}
- Tester : /api-platform:make-test {ResourceName}
Patterns appliqués
State Processor
- Implémente
ProcessorInterface - Classe
final readonly - Séparation create/update/delete dans des méthodes dédiées
- Hook beforePersist/afterPersist pour la logique métier
Bonnes pratiques
- Décorer le processor Doctrine pour garder la persistence automatique
- Utiliser
DeleteOperationInterfacepour détecter les suppressions - Dispatcher des events/messages pour les effets de bord (emails, notifications)
- Ne pas mélanger logique métier et persistence dans le même processor
Notes
- Le processor est appelé pour les opérations POST, PUT, PATCH, DELETE
- Pour la lecture (GET), utiliser un State Provider
- Un processor peut retourner un objet différent de celui reçu (transformation)
- Pour le traitement asynchrone, combiner avec Symfony Messenger
04 同仓库更多 Skills
twig:make-component
Génère un Twig Component Symfony UX (classe PHP + template Twig)
tester:ui-test
Teste automatiquement une interface utilisateur dans Chrome : navigation, clics, validation visuelle, tests fonctionnels, responsive, comportement et debug. Génère un rapport détaillé avec screenshots et optionnellement un GIF du parcours.
symfony:voter
Genere un Voter de securite Symfony pour le controle d'acces granulaire
symfony:message
Genere un Message Symfony Messenger avec son Handler pour traitement asynchrone
symfony:mailer
Genere un email Symfony (TemplatedEmail ou Notification) avec template Twig
symfony:form
Genere un FormType Symfony avec contraintes de validation et options