Ticket #46287: wp-db-insert-ignore.patch

wp-db.php

@@ -2129 +2129 @@
         }
 
         /**
+         * Insert a row into a table ignoring errors, primarily to avoid an insert when it would conflict with an existing unique key entry.
+         *
+         *     wpdb::insert_ignore( 'table', array( 'column' => 'foo', 'field' => 'bar' ) )
+         *     wpdb::insert_ignore( 'table', array( 'column' => 'foo', 'field' => 1337 ), array( '%s', '%d' ) )
+         *
+         * @since 5.0.4
+         * @see wpdb::prepare()
+         * @see wpdb::$field_types
+         * @see wp_set_wpdb_vars()
+         *
+         * @param string       $table  Table name
+         * @param array        $data   Data to insert (in column => value pairs).
+         *                             Both $data columns and $data values should be "raw" (neither should be SQL escaped).
+         *                             Sending a null value will cause the column to be set to NULL - the corresponding format is ignored in this case.
+         * @param array|string $format Optional. An array of formats to be mapped to each of the value in $data.
+         *                             If string, that format will be used for all of the values in $data.
+         *                             A format is one of '%d', '%f', '%s' (integer, float, string).
+         *                             If omitted, all values in $data will be treated as strings unless otherwise specified in wpdb::$field_types.
+         * @return int|false The number of rows inserted, or false on error. This may be 0 so use identity operators (===, !==) to check for failure.
+         */
+        public function insert_ignore( $table, $data, $format = null ) {
+                return $this->_insert_replace_helper( $table, $data, $format, 'INSERT IGNORE' );
+        }
+
+
+        /**
          * Helper function for insert and replace.
          *
          * Runs an insert or replace query based on $type argument.
@@ -2146 +2172 @@
          *                             If string, that format will be used for all of the values in $data.
          *                             A format is one of '%d', '%f', '%s' (integer, float, string).
          *                             If omitted, all values in $data will be treated as strings unless otherwise specified in wpdb::$field_types.
-         * @param string $type         Optional. What type of operation is this? INSERT or REPLACE. Defaults to INSERT.
+         * @param string $type         Optional. What type of operation is this? INSERT, REPLACE or INSERT IGNORE. Defaults to INSERT.
          * @return int|false The number of rows affected, or false on error.
          */
         function _insert_replace_helper( $table, $data, $format = null, $type = 'INSERT' ) {
                 $this->insert_id = 0;
 
-                if ( ! in_array( strtoupper( $type ), array( 'REPLACE', 'INSERT' ) ) ) {
+                if ( ! in_array( strtoupper( $type ), array( 'INSERT', 'REPLACE', 'INSERT IGNORE' ) ) ) {
                         return false;
                 }