УРОК · База данных для каталога

Таблица, строка и ключ

Опубликовано Автор: Соловьёва Мария Андреевна

Создадим файл SQLite и таблицу notes, в которую позже запишем первую заметку.

Разберём по шагам

После PHP6 страница по-прежнему берёт заметки из сессии. Теперь подготовим отдельный файл базы: в SQLite записи хранятся в таблице внутри файла. У каждой будущей строки будет свой id, название title и текст body. Пока таблица пуста; заметки из сессии не переходят в неё сами.

Слова, которые пригодятся

SQLite
База данных, которая хранится в обычном файле проекта. Здесь это data/notes.sqlite: после завершения команды файл останется на диске.
Таблица и строка
Таблица собирает однотипные записи, а строка хранит одну заметку. Таблица notes будет содержать поля id, title и body.
Первичный ключ id
Отдельный номер строки, по которому её можно найти даже после изменения названия. SQLite выдаст его новой заметке при добавлении.
PDO и pdo_sqlite
PDO — интерфейс PHP для работы с базами данных. Драйвер pdo_sqlite позволяет этому интерфейсу открывать файл SQLite; без него подключение завершится ошибкой could not find driver.

Продолжайте notes-php после PHP6. Файл public/index.php пока показывает сессионный список, а src/default-notes.php задаёт три исходные записи. Создайте папку data рядом с public и src: база останется вне публичной папки. setup.php запускается командой из корня проекта, а не адресом в браузере.

Нужен pdo_sqlite именно у той установки PHP, которая выполняет php setup.php. Команда php --ini показывает загруженный файл настроек, а php -m — расширения. Для Windows ZIP, установленного в JS7, откройте показанный php.ini (обычно рядом с php.exe), снимите ; перед extension=pdo_sqlite, сохраните Ctrl+S и снова выполните php -m. Это тот же файл настроек, где вы включали mbstring. Если сервер уже запущен, перезапустите его с тем же PHP. В примере CREATE TABLE IF NOT EXISTS создаёт таблицу один раз; title не служит ключом, потому что названия могут повторяться.

Поля пока пустой таблицы notes
Поле Что хранит Пример будущего значения
id Устойчивый номер строки 1
title Название заметки Первая страница
body Текст заметки Запомнить каркас страницы

Рабочий пример

<?php
declare(strict_types=1);
$database = __DIR__ . '/data/notes.sqlite';
$pdo = new PDO('sqlite:' . $database, null, null, [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
]);
$pdo->exec('CREATE TABLE IF NOT EXISTS notes (
    id INTEGER PRIMARY KEY,
    title TEXT NOT NULL,
    body TEXT NOT NULL
)');
echo 'Таблица notes готова: ' . $database . PHP_EOL;

Практика

Подготовьте пустую таблицу, которую следующий урок заполнит заметками. Вы увидите файл базы на диске и проверите, что повторный запуск подготовки безопасен.

  1. В Visual Studio Code откройте папку notes-php после PHP6. В её терминале выполните php --ini и php -m. Если pdo_sqlite отсутствует, в загруженном php.ini включите строку extension=pdo_sqlite по инструкции выше, сохраните файл и повторите php -m в новом запуске PHP. Не переключайтесь на другую установку PHP.
  2. В панели файлов Visual Studio Code создайте папку data в корне notes-php, рядом с public и src (или выполните здесь mkdir data). Там же создайте файл setup.php, вставьте полный пример и сохраните Ctrl+S.
  3. Из корня notes-php выполните php setup.php. Найдите сообщение «Таблица notes готова» и файл data/notes.sqlite. Повторите команду: ошибки нет, второй файл базы не появился. Страница public/index.php пока показывает прежний сессионный список.

Как проверить себя

В notes-php/data появился файл notes.sqlite, повторный запуск setup.php не выдаёт ошибку, а страница public/index.php пока продолжает показывать прежний сессионный список.

Если не получилось: Если увидели could not find driver, включите расширение pdo_sqlite в используемой PHP-среде. Ошибка unable to open database file обычно означает, что папка data не создана или недоступна для записи.

Если не получилось
  • could not find driver? Выполните php --ini и php -m в том же терминале, где запускаете setup.php. Сверьте путь к php.ini, строку extension=pdo_sqlite без ; и наличие драйвера в списке.
  • unable to open database file? Проверьте, что папка notes-php/data существует рядом с public, доступна для записи и файл не создан случайно в public/data.