Table::insertOrIgnore

Author: phpfui

README.md

@@ -8,7 +8,7 @@ Why another PHP ORM? In writing minimal and fast websites, it was determined tha
 ## Features
 - **Active Records** A fully type checked object interface and implement basic CRUD functionality.
 - **Active Tables** Full table operations (select, update, insert and delete) including support for where, having, limits, ordering, grouping, joins and unions.
-- **Data Cursors** Cursors implement **iterable** and **Countable** eliminating the need for full arrays read into memory.
+- **Data Cursors** Cursors implement **iterable** and **Countable** eliminating the need to read full arrays into memory.
 - **Validation** Fully customizable and translatable backend validation.
 - **Virtual Fields** Supports get and set semantics for any custom or calculated field such as Carbon dates.
 - **Migrations** Simple migrations offer atomic up and down migrations.

src/PHPFUI/ORM/Table.php

@@ -703,15 +703,29 @@ public function getWhereCondition() : \PHPFUI\ORM\Condition
 		return $this->whereCondition;
 		}
 
+	/**
+	 * Inserts current data into table or ignores duplicate key if found
+	 *
+	 * @param array<\PHPFUI\ORM\Record> $records
+	 */
+	public function insertOrIgnore(array $records) : bool
+		{
+		return $this->insert($records, 'ignore ');
+		}
+
 	/**
 	 * Mass insertion.  Does not use a transaction, so surround by a transaction if needed
 	 *
 	 * @param array<\PHPFUI\ORM\Record> $records
 	 */
-	public function insert(array $records) : bool
+	public function insert(array $records, string $ignore = '') : bool
 		{
+		if (empty($records))
+			{
+			return false;
+			}
 		$tableName = $this->getTableName();
-		$sql = "insert into `{$tableName}` (";
+		$sql = "insert {$ignore}into `{$tableName}` (";
 
 		$fields = \array_keys($this->getFields());
 		$comma = '';