Документація ServBay: Керування базами даних за допомогою Adminer

Огляд

ServBay — це потужне локальне середовище веб-розробки, спеціально створене для macOS, яке об’єднує різноманітні веб-сервери, середовища виконання мов програмування та системи керування базами даних. Для зручності розробників, ServBay вже містить і налаштований Adminer — легковажний і потужний інструмент для керування базами даних. У цьому документі наведено покрокову інструкцію з підключення та керування базами даних у ServBay за допомогою Adminer.

Що таке Adminer

Adminer — це однокомпонентний інструмент для керування базами даних, написаний на PHP; він підтримує різні системи, зокрема MySQL, MariaDB, PostgreSQL, SQLite, MongoDB тощо. У порівнянні з великими клієнтами для керування базами, Adminer має переваги:

1. Легковажність й однокомпонентне розгортання: Adminer складається лише з одного PHP-файлу, не вимагає складної установки, простий у використанні й вже інтегровано у ServBay — достатньо лише почати користуватися.
2. Багатобазова підтримка: Можна працювати з різними типами баз у єдиному інтерфейсі, позбавляючись потреби встановлювати та освоювати кілька різних інструментів.
3. Зручний та інтуїтивний інтерфейс: Мінімалістичний вигляд дозволяє швидко розібратись навіть тим, хто працює з Adminer уперше.
4. Повний набір функцій: Підтримує всі базові операції — створення, редагування й видалення баз, таблиць, індексів, користувачів, виконання SQL-запитів, імпорт і експорт даних тощо.

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

Як відкрити Adminer

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

https://servbay.host/adminer.php

Переконайтеся, що додаток ServBay працює, відповідний веб-сервер (наприклад, Caddy або Nginx) ввімкнений, а потрібна служба бази даних запущена.

Підключення до баз даних у ServBay

Інтерфейс входу в Adminer інтуїтивно зрозумілий. Необхідно вибрати тип бази даних і вказати дані для підключення: адресу сервера, логін, пароль і (для деяких баз) назву бази даних. Стандартні імена користувачів та паролі для вбудованих баз можна знайти на вкладці «База даних» у додатку ServBay.

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

У ServBay зазвичай встановлено MariaDB чи MySQL. Для підключення слід обирати тип "MySQL" в Adminer.

1. Відкрийте браузер за адресою (https://servbay.host/adminer.php).
2. У вікні входу серед доступних систем оберіть MySQL.
3. Вкажіть параметри підключення:
   • Сервер: Введіть localhost або шлях до Unix Socket від ServBay /Applications/ServBay/tmp/mysql.sock. З’єднання через Socket зазвичай ефективніше.
   • Ім’я користувача: Дивіться вкладку «База даних» у додатку ServBay.
   • Пароль: Знайдіть у тій же вкладці.
   • База даних (необов’язково): Якщо потрібно відразу підключитися до конкретної бази, введіть її ім’я. Якщо залишити порожнім — підключення встановиться до сервера, і ви зможете керувати всіма базами після входу.
4. Натисніть Увійти.

Підключення до PostgreSQL

ServBay також підтримує PostgreSQL. Для підключення оберіть "PostgreSQL" в Adminer.

1. Відкрийте браузер (https://servbay.host/adminer.php).
2. У вікні входу серед систем оберіть PostgreSQL.
3. Вкажіть параметри підключення:
   • Сервер: Вкажіть /Applications/ServBay/tmp.
   • Ім’я користувача: Доступне у вкладці «База даних» у додатку ServBay.
   • Пароль: Також у вкладці «База даних».
   • База даних: Вкажіть ім’я бази (наприклад, стандартну postgres або будь-яку іншу створену вами).
4. Натисніть Увійти.

Підключення до SQLite 3

ServBay підтримує SQLite 3. Оскільки це файлова база даних, для підключення треба вказати шлях до файлу.

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

Виконання типових операцій з базами даних

Після успішного входу до сервера чи конкретної бази даних ви отримаєте доступ до інтерфейсу керування, де можна виконувати всі основні дії. Інтерфейс і можливості можуть трохи відрізнятися залежно від типу бази, але основні принципи однакові.

Створення бази даних

(Для MariaDB/MySQL, PostgreSQL)

1. Увійдіть до сервера (без вказівки конкретної бази).
2. У лівому меню чи на головній сторінці натисніть Створити базу даних чи подібне.
3. Введіть ім’я нової бази.
4. За бажанням виберіть кодування і collation (сортування).
5. Натисніть Зберегти чи Створити.

(Для SQLite 3 база створюється вже під час входу через вказання нового шляху до файлу.)

Керування таблицями та даними

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

Виконання SQL-команд

Adminer містить редактор SQL-запитів, у якому можна напряму писати та виконувати 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 Domain Socket вкажіть /Applications/ServBay/tmp (зверніть увагу: у PostgreSQL не потрібно додавати .sock у кінець).

Питання: Чим відрізняються адреса сервера й шлях до socket у MariaDB/MySQL?

Відповідь: localhost означає підключення через TCP/IP (порт 3306), а /Applications/ServBay/tmp/mysql.sock — через Unix Domain Socket. Для локального використання підключення через Socket може бути швидшим і безпечнішим. Обирайте відповідний варіант, виходячи з ваших потреб.

Питання: Чи можна в Adminer керувати базами, що не інтегровані у ServBay?

Відповідь: Adminer підтримує безліч типів баз даних. Ви можете підключитися до зовнішніх (віддалених чи локальних) баз, якщо у вас є доступ і правильні параметри підключення. Але основна мета інтеграції Adminer — зручне керування саме вбудованими у ServBay базами.

Висновок

Adminer — це універсальний і простий у використанні інструмент для керування базами даних, що поставляється із ServBay. Його легковажність, підтримка кількох типів баз і зручність спрощують роботу з MariaDB/MySQL, PostgreSQL і SQLite в локальному середовищі розробки. Дотримуючись цієї інструкції, ви легко зможете підключатися до потрібних баз через ServBay і виконувати щоденні операції з даними за допомогою Adminer.