doc: refactor BlogPostProvider examples (#2239)

alexislefebvre · soyuka · commit 04bdd638af5d · 2026-01-27T16:40:52.000+01:00
diff --git a/core/state-providers.md b/core/state-providers.md
@@ -125,7 +125,7 @@ use ApiPlatform\Metadata\CollectionOperationInterface;
  */
 final class BlogPostProvider implements ProviderInterface
 {
-    private array $data;
+    // …
 
     public function provide(Operation $operation, array $uriVariables = [], array $context = []): iterable|BlogPost|null
     {
@@ -185,6 +185,13 @@ final class BlogPostProvider implements ProviderInterface
 {
     private array $data;
 
+    public function __construct() {
+        $this->data = [
+            'ab' => new BlogPost('ab'),
+            'cd' => new BlogPost('cd'),
+        ];
+    }
+
     public function provide(Operation $operation, array $uriVariables = [], array $context = []): BlogPost|null
     {
         return $this->data[$uriVariables['id']] ?? null;
@@ -236,7 +243,7 @@ use ApiPlatform\Metadata\CollectionOperationInterface;
  */
 final class BlogPostProvider implements ProviderInterface
 {
-    private array $data;
+    // …
 
     public function provide(Operation $operation, array $uriVariables = [], array $context = []): iterable|BlogPost|null
     {

Original file line number	Diff line number	Diff line change
`@@ -125,7 +125,7 @@ use ApiPlatform\Metadata\CollectionOperationInterface;`
`125`	`125`	`*/`
`126`	`126`	`final class BlogPostProvider implements ProviderInterface`
`127`	`127`	`{`
`128`		`- private array $data;`
	`128`	`+ // …`
`129`	`129`
`130`	`130`	`public function provide(Operation $operation, array $uriVariables = [], array $context = []): iterable\|BlogPost\|null`
`131`	`131`	`{`
`@@ -185,6 +185,13 @@ final class BlogPostProvider implements ProviderInterface`
`185`	`185`	`{`
`186`	`186`	`private array $data;`
`187`	`187`
	`188`	`+ public function __construct() {`
	`189`	`+ $this->data = [`
	`190`	`+ 'ab' => new BlogPost('ab'),`
	`191`	`+ 'cd' => new BlogPost('cd'),`
	`192`	`+ ];`
	`193`	`+ }`
	`194`	`+`
`188`	`195`	`public function provide(Operation $operation, array $uriVariables = [], array $context = []): BlogPost\|null`
`189`	`196`	`{`
`190`	`197`	`return $this->data[$uriVariables['id']] ?? null;`
`@@ -236,7 +243,7 @@ use ApiPlatform\Metadata\CollectionOperationInterface;`
`236`	`243`	`*/`
`237`	`244`	`final class BlogPostProvider implements ProviderInterface`
`238`	`245`	`{`
`239`		`- private array $data;`
	`246`	`+ // …`
`240`	`247`
`241`	`248`	`public function provide(Operation $operation, array $uriVariables = [], array $context = []): iterable\|BlogPost\|null`
`242`	`249`	`{`