Add ActiveRecordInterface::relation() method (#322)

Tigrov · web-flow · commit 13fa9d30733f · 2024-05-20T13:17:00.000+07:00
diff --git a/src/AbstractActiveRecord.php b/src/AbstractActiveRecord.php
@@ -540,6 +540,15 @@ public function refresh(): bool
         return $this->refreshInternal($record);
     }
 
+    public function relation(string $name): ActiveRecordInterface|array|null
+    {
+        if (array_key_exists($name, $this->related)) {
+            return $this->related[$name];
+        }
+
+        return $this->retrieveRelation($name);
+    }
+
     public function resetRelation(string $name): void
     {
         foreach ($this->relationsDependencies as &$relationNames) {
diff --git a/src/ActiveRecordInterface.php b/src/ActiveRecordInterface.php
@@ -187,6 +187,15 @@ public function getOldPrimaryKey(bool $asArray = false): mixed;
      */
     public function getPrimaryKey(bool $asArray = false): mixed;
 
+    /**
+     * Returns the relation object with the specified name.
+     *
+     * @param string $name The relation name (case-sensitive).
+     *
+     * @return ActiveRecordInterface|array|null The relation object.
+     */
+    public function relation(string $name): self|array|null;
+
     /**
      * Returns the relation object with the specified name.
      *
