implement the interface ArrayableInterface for BaseActiveRecord

composer.json

@@ -21,6 +21,7 @@
     "require": {
         "php": "^8.0",
         "ext-json": "*",
+        "yiisoft/arrays": "^3.0",
         "yiisoft/db": "^1.1",
         "yiisoft/factory": "^1.0"
     },

src/ActiveRecordInterface.php

@@ -502,6 +502,16 @@ public function populateRecord(array|object $row): void;
 
     /**
      * Serializes the active record into its array implementation with attribute name as a key, and it values as value.
+     *
+     * @param array $fields the fields that the output array should contain. Fields not specified
+     * in {@see fields()} will be ignored. If this parameter is empty, all fields as specified
+     * in {@see fields()} will be returned.
+     * @param array $expand the additional fields that the output array should contain.
+     * Fields not specified in {@see extraFields()} will be ignored. If this parameter is empty, no extra fields
+     * will be returned.
+     * @param bool $recursive Whether to recursively return array representation of embedded objects.
+     *
+     * @return array The array representation of the object.
      */
-    public function toArray(): array;
+    public function toArray(array $fields = [], array $expand = [], bool $recursive = true): array;
 }

src/BaseActiveRecord.php

@@ -9,6 +9,9 @@
 use IteratorAggregate;
 use ReflectionException;
 use Throwable;
+use Yiisoft\Arrays\ArrayableInterface;
+use Yiisoft\Arrays\ArrayableTrait;
+use Yiisoft\Arrays\ArrayHelper;
 use Yiisoft\Db\Connection\ConnectionInterface;
 use Yiisoft\Db\Exception\Exception;
 use Yiisoft\Db\Exception\InvalidArgumentException;
@@ -40,8 +43,9 @@
  * @template-implements ArrayAccess<int, mixed>
  * @template-implements IteratorAggregate<int>
  */
-abstract class BaseActiveRecord implements ActiveRecordInterface, IteratorAggregate, ArrayAccess
+abstract class BaseActiveRecord implements ActiveRecordInterface, IteratorAggregate, ArrayAccess, ArrayableInterface
 {
+    use ArrayableTrait;
     use BaseActiveRecordTrait;
 
     private array $attributes = [];
@@ -117,7 +121,7 @@
     /**
      * @psalm-suppress MixedReturnTypeCoercion
      */
     public function fields(): array
     {
         $fields = array_keys($this->attributes);
 
@@ -1266,19 +1270,28 @@
         return $this->tableName;
     }
 
-    public function toArray(): array
+    /**
+     * @inheritDoc
+     */
+    public function toArray(array $fields = [], array $expand = [], bool $recursive = true): array
     {
         $data = [];
 
-        foreach ($this->fields() as $key => $value) {
-            if ($value instanceof Closure) {
-                /** @var mixed */
-                $data[$key] = $value($this);
-            } else {
-                /** @var mixed */
-                $data[$value] = $this[$value];
+        foreach ($this->resolveFields($fields, $expand) as $field => $definition) {
+            $attribute = $definition instanceof Closure ? $definition($this, $field) : $this[$definition];
+
+            if ($recursive) {
+                $nestedFields = $this->extractFieldsFor($fields, $field);
+                $nestedExpand = $this->extractFieldsFor($expand, $field);
+                if ($attribute instanceof ArrayableInterface) {
+                    $attribute = $attribute->toArray($nestedFields, $nestedExpand);
+                } elseif (is_array($attribute) && ($nestedExpand || $nestedFields)) {
+                    $attribute = $this->filterAndExpand($attribute, $nestedFields, $nestedExpand);
+                }
             }
+            $data[$field] = $attribute;
         }
-        return $data;
+
+        return $recursive ? ArrayHelper::toArray($data) : $data;
     }
 }

src/BaseActiveRecordTrait.php

@@ -76,11 +76,11 @@
             return $this->$getter();
         }
 
         if (method_exists($this, 'set' . ucfirst($name))) {
             throw new InvalidCallException('Getting write-only property: ' . static::class . '::' . $name);
         }
 
         throw new UnknownPropertyException('Getting unknown property: ' . static::class . '::' . $name);
     }
 
     /**
@@ -250,11 +250,11 @@
      * It is implicitly called when you use something like `$model[$offset] = $item;`.
      *
      * @param mixed $offset the offset to set element.
-     * @param mixed $item the element value.
+     * @param mixed $value the element value.
      */
