УРОК · От SQLite к MariaDB/MySQL

Сервер базы и отдельный пользователь

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

В первом каталоге база была файлом. Теперь запустим отдельный сервер MariaDB и проверим вход без PHP.

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

В notes-php уже работает файл data/notes.sqlite; оставьте его и страницу каталога на месте. SQLite открывает файл из PHP, а MariaDB/MySQL работает как отдельный сервер с адресом, портом и учётной записью. В Ubuntu 24.04 установим MariaDB, создадим новую локальную учебную базу notes_lab и пользователя notes_app, не используя базу WordPress. На Windows те же команды можно выполнить в Ubuntu через WSL. В примере используется сервер MariaDB 10.11.14 и порт 127.0.0.1:3306; фактическую версию проверьте на своём сервере до следующего шага.

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

Сервер БД
Отдельная программа, которая хранит таблицы и отвечает клиентам по соединению.
Клиент
Программа, отправляющая серверу SQL-запросы; здесь это mariadb в терминале.
Порт
Часть адреса соединения; для установленного сервера здесь используется 3306, для Docker-варианта — 3307.
Учётная запись БД
Имя и пароль с правами на конкретную базу; notes_app не является root.

Команда sudo mariadb открывает клиент с правами администратора только для создания учебных объектов. Дальше используйте notes_app: ему выданы права CREATE, SELECT и INSERT лишь на notes_lab. Запись notes_app@127.0.0.1 разрешает TCP-вход с этого адреса; localhost может означать подключение через локальный сокет. Если пакет обновился, версия в выводе может быть новее 10.11.14; запишите фактическую версию. На первом шаге важен вход SQL-клиента, а наличие драйвера PHP проверяется отдельно.

Если вы предпочитаете Docker Desktop на Windows, в корне notes-php создайте исключённый из Git файл .env со строками MARIADB_RANDOM_ROOT_PASSWORD=1, MARIADB_DATABASE=notes_lab, MARIADB_USER=notes_app, MARIADB_PASSWORD=ваш_локальный_пароль. В PowerShell из этой папки после docker info запустите docker run --name notes-mariadb --env-file .env -p 127.0.0.1:3307:3306 -v notes_mariadb_data:/var/lib/mysql -d mariadb:10.11.14; дождитесь кода 0 от docker exec notes-mariadb healthcheck.sh --connect --innodb_initialized, затем войдите docker exec -it notes-mariadb mariadb -u notes_app -p notes_lab. В обоих PHP-файлах следующих уроков замените в DSN ровно port=3306 на port=3307. Выполняйте php bridge-copy.php и php db-check.php в том же PowerShell на Windows после проверки php -m: нужны pdo_sqlite, pdo_mysql, mbstring.

Docker связывает порт контейнера 3306 только с 127.0.0.1:3307 на компьютере. Именованный том notes_mariadb_data сохраняет данные между перезапусками. Сохраните .env как UTF-8 без кавычек и убедитесь командой git check-ignore .env, что файл исключён. Переменные MARIADB_* действуют при первом создании пустого тома: правка .env не меняет пароль в существующей базе. Пользователь из переменных контейнера получает широкие права только на notes_lab для учебной работы.

Два варианта локального запуска
Вариант Как проверить
Установленная MariaDB 10.11.14 в Ubuntu 24.04 Команда mariadb входит как notes_app на 127.0.0.1:3306
Docker: MariaDB в контейнере Команда docker exec открывает клиент; с компьютера адрес 127.0.0.1:3307

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

CREATE DATABASE notes_lab CHARACTER SET utf8mb4;
CREATE USER 'notes_app'@'127.0.0.1' IDENTIFIED BY 'замените_на_локальный_пароль';
GRANT CREATE, SELECT, INSERT ON notes_lab.* TO 'notes_app'@'127.0.0.1';

Что здесь происходит

  • Три SQL-строки создают только учебную базу и пользователя с правами для этой практики. Не используйте рабочую базу WordPress или её доступы.
  • Для установленного сервера SQL-клиент и PHP запускаются в одной Ubuntu, поэтому оба используют 127.0.0.1:3306. В Docker-варианте порт на компьютере — 3307; оба PHP-файла должны использовать его.
  • Успешный вход SQL-клиента ещё не подтверждает наличие pdo_mysql в том PHP, которым будут запущены файлы следующего урока.

Laravel поддерживает и SQLite. Этот мост учит работе с отдельным сервером базы перед знакомством с разными CMS и фреймворками, а не объявляет MariaDB обязательной для Laravel.

Практика

Получите отдельную учебную базу и подтвердите вход под notes_app. В следующем уроке в ней появится таблица notes; действующий SQLite-каталог пока продолжит читать свой файл.

  1. Откройте терминал Ubuntu 24.04. На Windows при отсутствии WSL установите дистрибутив командой wsl --install -d Ubuntu-24.04 в PowerShell, перезагрузитесь при запросе и завершите первоначальную настройку Ubuntu. В Ubuntu выполните sudo apt update, затем sudo apt install mariadb-server php8.3-cli php8.3-mysql php8.3-sqlite3 php8.3-mbstring и sudo service mariadb start. Выполните mariadb --version, php -v и php -m: ожидайте MariaDB, PHP 8.3, pdo_mysql, pdo_sqlite, mbstring. Имя WSL-дистрибутива узнайте через wsl --list --quiet; при запуске команд из PowerShell используйте его после wsl -d.
  2. В терминале Ubuntu выполните sudo mariadb, чтобы открыть административный SQL-клиент. В трёх строках примера замените пароль на новый локальный пароль и выполните их по порядку. Ожидайте Query OK после каждой строки. Закройте клиент командой exit, затем войдите под учебным пользователем: mariadb -h 127.0.0.1 -P 3306 -u notes_app -p notes_lab; пароль вводится после приглашения, а не в команде.
  3. В клиенте notes_app выполните SELECT VERSION(), CURRENT_USER();, затем SHOW DATABASES;. Ожидайте notes_lab и версию сервера; в данном примере это 10.11.14. Запишите в README.md версию, адрес 127.0.0.1, порт 3306, имя базы и пользователя без пароля. Если notes-php расположен на Windows, откройте PowerShell именно в его корне и выполните wsl -d Ubuntu -- pwd: путь должен указывать на ту же папку как /mnt/c/.../notes-php. Запустите wsl -d Ubuntu из этой папки; следующие PHP-команды выполняйте там. Для дистрибутива, установленного как Ubuntu-24.04, в обеих командах замените Ubuntu на Ubuntu-24.04 — точное имя показывает wsl --list --quiet.

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

Клиент входит как notes_app и имеет права записи только на учебную базу notes_lab; PHP в той же Ubuntu сможет обращаться к 127.0.0.1:3306. Пароль не находится в исходниках или README.md.

Если не получилось
  • mariadb не находится? Проверьте, что команды установки завершились в Ubuntu 24.04 и что терминал открыт именно в ней. Connection refused на 3306? Выполните sudo service mariadb status и при необходимости sudo service mariadb start.
  • Ошибка доступа для notes_app? Проверьте, что в SQL-примере пароль был заменён до выполнения и вход идёт с -h 127.0.0.1, а не через сокет без -h.
  • Docker-контейнер уже создан? Используйте docker start notes-mariadb вместо повторного docker run и дождитесь успешного healthcheck.sh. При ошибке посмотрите docker logs --tail 20 notes-mariadb только локально: в журнале может быть случайный пароль root. При непустом томе изменение .env не меняет учётные записи. Если порт 3307 занят, выберите свободный порт и замените его также в обоих PHP-файлах.

Куда заглянуть дальше