Документація ServBay: Управління базами даних через Adminer

Огляд

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

Що таке Adminer

Adminer — це одновалентний (один файл) інструмент для адміністрування баз даних, написаний на PHP, який підтримує різноманітні СУБД, включаючи MySQL, MariaDB, PostgreSQL, SQLite, MongoDB та інші. Порівняно з великими клієнтськими програмами для адміністрування баз даних, Adminer має такі ключові переваги:

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

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

Доступ до Adminer

Після запуску ServBay, Adminer автоматично стартує і стає доступним через вбудований веб-сервер. Для входу використовуйте стандартний локальний домен ServBay із додаванням імені файлу 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. Підключення через сокет часто швидше.
   • Користувач: Знайдіть імʼя користувача MariaDB/MySQL у вкладці «База даних» ServBay.
   • Пароль: Аналогічно, знайдіть пароль у ServBay.
   • База даних: (необовʼязково) Якщо потрібно відразу підʼєднати конкретну базу — вкажіть її назву; якщо залишити порожнім, після входу зможете обирати й керувати всіма базами.
4. Натисніть Вхід.

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

ServBay підтримує також PostgreSQL. В Adminer оберіть тип "PostgreSQL".

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

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

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

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 та потрібні сервіси (Caddy/Nginx, MariaDB/MySQL, PostgreSQL тощо) активні. Якщо немає доступу — перевірте роботу та налаштування.
• Шлях до SQLite: Для файлів SQLite рекомендується каталог /Applications/ServBay/db/sqlite/, що має відповідні права доступу.
• Продуктивність: Adminer ідеально підходить для невеликих чи середніх баз. Для великих чи складних задач можуть знадобитися більш спеціалізовані програми (TablePlus, DBeaver, pgAdmin тощо).

Часті запитання (FAQ)

Q: Не вдається зайти на https://servbay.host/adminer.php, що робити?

A: Переконайтеся, що ServBay працює, а веб-сервер (зазвичай Caddy або Nginx) активний. Перевірте, чи браузер дозволяє звернення до https://servbay.host.

Q: Забув/ла пароль чи імʼя користувача для бази — де їх знайти?

A: У вкладці «База даних» інтерфейсу ServBay знайдете актуальні облікові дані для кожної СУБД.

Q: Яка адреса сервера і порт для підключення PostgreSQL?

A: Зазвичай це localhost, порт — 5432. Точні параметри можна подивитись у налаштуваннях ServBay. Якщо підключаєтесь через soket — вкажіть /Applications/ServBay/tmp (без .sock для PostgreSQL).

Q: В чому різниця між адресою сервера й шляхом до soket для MariaDB/MySQL?

A: localhost — це TCP/IP з'єднання (порт 3306), /Applications/ServBay/tmp/mysql.sock — Unix Domain Socket. На локальному компʼютері сокет зазвичай швидший і безпечніший; обирайте на власний розсуд.

Q: Чи можу адмініструвати інші бази крім вбудованих у ServBay?

A: Adminer підтримує різні СУБД, тому можна підключати й зовнішні або віддалені бази (наприклад, окрему MongoDB чи хостинг). Для цього потрібно мати коректні параметри доступу й мережеву досяжність. Однак основна цінність Adminer — легке управління «внутрішніми» базами ServBay.

Підсумок

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