-    public function offsetSet(mixed $offset, mixed $item): void
+    public function offsetSet(mixed $offset, mixed $value): void
     {
-        $this->$offset = $item;
+        $this->$offset = $value;
     }
 
     /**

tests/ActiveRecordTest.php

@@ -10,6 +10,7 @@
 use Yiisoft\ActiveRecord\Tests\Stubs\ActiveRecord\Cat;
 use Yiisoft\ActiveRecord\Tests\Stubs\ActiveRecord\Customer;
 use Yiisoft\ActiveRecord\Tests\Stubs\ActiveRecord\CustomerClosureField;
+use Yiisoft\ActiveRecord\Tests\Stubs\ActiveRecord\CustomerForArrayable;
 use Yiisoft\ActiveRecord\Tests\Stubs\ActiveRecord\CustomerWithAlias;
 use Yiisoft\ActiveRecord\Tests\Stubs\ActiveRecord\Dog;
 use Yiisoft\ActiveRecord\Tests\Stubs\ActiveRecord\Item;
@@ -763,4 +764,58 @@ public function testToArrayWithClosure(): void
             $customer->toArray(),
         );
     }
+
+    public function testToArrayForArrayable(): void
+    {
+        $this->checkFixture($this->db, 'customer', true);
+
+        $customerQuery = new ActiveQuery(CustomerForArrayable::class, $this->db);
+
+        /** @var CustomerForArrayable $customer */
+        $customer = $customerQuery->findOne(1);
+        /** @var CustomerForArrayable $customer2 */
+        $customer2 = $customerQuery->findOne(2);
+        /** @var CustomerForArrayable $customer3 */
+        $customer3 = $customerQuery->findOne(3);
+
+        $customer->setItem($customer2);
+        $customer->setItems($customer3);
+
+        $this->assertSame(
+            [
+                'id' => 1,
+                'email' => '[email protected]',
+                'name' => 'user1',
+                'address' => 'address1',
+                'status' => 'active',
+                'item' => [
+                    'id' => 2,
+                    'email' => '[email protected]',
+                    'name' => 'user2',
+                    'status' => 'active',
+                ],
+                'items' => [
+                    [
+                        'id' => 3,
+                        'email' => '[email protected]',
+                        'name' => 'user3',
+                        'status' => 'inactive',
+                    ],
+                ],
+            ],
+            $customer->toArray([
+                'id',
+                'name',
+                'email',
+                'address',
+                'status',
+                'item.id',
+                'item.name',
+                'item.email',
+                'items.0.id',
+                'items.0.name',
+                'items.0.email',
+            ]),
+        );
+    }
 }

tests/Driver/Oracle/ActiveRecordTest.php

@@ -7,6 +7,7 @@
 use Yiisoft\ActiveRecord\ActiveQuery;
 use Yiisoft\ActiveRecord\Tests\Driver\Oracle\Stubs\Customer;
 use Yiisoft\ActiveRecord\Tests\Stubs\ActiveRecord\CustomerClosureField;
+use Yiisoft\ActiveRecord\Tests\Stubs\ActiveRecord\CustomerForArrayable;
 use Yiisoft\ActiveRecord\Tests\Stubs\ActiveRecord\Type;
 use Yiisoft\ActiveRecord\Tests\Support\OracleHelper;
 
@@ -166,4 +167,58 @@ public function testToArrayWithClosure(): void
             $customer->toArray(),
         );
     }
+
+    public function testToArrayForArrayable(): void
+    {
+        $this->checkFixture($this->db, 'customer', true);
+
+        $customerQuery = new ActiveQuery(CustomerForArrayable::class, $this->db);
+
+        /** @var CustomerForArrayable $customer */
+        $customer = $customerQuery->findOne(1);
+        /** @var CustomerForArrayable $customer2 */
+        $customer2 = $customerQuery->findOne(2);
+        /** @var CustomerForArrayable $customer3 */
+        $customer3 = $customerQuery->findOne(3);
+
+        $customer->setItem($customer2);
+        $customer->setItems($customer3);
+
+        $this->assertSame(
+            [
+                'id' => 1,
+                'email' => '[email protected]',
+                'name' => 'user1',
+                'address' => 'address1',
+                'status' => 'active',
+                'item' => [
+                    'id' => 2,
+                    'email' => '[email protected]',
+                    'name' => 'user2',
+                    'status' => 'active',
+                ],
+                'items' => [
+                    [
+                        'id' => 3,
+                        'email' => '[email protected]',
+                        'name' => 'user3',
+                        'status' => 'inactive',
+                    ],
+                ],
+            ],
+            $customer->toArray([
+                'id',
+                'name',
+                'email',
+                'address',
+                'status',
+                'item.id',
+                'item.name',
+                'item.email',
+                'items.0.id',
+                'items.0.name',
+                'items.0.email',
+            ]),
+        );
+    }
 }

