Документация ServBay: Управление базой данных с помощью Adminer

Обзор

ServBay — это мощная локальная среда для веб-разработки, созданная специально для macOS, с интеграцией различных веб-серверов, языков программирования и систем баз данных. Для удобного управления встроенными базами данных в ServBay предустановлен и настроен Adminer — легковесный и функциональный инструмент администрирования баз данных. В этом документе вы узнаете, как использовать Adminer для подключения и управления базами данных, включёнными в ServBay.

Что такое Adminer

Adminer — это инструмент для управления базами данных в одном PHP-файле, поддерживающий множество систем, включая MySQL, MariaDB, PostgreSQL, SQLite, MongoDB и другие. В сравнении с более крупными клиентскими приложениями, Adminer обладает рядом преимуществ:

1. Легковесность и однопфайловое размещение: Adminer представлен всего одним PHP-файлом, не требует сложной установки и очень прост в развертывании. В ServBay он интегрирован и готов к использованию «из коробки».
2. Поддержка разных СУБД: Через единый интерфейс можно подключаться к разным типам баз данных, что избавляет от необходимости учить и устанавливать множество отдельных программ.
3. Простой и интуитивно понятный интерфейс: Чистый и понятный пользовательский интерфейс позволяет быстро освоиться даже тем, кто пользуется инструментом впервые.
4. Широкий функционал: Поддерживает все основные операции с базой — создание, изменение, удаление баз, таблиц, индексов, пользователей, выполнение SQL-запросов, импорт и экспорт данных и т.д.

Для разработчиков, использующих ServBay для локальной работы, Adminer становится удобным и эффективным способом управления базами данных.

Доступ к Adminer

После запуска ServBay Adminer стартует автоматически и становится доступен через встроенный веб-сервер. Для доступа используйте доменное имя по умолчанию и имя файла Adminer:

https://servbay.host/adminer.php

Убедитесь, что приложение ServBay запущено, а нужные веб-сервер (например, Caddy или Nginx) и службы баз данных активированы.

Подключение к базам данных ServBay

Страница входа в Adminer очень понятна. Вам необходимо выбрать тип базы, а также ввести адрес сервера, имя пользователя, пароль и, для некоторых СУБД, имя базы данных. ServBay автоматически создаёт стандартные логины и пароли для встроенных БД — вы их найдёте на вкладке «База данных» в приложении ServBay.

Подключение к MariaDB / MySQL

В ServBay обычно по умолчанию интегрированы MariaDB или MySQL. В Adminer обычно выбирается тип "MySQL".

