Перейти к основному контенту

Установка phpMyAdmin на Debian 12

Введение

В данной инструкции показано, как установить phpMyAdmin на сервер с Debian 12.

Перед установкой необходимо, чтобы на сервере уже работала база данных (например MariaDB) и веб-сервер с PHP. Обычно это устанавливается в составе LAMP-стека (Linux, Apache, MariaDB, PHP).

На момент написания инструкции актуальной версией является phpMyAdmin 5.2. Перед установкой рекомендуется проверить последнюю версию на официальной странице загрузки phpMyAdmin.

Требования

Перед началом убедитесь, что установлены и работают следующие пакетыт:
Apache
PHP
MariaDB

Если этих компонентов нет, сначала необходимо установить LAMP-стек.

Установка

1. Обновление системы

Перед установкой рекомендуется обновить список пакетов и установленные программы.

apt update && apt upgrade
2. Установка необходимых PHP-модулей

Для корректной работы phpMyAdmin требуется несколько дополнительных модулей PHP.

apt install php-mbstring php-zip php-gd
3. Установка phpMyAdmin через APT

Самый простой способ установки - это использовать пакетный менеджер Debian.

apt install phpmyadmin

Во время установки появится несколько запросов конфигурации.

Выбор веб-сервера

Необходимо выбрать используемый веб-сервер.
 Выберите apache2.apache2.

изображение.png

Настройка базы данных

Появится вопрос о настройке базы данных автоматически через dbconfig-common. Выберите Yes.

Выберите Yes.изображение.png

Пароль для phpMyAdmin

После этого система попросит задать пароль для пользователя phpMyAdmin.

Введите желаемый пароль.

изображение.png

4. Установка phpMyAdmin вручную (опционально)

Если требуется установить конкретную версию phpMyAdmin, можно скачать её вручную.

Сначала перейдите на страницу загрузки phpMyAdmin и определите последнюю стабильную версию.

Затем скачайте архив:

wget https://files.phpmyadmin.net/phpMyAdmin/5.2.1/phpMyAdmin-5.2.1-all-languages.tar.gz

Распакуйте архив:

tar xvf phpMyAdmin-5.2.1-all-languages.tar.gz

Переместите каталог в директорию /usr/share:

mv phpMyAdmin-5.2.1-all-languages /usr/share/phpmyadmin

Настройка phpMyAdmin

Создайте временную директорию:

mkdir -p /var/lib/phpmyadmin/tmp

Назначьте владельцем пользователя веб-сервера:

chown -R www-data:www-data /var/lib/phpmyadmin

Создайте основной конфигурационный файл:

cp /usr/share/phpmyadmin/config.sample.inc.php /usr/share/phpmyadmin/config.inc.php

Генерация случайного ключа

Установите программу pwgen:

apt install pwgen

Сгенерируйте случайную строку:

pwgenopenssl rand -shex 32 1

Например вывода:

4A4rw39Bz5Gys5SWRrKt2RNB7GcI3qKH

54de74d47d12fe114afc1139a5292dff9ae9627b52321e917bc874d769f2a3bd

Редактирование конфигурации

Откройте конфигурационный файл:

nano /usr/share/phpmyadmin/config.inc.php

Найдите строку:

$cfg['blowfish_secret'] = '';

И вставьте сгенерированную строку:

$cfg['blowfish_secret'] = 'ВАШ_СЕКРЕТ';

изображение.png

Этот параметр используется для шифрования cookie.

Настройка таблиц хранения

В том же файле раскомментируйте раздел:

$cfg['Servers'][$i]['pmadb'] = 'phpmyadmin';
$cfg['Servers'][$i]['bookmarktable'] = 'pma__bookmark';
$cfg['Servers'][$i]['relation'] = 'pma__relation';
$cfg['Servers'][$i]['table_info'] = 'pma__table_info';
$cfg['Servers'][$i]['table_coords'] = 'pma__table_coords';
$cfg['Servers'][$i]['pdf_pages'] = 'pma__pdf_pages';
$cfg['Servers'][$i]['column_info'] = 'pma__column_info';
$cfg['Servers'][$i]['history'] = 'pma__history';
$cfg['Servers'][$i]['table_uiprefs'] = 'pma__table_uiprefs';
$cfg['Servers'][$i]['tracking'] = 'pma__tracking';
$cfg['Servers'][$i]['userconfig'] = 'pma__userconfig';
$cfg['Servers'][$i]['recent'] = 'pma__recent';
$cfg['Servers'][$i]['favorite'] = 'pma__favorite';
$cfg['Servers'][$i]['users'] = 'pma__users';
$cfg['Servers'][$i]['usergroups'] = 'pma__usergroups';
$cfg['Servers'][$i]['navigationhiding'] = 'pma__navigationhiding';
$cfg['Servers'][$i]['savedsearches'] = 'pma__savedsearches';
$cfg['Servers'][$i]['central_columns'] = 'pma__central_columns';
$cfg['Servers'][$i]['designer_settings'] = 'pma__designer_settings';
$cfg['Servers'][$i]['export_templates'] = 'pma__export_templates';

изображение.png

В конце файла добавьте строку:

$cfg['TempDir'] = '/var/lib/phpmyadmin/tmp';

изображение.png

После этого сохраните файл.

Натройка Apache

Создайте конфигурационный файл:

nano /etc/apache2/conf-available/phpmyadmin.conf

Добавьте стандартную конфигурацию phpMyAdmin (Apache Alias и настройки каталогов).

После сохранения включите конфигурацию:

a2enconf phpmyadmin.conf

Перезагрузите Apache:

systemctl reload apache2

Создание базы данных и пользователя

Для доступа к базе данных через phpMyAdmin рекомендуется использовать отдельного пользователя.

Подключитесь к MariaDB:

mariadb -u root -p

Создайте базу данных:

CREATE DATABASE myDatabase;

Создайте пользователя и назначьте ему права:

GRANT SELECT, INSERT, UPDATE, DELETE ON myDatabase.* TO 'pma_user'@'localhost' IDENTIFIED BY 'ВАШ_ПАРОЛЬ';
GRANT ALL PRIVILEGES ON myDatabase.* TO 'pma_user'@'localhost' IDENTIFIED BY 'ВАШ_ПАРОЛЬ' WITH GRANT OPTION;

Выйдите из MariaDB:

EXIT;

Проверка работы phpMyAdmin

Откройте браузер и перейдите по адресу:

http://IP_ВАШЕГО_СЕРВЕРА/phpmyadmin

Должна открыться страница авторизации phpMyAdmin.

изображение.png

Войдите, используя созданные ранее логин и пароль.

изображение.png

Заключение

После выполнения всех шагов phpMyAdmin будет установлен и готов к работе на Debian. Через веб-интерфейс вы сможете управлять базами данных MariaDB/MySQL: создавать таблицы, выполнять SQL-запросы и администрировать пользователей.