Вставка записи в таблицу средствами PHP: обзор методов и практические примеры

Расширенные примеры вставки записей

Пример 1: вставка с проверкой существования записи

Перед вставкой полезно убедиться, что данные ещё не существуют, чтобы избежать дубликатов. Используется подзапрос или проверка через SELECT.

$pdo = new PDO('mysql:host=localhost;dbname=test;charset=utf8', 'root', '');
$email = 'user@example.com';

// Проверяем, есть ли пользователь с таким email
$check = $pdo->prepare("SELECT COUNT(*) FROM users WHERE email = :email");
$check->execute([':email' => $email]);
$exists = $check->fetchColumn();

if (!$exists) {
    $insert = $pdo->prepare("INSERT INTO users (name, email) VALUES (:name, :email)");
    $insert->execute([':name' => 'Новый', ':email' => $email]);
    echo "Добавлен пользователь с ID " . $pdo->lastInsertId();
} else {
    echo "Пользователь с таким email уже существует.";
}

Вывод: "Добавлен пользователь с ID 42" или "Пользователь с таким email уже существует."

Пример 2: пакетная вставка большого количества записей через подготовленные запросы и транзакцию

Когда нужно вставить тысячи строк, стоит использовать один подготовленный запрос и выполнять его в цикле внутри транзакции. Это значительно ускоряет операцию.

$pdo->beginTransaction();
$sql = "INSERT INTO test_table (value) VALUES (:val)";
$stmt = $pdo->prepare($sql);

for ($i = 1; $i <= 10000; $i++) {
    $stmt->execute([':val' => "Значение $i"]);
}

$pdo->commit();
echo "Вставлено 10000 записей.";

Вывод: "Вставлено 10000 записей." (время выполнения заметно меньше, чем при отдельных запросах)

Пример 3: вставка с использованием именованных параметров и автоматическим экранированием

PDO позволяет передавать массив с именованными плейсхолдерами. Экранирование выполняется автоматически.

$data = [
    'title' => "Пользовательское соглашение",
    'content' => "Текст с 'кавычками' и <тегами>",
    'date' => date('Y-m-d H:i:s')
];

$sql = "INSERT INTO articles (title, content, created_at) VALUES (:title, :content, :date)";
$stmt = $pdo->prepare($sql);
$stmt->execute($data);

Обратите внимание: специальные символы не нужно экранировать вручную, PDO делает это под капотом.

Пример 4: вставка бинарных данных (BLOB) через PDO

Для хранения изображений или файлов в базе данных используйте параметр с типом PDO::PARAM_LOB.

$image = file_get_contents('photo.jpg');

$sql = "INSERT INTO images (filename, data) VALUES (:filename, :data)";
$stmt = $pdo->prepare($sql);
$stmt->bindParam(':filename', $filename, PDO::PARAM_STR);
$stmt->bindParam(':data', $image, PDO::PARAM_LOB);
$filename = 'photo.jpg';
$stmt->execute();
echo "Изображение сохранено.";

Использование PDO::PARAM_LOB указывает, что данные могут быть большими и должны передаваться потоком.

Пример 5: вставка через хранимую процедуру

В MySQL можно заранее создать процедуру и вызывать её из PHP.

// Создание процедуры (один раз в БД)
// CREATE PROCEDURE add_user(IN p_name VARCHAR(100), IN p_email VARCHAR(100))
// BEGIN
//   INSERT INTO users (name, email) VALUES (p_name, p_email);
//   SELECT LAST_INSERT_ID() AS new_id;
// END

$stmt = $pdo->prepare("CALL add_user(:name, :email)");
$stmt->execute([':name' => 'Процедурный', ':email' => 'proc@example.com']);
$row = $stmt->fetch(PDO::FETCH_ASSOC);
echo "Новый ID: " . $row['new_id'];

Вывод: "Новый ID: 123"

Пример 6: вставка данных из CSV-файла с разбором и транзакцией

$pdo->beginTransaction();
$stmt = $pdo->prepare("INSERT INTO products (name, price) VALUES (:name, :price)");

$handle = fopen('products.csv', 'r');
fgetcsv($handle); // пропуск заголовка
while (($data = fgetcsv($handle)) !== false) {
    $stmt->execute([':name' => $data[0], ':price' => (float)$data[1]]);
}
fclose($handle);
$pdo->commit();
echo "Товары из CSV добавлены.";

Такой подход позволяет безопасно и быстро импортировать данные из внешних источников.