1. Откройте браузер и перейдите по адресу Adminer (https://servbay.host/adminer.php).
2. На странице входа в выпадающем списке Система выберите MySQL.
3. Введите параметры подключения:
   • Сервер: укажите localhost или используйте Unix Socket путь от ServBay: /Applications/ServBay/tmp/mysql.sock. Соединение через сокет обычно эффективнее.
   • Имя пользователя: смотрите в разделе «База данных» приложения ServBay.
   • Пароль: смотрите в «База данных» приложения ServBay.
   • База данных: (по желанию) если хотите сразу подключиться к конкретной БД, введите её название. Если оставить поле пустым — войдёте на сервер и сможете управлять всеми базами данных.
4. Нажмите кнопку Войти.

Подключение к PostgreSQL

ServBay поддерживает и PostgreSQL. В Adminer требуется выбрать тип "PostgreSQL".

1. Откройте браузер и перейдите по адресу Adminer (https://servbay.host/adminer.php).
2. В списке Система выберите PostgreSQL.
3. Введите параметры подключения:
   • Сервер: введите /Applications/ServBay/tmp.
   • Имя пользователя: смотрите в разделе «База данных» приложения ServBay.
   • Пароль: смотрите в разделе «База данных» приложения ServBay.
   • База данных: введите название базы, например, стандартную postgres или другую, созданную вами.
4. Нажмите Войти.

Подключение к SQLite 3

ServBay поддерживает работу с SQLite 3. SQLite — это файловая база данных, при подключении указывается путь к файлу.

1. Откройте браузер и перейдите по адресу Adminer (https://servbay.host/adminer.php).
2. В списке Система выберите SQLite 3.
3. Укажите путь к файлу базы данных:
   • Файл базы данных: укажите полный путь к файлу SQLite. Рекомендуется хранить файл в каталоге данных ServBay, например: /Applications/ServBay/db/sqlite/your_database_name.sqlite.
   • Если введенный путь указывает на несуществующий файл, Adminer предложит создать его.
4. Нажмите Войти.

Обычные операции с базами данных

После успешного входа на сервер или в конкретную базу вы сможете выполнять через Adminer самые разные задачи по администрированию. Интерфейс и набор опций могут отличаться в зависимости от типа СУБД, но базовый порядок действий схож.

Создание базы данных

(Для MariaDB/MySQL, PostgreSQL)

1. Зайдите на сервер БД (не указывая конкретную базу).
2. Найдите в левом меню или на главной странице пункт Создать базу данных или что-то подобное.
3. Введите имя новой базы данных.
4. При необходимости укажите кодировку и сортировку.
5. Кликните Сохранить или Создать.

(В случае SQLite 3 база создаётся при входе по несуществующему пути к файлу.)

Управление таблицами и данными

1. Выберите нужную базу данных (если при входе не указана).
2. На обзорной странице найдите опцию Создать таблицу.
3. Введите имя таблицы и добавьте поля: имя, тип данных, длину, разрешена ли NULL, значение по умолчанию, индексы (PRIMARY, UNIQUE, INDEX) и т.п.
4. Кликните Сохранить для создания таблицы.
5. После создания выберите нужную таблицу в левом меню или на странице обзора.
6. Вы можете:
   • Вставить: добавить новую строку.
   • Выбрать: просматривать, искать, сортировать и фильтровать существующие данные.
   • Обновить: изменить уже имеющиеся строки.
   • Удалить: удалить выбранные строки.
   • Воспользоваться разделом SQL-команда для более сложных запросов и операций.

Выполнение SQL-команд

Adminer предоставляет отдельную форму для выполнения произвольных SQL-запросов — это позволяет гибко управлять базой и выполнять любые запросы.

1. Выберите нужную базу данных.
2. Нажмите по пункту SQL-команда.
3. Введите SQL-запрос в текстовом поле.
4. Кликните Выполнить.

Импорт и экспорт данных

Adminer поддерживает экспорт структуры и данных базы (в SQL, CSV и другие форматы), а также импорт файлов — для миграций, резервирования и обмена информацией.

1. Выберите целевую базу или таблицу.
2. Найдите пункт Экспорт или Импорт.
3. Выберите формат и другие параметры, следуя подсказкам в интерфейсе.

Удаление базы данных

(Для MariaDB/MySQL, PostgreSQL)

1. Подключитесь к серверу БД (без выбора конкретной базы).
2. В списке выберите нужную базу.
3. Нажмите Удалить и подтвердите действие. Внимание! Эта операция необратима и приведёт к безвозвратному удалению базы и всех данных.

(Для SQLite 3 база удаляется фактически удалением соответствующего файла .sqlite в файловой системе.)

Важные рекомендации

• Безопасность данных: Полученные вами логины и пароли к БД из настроек ServBay храните надёжно и не передавайте посторонним.
• Работа приложений ServBay: Adminer доступен только через встроенный веб-сервер ServBay и требует работающих БД. Если не можете попасть в Adminer или подключиться к базе — проверьте, запущены ли ServBay и сопутствующие службы (Caddy/Nginx, MariaDB/MySQL, PostgreSQL и др.).
• Права на файлы SQLite: Для файлов SQLite убедитесь, что выбран путь, доступный для чтения и записи пользователю ServBay; рекомендуется каталог /Applications/ServBay/db/sqlite/.
• Производительность: Adminer — лёгкий инструмент, но при необходимости управления очень большими БД или для сложных задач имеет смысл рассмотреть использование специализированных клиентов (TablePlus, DBeaver, pgAdmin и т.д.).

Часто задаваемые вопросы (FAQ)

В: Не удаётся открыть https://servbay.host/adminer.php. Что делать?

О: Убедитесь, что приложение ServBay запущено, и веб-сервер (обычно это Caddy или Nginx) активен. Проверьте, разрешён ли доступ к https://servbay.host в вашем браузере.

В: Забыл логин или пароль от базы. Где их посмотреть?

О: Посмотрите сгенерированные логины и пароли для каждой БД на вкладке «База данных» в интерфейсе ServBay.

В: Какой адрес сервера и порт для подключения к PostgreSQL?

О: Обычно адрес — localhost, порт по умолчанию — 5432. Посмотреть настройки можно в параметрах ServBay. Если используете Unix socket, введите /Applications/ServBay/tmp (обратите внимание: для PostgreSQL не требуется суффикс .sock).

В: В чём разница между адресом сервера и путём к сокету при подключении к MariaDB/MySQL?

О: localhost — это подключение по TCP/IP (порт 3306), а /Applications/ServBay/tmp/mysql.sock — через Unix socket. В локальной среде socket обычно чуть быстрее и безопаснее, но выбор способа остаётся за вами.

В: Могу ли я управлять внешними базами (не встроенными в ServBay) через Adminer?

О: Adminer поддерживает разные СУБД, и если вы установили стороннюю БД (например, отдельный MongoDB или удалённую базу), теоретически можно подключиться и к ним — если есть доступ и корректные параметры. Но основное удобство Adminer — быстрая работа именно с встроенными базами ServBay.

Итоги

Adminer — действительно удобный инструмент управления базами данных, предоставленный в составе ServBay. Благодаря однопфайловой архитектуре, лёгкости и поддержке разных СУБД он существенно упрощает задачи работы с MariaDB/MySQL, PostgreSQL и SQLite в локальной среде. Следуя этому руководству, вы с лёгкостью сможете подключаться к базам данных ServBay и эффективно выполнять все основные операции через Adminer.