Сервер базы и отдельный пользователь
В первом каталоге база была файлом. Теперь запустим отдельный сервер 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-каталог пока продолжит читать свой файл.
- Откройте терминал 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. - В терминале Ubuntu выполните
sudo mariadb, чтобы открыть административный SQL-клиент. В трёх строках примера замените пароль на новый локальный пароль и выполните их по порядку. ОжидайтеQuery OKпосле каждой строки. Закройте клиент командойexit, затем войдите под учебным пользователем:mariadb -h 127.0.0.1 -P 3306 -u notes_app -p notes_lab; пароль вводится после приглашения, а не в команде. - В клиенте
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-файлах.
Куда заглянуть дальше
Чтобы сохранять прогресс, войдите или зарегистрируйтесь.
Следующий материал ↗