Api Platformmake Provider

2. Vérifier la resource existante

• Chercher src/Entity/{ResourceName}.php ou src/ApiResource/{ResourceName}.php avec Glob
• Si la resource existe, lire le fichier pour comprendre sa structure
• Si la resource n'existe pas, informer l'utilisateur et proposer /api-platform:make-resource

3. Choisir le type de provider

• Utiliser AskUserQuestion :

  Question: "Quel type de provider créer ?"
  Header: "Type"
  Options:
    - "Complet (Recommandé)" : "Gère à la fois les items (Get) et les collections (GetCollection)"
    - "Item uniquement" : "Gère uniquement la récupération d'un item (Get)"
    - "Collection uniquement" : "Gère uniquement la récupération de collections (GetCollection)"
  

4. Choisir la source de données

• Utiliser AskUserQuestion :

  Question: "Quelle est la source de données ?"
  Header: "Source"
  Options:
    - "Doctrine (Recommandé)" : "Décorer le provider Doctrine existant pour ajouter de la logique"
    - "Service externe" : "API tierce, microservice, ou autre source"
    - "Custom" : "Logique métier complexe, agrégation de sources multiples"
  

5. Détecter le namespace du projet

• Lire composer.json avec Read
• Extraire le namespace depuis autoload.psr-4
• Si non trouvé, utiliser App par défaut

6. Générer le State Provider

Provider décorant Doctrine :

<?php

declare(strict_types=1);

namespace {namespace}\State;

use ApiPlatform\Metadata\CollectionOperationInterface;
use ApiPlatform\Metadata\Operation;
use ApiPlatform\State\ProviderInterface;

/**
 * @implements ProviderInterface<{ResourceName}>
 */
final readonly class {ResourceName}Provider implements ProviderInterface
{
    public function __construct(
        private ProviderInterface $decorated,
    ) {
    }

    public function provide(Operation $operation, array $uriVariables = [], array $context = []): object|array|null
    {
        if ($operation instanceof CollectionOperationInterface) {
            return $this->provideCollection($operation, $uriVariables, $context);
        }

        return $this->provideItem($operation, $uriVariables, $context);
    }

    private function provideCollection(Operation $operation, array $uriVariables, array $context): iterable
    {
        $items = $this->decorated->provide($operation, $uriVariables, $context);

        // Logique personnalisée sur la collection
        return $items;
    }

    private function provideItem(Operation $operation, array $uriVariables, array $context): ?object
    {
        $item = $this->decorated->provide($operation, $uriVariables, $context);

        // Logique personnalisée sur l'item
        return $item;
    }
}

Provider depuis source externe :

<?php

declare(strict_types=1);

namespace {namespace}\State;

use ApiPlatform\Metadata\CollectionOperationInterface;
use ApiPlatform\Metadata\Operation;
use ApiPlatform\State\ProviderInterface;
use {namespace}\ApiResource\{ResourceName};

/**
 * @implements ProviderInterface<{ResourceName}>
 */
final readonly class {ResourceName}Provider implements ProviderInterface
{
    public function __construct(
        // Injecter le client HTTP ou le service métier
    ) {
    }

    public function provide(Operation $operation, array $uriVariables = [], array $context = []): object|array|null
    {
        if ($operation instanceof CollectionOperationInterface) {
            // Récupérer et retourner la collection
            return [];
        }

        // Récupérer et retourner un item
        $id = $uriVariables['id'] ?? null;

        return null;
    }
}

7. Configurer le service (si décoration Doctrine)

• Vérifier si config/services.yaml existe
• Informer l'utilisateur de la configuration nécessaire si autoconfiguration Symfony :

# config/services.yaml