fix(laravel): read property type before serialization

fixes #7316

Author: soyuka

src/Laravel/ApiPlatformProvider.php

@@ -262,10 +262,10 @@ public function register(): void
             return new CachePropertyMetadataFactory(
                 new SchemaPropertyMetadataFactory(
                     $app->make(ResourceClassResolverInterface::class),
-                    new PropertyInfoPropertyMetadataFactory(
-                        $app->make(PropertyInfoExtractorInterface::class),
-                        new SerializerPropertyMetadataFactory(
-                            $app->make(SerializerClassMetadataFactory::class),
+                    new SerializerPropertyMetadataFactory(
+                        $app->make(SerializerClassMetadataFactory::class),
+                        new PropertyInfoPropertyMetadataFactory(
+                            $app->make(PropertyInfoExtractorInterface::class),
                             new AttributePropertyMetadataFactory(
                                 new EloquentAttributePropertyMetadataFactory(
                                     new EloquentPropertyMetadataFactory(

src/Laravel/Tests/CustomRelationTest.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace ApiPlatform\Laravel\Tests;
+
+use ApiPlatform\Laravel\Test\ApiTestAssertionsTrait;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Orchestra\Testbench\Concerns\WithWorkbench;
+use Orchestra\Testbench\TestCase;
+use Workbench\App\ApiResource\Home;
+use Workbench\App\Models\Order;
+use Workbench\Database\Factories\OrderFactory;
+
+class CustomRelationTest extends TestCase
+{
+    use ApiTestAssertionsTrait;
+    use RefreshDatabase;
+    use WithWorkbench;
+
+    public function testCustomRelation(): void
+    {
+        $response = $this->get('/api/home', headers: ['accept' => ['application/ld+json']]);
+        dd($response->json());
+        $this->assertArrayHasKey('order', $response->json());
+        $this->assertEquals([
+            'id' => $order->id,
+            'number' => $order->number,
+        ], $response->json()['order']);
+    }
+}

src/Laravel/workbench/app/ApiResource/Home.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace Workbench\App\ApiResource;
+
+use Workbench\Database\Factories\OrderFactory;
+use ApiPlatform\Metadata\ApiProperty;
+use ApiPlatform\Metadata\ApiResource;
+use ApiPlatform\Metadata\Get;
+use ApiPlatform\Metadata\Operation;
+use Symfony\Component\Serializer\Annotation\Groups;
+use Workbench\App\Models\Order;
+
+#[ApiResource(
+    operations: [
+        new Get(
+            uriTemplate: '/home',
+            normalizationContext: ['groups' => ['home:read']],
+            provider: [self::class, 'provide'],
+        ),
+    ],
+)]
+class Home
+{
+    #[ApiProperty(identifier: true)]
+    public int $id = 1;
+
+    #[Groups(['home:read'])]
+    public ?Order $order = null;
+
+    public static function provide(Operation $operation, array $uriVariables = [], array $context = []): object|array|null {
+        $order = OrderFactory::new()->create();
+        $home = new Home();
+        $home->order = $order;
+
+        return $home;
+    }
+}

src/Laravel/workbench/app/Models/Order.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace Workbench\App\Models;
+
+use ApiPlatform\Metadata\ApiProperty;
+use ApiPlatform\Metadata\ApiResource;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Symfony\Component\Serializer\Attribute\Groups;
+
+#[ApiResource()]
+#[ApiProperty(property: 'id', serialize: [new Groups(['home:read'])])]
+#[ApiProperty(property: 'number', serialize: [new Groups(['home:read'])])]
+class Order extends Model
+{
+    use HasFactory;
+
+    protected $fillable = [
+        'number',
+    ];
+}

src/Laravel/workbench/database/factories/OrderFactory.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Workbench\Database\Factories;
+
+use Illuminate\Database\Eloquent\Factories\Factory;
+use Workbench\App\Models\Order;
+
+class OrderFactory extends Factory
+{
+    protected $model = Order::class;
+
+    public function definition()
+    {
+        return [
+            'number' => $this->faker->randomNumber(),
+        ];
+    }
+}

src/Laravel/workbench/database/migrations/2025_05_08_000000_create_orders_table.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('orders', function (Blueprint $table): void {
+            $table->id();
+            $table->integer('number');
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('orders');
+    }
+};

src/Metadata/Property/Factory/PropertyInfoPropertyMetadataFactory.php

@@ -13,6 +13,7 @@
 
 namespace ApiPlatform\Metadata\Property\Factory;
 
+use Workbench\App\ApiResource\Home;
 use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\Exception\PropertyNotFoundException;
 use Doctrine\Common\Collections\ArrayCollection;

src/Metadata/Property/Factory/SerializerPropertyMetadataFactory.php

@@ -19,6 +19,7 @@
 use ApiPlatform\Metadata\Util\ResourceClassInfoTrait;
 use Symfony\Component\Serializer\Mapping\AttributeMetadataInterface;
 use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactoryInterface as SerializerClassMetadataFactoryInterface;
+use Workbench\App\ApiResource\Home;
 
 /**
  * Populates read/write and link status using serialization groups.