setFrom second parameter is now optional valid fields

Author: phpfui

src/PHPFUI/ORM/Record.php

@@ -492,13 +492,18 @@ public function setEmpty() : static
 	 * Sets the object to values in the array.  Invalid array values are ignored.
 	 *
 	 * @param array<string,mixed> $values
-	 *
+	 * @param array<string> $allowedFields list of allowed field names, other fields names will be ignored. Empty array updates all valid fields.
 	 * @param bool $loaded set to true if you want to simulated being loaded from the db.
 	 */
-	public function setFrom(array $values, bool $loaded = false) : static
+	public function setFrom(array $values, array $allowedFields = [], bool $loaded = false) : static
 		{
 		$this->loaded = $loaded;
 
+		if (\count($allowedFields))
+			{
+			$values = \array_intersect_key($values, \array_flip($allowedFields));
+			}
+
 		foreach ($values as $field => $value)
 			{
 			if (isset(static::$fields[$field]))

src/PHPFUI/ORM/RecordCursor.php

@@ -48,7 +48,7 @@ public function next() : void
 			}
 		else
 			{
-			$this->current->setFrom($data, true);
+			$this->current->setFrom($data, loaded:true);
 			}
 		++$this->index;
 		}

src/PHPFUI/ORM/Validator.php

@@ -32,7 +32,7 @@
  *
  * | Validator Name | Description | Parameters  |
  * | -------------- | ----------- | ----------- |
- * | alnum          | Numbers and characters only (ctype_alnum) | None |
+ * | alpha_numeric  | Numbers and characters only (ctype_alnum) | None |
  * | alpha          | Characters only (ctype_alpha) | None |
  * | bool           | Must be one or zero | None |
  * | card           | Credit card number (LUHN validation) | None |