Insert API - Medoo

Версія: v2.3.0

insert

Вставляє один або кілька записів у таблицю.

insert($table, $values)

table [string]
Назва таблиці.
values [array]
Дані, які потрібно вставити.

Значення, що повертається

[PDOStatement] Екземпляр PDOStatement для виконаного запиту.

$database->insert("account", [
	"user_name" => "foo",
	"email" => "foo@bar.com",
	"age" => 25
]);

Останній ідентифікатор вставки

Щоб отримати ідентифікатор вставленого рядка, викличте id() після insert().

$database->insert("account", [
	"user_name" => "foo",
	"email" => "foo@bar.com",
	"age" => 25
]);

$account_id = $database->id();

Для Oracle надайте первинний ключ як третій параметр insert().

$database->insert("ACCOUNT", [
	"NAME" => "foo"
], "ID");

$account_id = $database->id();

Серіалізація масиву

За замовчуванням значення масиву серіалізуються за допомогою serialize() перед вставленням. Ви можете використовувати [JSON], щоб зберегти їх у json_encode().

$database->insert("account", [
	"user_name" => "foo",
	"email" => "foo@bar.com",
	"age" => 25,
	"lang" => ["en", "fr", "jp", "cn"] // => \'a:4:{i:0;s:2:"en";i:1;s:2:"fr";i:2;s:2:"jp";i:3;s:2:"cn";}\'
]);

$database->insert("account", [
	"user_name" => "foo",
	"email" => "foo@bar.com",
	"age" => 25,
	"lang [JSON]" => ["en", "fr", "jp", "cn"] // => \'["en","fr","jp","cn"]\'
]);

Автоматичне визначення типу

Medoo автоматично визначає та зв’язує типи даних перед вставленням для безпечнішого та ефективнішого запису.

class Foo {
	var $bar = "cat";

	public function __wakeup()
	{
		$this->bar = "dog";
	}
}

$object_data = new Foo();

$fp = fopen($_FILES[ "file" ][ "tmp_name" ], "rb");

$database->insert("account", [
	// Рядкове значення.
	"user_name" => "foo",

	// Цілочисельне значення.
	"age" => 25,

	// Булеве значення.
	"is_locked" => true,

	// Значення масиву.
	"lang" => ["en", "fr", "jp", "cn"],

	// Значення масиву, закодоване як JSON.
	"lang [JSON]" => ["en", "fr", "jp", "cn"],

	// Значення об’єкта.
	"object_data" => $object_data,

	// Великі об’єкти (LOB).
	"image" => $fp
]);

Множинне вставлення

Ви також можете вставити кілька рядків в один виклик.

$database->insert("account", [
	[
		"user_name" => "foo",
		"email" => "foo@bar.com",
		"age" => 25,
		"city" => "New York",
		"lang [JSON]" => ["en", "fr", "jp", "cn"]
	],
	[
		"user_name" => "bar",
		"email" => "bar@foo.com",
		"age" => 14,
		"city" => "Hong Kong",
		"lang [JSON]" => ["en", "jp", "cn"]
	]
]);

PDOStatement

insert() повертає об’єкт PDOStatement, тому ви можете викликати методи PDOStatement для отримання додаткових відомостей.

$data = $database->insert("account", [
	"user_name" => "foo",
	"email" => "foo@bar.com",
	"age" => 25
]);

// Повертає кількість рядків, на які вплинув останній SQL-запит.
echo $data->rowCount();

// Довідка: https://php.net/manual/en/class.pdostatement.php

Використання функцій SQL

Для складніших сценаріїв ви можете використовувати функції SQL через raw-об’єкт. Докладніше див. на сторінці raw.

$database->insert("account", [
	"user_name" => "bar",
	"uid" => Medoo::raw("UUID()")
]);