函数

wpdb::insert( string $table, array $data, array|string $format = null )

描述

在表格中插入一行。

参数

$table，( string ) (必填) 表名。

$data，（数组）（必需）要插入的数据（在列 => 值对中）。$data 列和 $data 值都应该是“原始的”（都不应该是 SQL 转义的）。发送空值将导致列设置为 NULL，在这种情况下，相应的格式将被忽略。

$format，( array | string ) （可选） 要映射到 $data 中每个值的格式数组。如果是字符串，则该格式将用于 $data 中的所有值。格式是“%d”、“%f”、“%s”（整数、浮点数、字符串）之一。如果省略，则 $data 中的所有值都将被视为字符串，除非 wpdb::$field_types 中另有指定。

默认值：空

返回值

(int|false)插入的行数，错误时为 false。

猫斯基划重点

实际操作中，猫斯基遇到的返回值是返回插入的数据数组。

如果想返回插入的数据行的ID，则需要 return $wpdb->insert_id;

相关函数

来源

wp-includes/wp-db.php

更新日志

2.5.0 介绍。

示例

返回插入的数据行的ID。

global $wpdb;
$table = $wpdb->prefix.'you_table_name';
$data = array('column1' => 'data one', 'column2' => 123);
$format = array('%s','%d');
$wpdb->insert($table,$data,$format);
$my_id = $wpdb->insert_id;