ManyToMany relations can be set with assignment

Author: phpfui

Tests/Unit/ManyToManyTest.php

@@ -6,10 +6,16 @@ class ManyToManyTest extends \PHPUnit\Framework\TestCase
 	{
 	public function testManyToMany() : void
 		{
+		$transaction = new \PHPFUI\ORM\Transaction();
 		$product = new \Tests\Fixtures\Record\Product(43);
 		$this->assertTrue($product->loaded());
 		$suppliers = $product->suppliers;
 		$this->assertCount(2, $suppliers);
 		$this->assertEquals('Supplier C', $suppliers->current()->company);
+		$supplier = new \Tests\App\Record\Supplier(10);
+		$this->assertTrue($supplier->loaded(), 'Supplier J not found');
+		$product->suppliers = $supplier;
+		$this->assertCount(3, $product->suppliers);
+		$this->assertTrue($transaction->rollBack());
 		}
 	}

docs/5. Virtual Fields.md

@@ -119,7 +119,31 @@ class Supplier extends \Tests\Fixtures\Record\Definition\Supplier
   }
 ```
 
-### Usage
+Many To Many relationships also support adding records to the relations with a simple assignment. The added record is inserted automatically and should not be previously inserted.
+
+## Morph Many
+Morph Many relationships (ala Eloquent) can be easily constructed with a junction table containing the primary keys of the two tables you want with a many to many relationship.
+
+For the Product and Employee tables to share image records, you need to add this:
+```php
+class Product extends \Tests\Fixtures\Record\Definition\Product
+  {
+  protected static array $virtualFields = [
+    'photos' => [\PHPFUI\ORM\MorphMany::class, \Tests\App\Table\Image::class, 'imagable', ],
+  ];
+  }
+
+class Employee extends \Tests\Fixtures\Record\Definition\Employee
+  {
+  protected static array $virtualFields = [
+		'photos' => [\PHPFUI\ORM\MorphMany::class, \Tests\App\Table\Image::class, 'imagable', ],
+  ];
+  }
+```
+
+Morph Many relationships also support adding records to the relations with a simple assignment. The added record is inserted automatically and should not be previously inserted.
+
+#### Usage
 ```php
 $product = new \App\Record\Product(4);
 $suppliers = $product->suppliers;

src/PHPFUI/ORM/ManyToMany.php

@@ -20,7 +20,7 @@
 class ManyToMany extends \PHPFUI\ORM\VirtualField
 	{
 	/**
-	 * @param array<string, string[]> $parameters Key is the field name, values should be **\PHPFUI\ORM\ManyToMany::class**, followed by the junction table class name, then related table class name. Two additional parameters can be specified, the order by column and sort order (defaults to ASC).
+	 * @param array<string> $parameters values are the junction table class name, then related table class name. Two additional parameters can be specified, the order by column and sort order (defaults to ASC).
 	 */
 	public function getValue(array $parameters) : \PHPFUI\ORM\RecordCursor
 		{
@@ -55,4 +55,26 @@ public function getValue(array $parameters) : \PHPFUI\ORM\RecordCursor
 
 		return $relatedTable->getRecordCursor();
 		}
+
+	/**
+	 * @param mixed $value to set
+	 * @param array<string> $parameters values are the junction table class name, then related table class name. Two additional parameters can be specified, the order by column and sort order (defaults to ASC).
+	 */
+	public function setValue(mixed $value, array $parameters) : void
+		{
+		$junctionTableClass = \array_shift($parameters);
+		$junctionTable = new $junctionTableClass();
+		$junctionRecord = clone $junctionTable->getRecord();
+
+		foreach ($this->currentRecord->getPrimaryKeys() as $key)
+			{
+			$junctionRecord->{$key} = $this->currentRecord->{$key};
+			}
+
+		foreach ($value->getPrimaryKeys() as $key)
+			{
+			$junctionRecord->{$key} = $value->{$key};
+			}
+		$junctionRecord->insert();
+		}
 	}