Таблица notes и проверочный перенос
Создадим таблицу в notes_lab и перенесём в неё до двух настоящих строк из notes-php/data/notes.sqlite.
Разберём по шагам
После SQLite4 у таблицы notes четыре поля: id, title, body и необязательное created_at. Копирование файла .sqlite в MariaDB не переносит таблицу. Сохраните отдельный CLI-скрипт в корне notes-php: он прочитает первые две существующие заметки, создаст такую же смысловую схему в новой базе и вставит их подготовленным запросом. Новые id выдаст MariaDB; сверяем title, body и created_at. Исходный SQLite-файл и работающая страница не изменяются.
Слова, которые пригодятся
- Схема
- Описание таблиц, столбцов, типов и ограничений базы данных; здесь это четыре поля таблицы
notes. - AUTO_INCREMENT
- Выдача следующего числового id сервером при вставке строки.
- utf8mb4
- Набор символов для хранения Unicode-текста в MariaDB/MySQL.
- Перенос данных
- Создание структуры в новой базе и проверенная запись строк из SQLite, а не копирование файла другого движка.
- Транзакция
- Группа записей, которая фиксируется целиком после проверки или откатывается при ошибке.
Скрипт выполняется только в терминале и не меняет существующий src/db.php или веб-страницу. Он берёт не вымышленные демонстрационные значения, а первые две строки текущего файла SQLite. created_at из SQLite4 может быть NULL у старых записей; это отсутствие значения переносится без подстановки даты. Массовый перенос всех данных потребовал бы отдельной процедуры резервного копирования, повторного запуска и сохранения связей по id.
MariaDB выдаёт новый id через AUTO_INCREMENT, поэтому старый id здесь не копируется. VARCHAR(200) ограничивает столбец, а mb_strlen не даёт этому учебному переносу молча обрезать длинный заголовок. Проверка формы в PHP по-прежнему нужна для понятного сообщения пользователю. Транзакция группирует вставки и сверку: при ошибке вставленные строки откатываются, хотя уже созданная пустая таблица остаётся. Перед повтором проверьте её состояние.
| Свойство | SQLite в первом проекте | MariaDB в упражнении |
|---|---|---|
| Хранение | Файл data/notes.sqlite | Отдельный сервер и база notes_lab |
| Новый id | INTEGER PRIMARY KEY | BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY |
| Текст и дата | TEXT для title, body и необязательного created_at | VARCHAR(200) для title, TEXT для body и created_at, utf8mb4 |
Рабочий пример
<?php
declare(strict_types=1);
$source = __DIR__ . '/data/notes.sqlite';
if (!is_file($source)) {
fwrite(STDERR, "Нет data/notes.sqlite: выполните шаги README.
");
exit(1);
}
$drivers = PDO::getAvailableDrivers();
if (!in_array('sqlite', $drivers, true) || !in_array('mysql', $drivers, true)) {
fwrite(STDERR, "Для этого PHP нужны pdo_sqlite и pdo_mysql.
");
exit(1);
}
if (!function_exists('mb_strlen')) {
fwrite(STDERR, "Для этого PHP нужен mbstring.
");
exit(1);
}
$sqlite = new PDO('sqlite:' . $source, null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$columns = array_column($sqlite->query('PRAGMA table_info(notes)')->fetchAll(PDO::FETCH_ASSOC), 'name');
if (!in_array('created_at', $columns, true)) {
fwrite(STDERR, "Сначала выполните php migrate-created-at.php.
");
exit(1);
}
$rows = $sqlite->query('SELECT title, body, created_at FROM notes ORDER BY id LIMIT 2')
->fetchAll(PDO::FETCH_ASSOC);
if ($rows === []) {
fwrite(STDERR, "В SQLite нет строк: выполните php add-note.php.
");
exit(1);
}
foreach ($rows as $row) {
if (mb_strlen($row['title']) > 200) {
fwrite(STDERR, "Название длиннее 200 символов; выберите другие учебные строки.
");
exit(1);
}
}
fwrite(STDOUT, 'Пароль notes_app: ');
$password = rtrim((string) fgets(STDIN), "\r
");
if ($password === '') {
fwrite(STDERR, "Нужен пароль notes_app.
");
exit(1);
}
$mysql = new PDO(
'mysql:host=127.0.0.1;port=3306;dbname=notes_lab;charset=utf8mb4',
'notes_app',
$password,
[PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, PDO::ATTR_EMULATE_PREPARES => false]
);
if ($mysql->query("SHOW TABLES LIKE 'notes'")->fetchColumn() !== false) {
fwrite(STDERR, "Таблица notes уже есть: проверьте её до повторного переноса.
");
exit(1);
}
$mysql->exec('CREATE TABLE notes (
id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
title VARCHAR(200) NOT NULL,
body TEXT NOT NULL,
created_at TEXT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4');
$mysql->beginTransaction();
try {
$insert = $mysql->prepare('INSERT INTO notes (title, body, created_at)
VALUES (:title, :body, :created_at)');
foreach ($rows as $row) {
$insert->execute($row);
}
$copied = $mysql->query('SELECT title, body, created_at FROM notes ORDER BY id')
->fetchAll(PDO::FETCH_ASSOC);
if ($copied !== $rows) {
throw new RuntimeException('Перенесённые значения не совпали с SQLite');
}
$mysql->commit();
} catch (Throwable $error) {
$mysql->rollBack();
throw $error;
}
echo 'Перенесено и сверено: ' . count($rows) . PHP_EOL;
Что здесь происходит
- Проверки источника и драйверов идут до соединения и создания таблицы в
notes_lab. - CREATE TABLE создаёт четыре поля один раз; при существующей таблице скрипт останавливается до вставки.
- INSERT с параметрами переносит фактические строки, а SELECT сравнивает все три содержательных поля до фиксации транзакции.
Практика
Перенесите до двух заметок из существующего SQLite-файла в новую базу и сравните содержимое. Так вы увидите результат переноса данных до проверки отдельной записи из PHP.
- Из корня
notes-phpпроверьтеphp -mиphp -r "print_r(PDO::getAvailableDrivers());": нужныmbstring,pdo_sqliteиpdo_mysql(в списке PDO —sqliteиmysql). Если драйвераmysqlнет, найдите конфигурацию командойphp --ini, включитеpdo_mysqlдля этого CLI PHP и повторите проверку. Убедитесь, чтоdata/notes.sqliteсодержит хотя бы одну строку и полеcreated_atиз SQLite4. - В Visual Studio Code создайте файл
notes-php/bridge-copy.php, вставьте весь пример и сохранитеCtrl+S. Для установленной MariaDB оставьтеport=3306и в открытом в первом уроке терминале Ubuntu из корняnotes-phpвыполнитеphp -l bridge-copy.php, затемphp bridge-copy.php. Для Docker Desktop замените в DSN этого файла ровноport=3306наport=3307и выполните те же команды в PowerShell на Windows из корняnotes-php. Введите локальный парольnotes_app. ОжидайтеПеренесено и сверено: 1или2— по числу строк в исходной базе, но не более двух. - В SQL-клиенте пользователя
notes_appвыполнитеSHOW CREATE TABLE notes;иSELECT id, title, body, created_at FROM notes ORDER BY id;. Сравните значения с исходными строками SQLite и запишите вREADME.mdчисло перенесённых строк и отличие в выдаче новыхid, без пароля. Не запускайте импорт повторно поверх существующей таблицы.
Как проверить себя
В notes_lab есть таблица notes с четырьмя полями и до двух реальных строк SQLite; скрипт подтвердил совпадение title, body, created_at. SQLite-каталог остался работоспособным.
Если не получилось
could not find driver? Проверьте драйверы именно того CLI PHP, которым запущенbridge-copy.php; SQL-клиент не устанавливает расширения PHP.- Таблица уже существует? Выполните
SHOW CREATE TABLE notes;иSELECT COUNT(*) FROM notes;вnotes_lab. Не удаляйте её вслепую: сначала выясните, есть ли там результаты прежнего запуска. - Русский текст не совпал? Сохраните
bridge-copy.phpкак UTF-8 и проверьтеcharset=utf8mb4в DSN и определение таблицы черезSHOW CREATE TABLE notes;.
Куда заглянуть дальше
Чтобы сохранять прогресс, войдите или зарегистрируйтесь.
Следующий материал ↗