tests/Driver/Pgsql/ActiveRecordTest.php

@@ -12,6 +12,7 @@
 use Yiisoft\ActiveRecord\Tests\Stubs\ActiveRecord\BoolAR;
 use Yiisoft\ActiveRecord\Tests\Stubs\ActiveRecord\Customer;
 use Yiisoft\ActiveRecord\Tests\Stubs\ActiveRecord\CustomerClosureField;
+use Yiisoft\ActiveRecord\Tests\Stubs\ActiveRecord\CustomerForArrayable;
 use Yiisoft\ActiveRecord\Tests\Stubs\ActiveRecord\DefaultPk;
 use Yiisoft\ActiveRecord\Tests\Stubs\ActiveRecord\UserAR;
 use Yiisoft\ActiveRecord\Tests\Support\PgsqlHelper;
@@ -381,4 +382,58 @@ public function testToArrayWithClosure(): void
             $customer->toArray(),
         );
     }
+
+    public function testToArrayForArrayable(): void
+    {
+        $this->checkFixture($this->db, 'customer', true);
+
+        $customerQuery = new ActiveQuery(CustomerForArrayable::class, $this->db);
+
+        /** @var CustomerForArrayable $customer */
+        $customer = $customerQuery->findOne(1);
+        /** @var CustomerForArrayable $customer2 */
+        $customer2 = $customerQuery->findOne(2);
+        /** @var CustomerForArrayable $customer3 */
+        $customer3 = $customerQuery->findOne(3);
+
+        $customer->setItem($customer2);
+        $customer->setItems($customer3);
+
+        $this->assertSame(
+            [
+                'id' => 1,
+                'email' => '[email protected]',
+                'name' => 'user1',
+                'address' => 'address1',
+                'status' => 'active',
+                'item' => [
+                    'id' => 2,
+                    'email' => '[email protected]',
+                    'name' => 'user2',
+                    'status' => 'active',
+                ],
+                'items' => [
+                    [
+                        'id' => 3,
+                        'email' => '[email protected]',
+                        'name' => 'user3',
+                        'status' => 'inactive',
+                    ],
+                ],
+            ],
+            $customer->toArray([
+                'id',
+                'name',
+                'email',
+                'address',
+                'status',
+                'item.id',
+                'item.email',
+                'item.name',
+                'items.0.id',
+                'items.0.email',
+                'items.0.name',
+            ]),
+        );
+    }
 }

tests/Stubs/ActiveRecord/CustomerForArrayable.php

@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Yiisoft\ActiveRecord\Tests\Stubs\ActiveRecord;
+
+use Yiisoft\ActiveRecord\ActiveRecord;
+
+/**
+ * Class CustomerClosureField.
+ *
+ * @property int $id
+ * @property string $name
+ * @property string $email
+ * @property string $address
+ * @property int $status
+ */
+class CustomerForArrayable extends ActiveRecord
+{
+    public array $items = [];
+
+    public ?CustomerForArrayable $item = null;
+
+    public function getTableName(): string
+    {
+        return 'customer';
+    }
+
+    public function fields(): array
+    {
+        $fields = parent::fields();
+
+        $fields['item'] = 'item';
+        $fields['items'] = 'items';
+
+        return $fields;
+    }
+
+    public function setItem(self $item)
+    {
+        $this->item = $item;
+    }
+
+    public function setItems(self ...$items)
+    {
+        $this->items = $items;
+    }
+
+    public function toArray(array $fields = [], array $expand = [], bool $recursive = true): array
+    {
+        $data = parent::toArray($fields, $expand, $recursive);
+
+        $data['status'] = $this->status == 1 ? 'active' : 'inactive';
+
+        return $data;
+    }
+}