Как установить phpMyAdmin на CentOS

В данной инструкции рассмотрим процесс установки phpMyAdmin на CentOS версий 8 и 7.

Содержание

Установка phpMyAdmin
Установка из репозитория
Установка вручную
Установка модулей php
Настройка виртуального домена
NGINX
Apache
Проверка
Дополнительная настройка

Установка phpMyAdmin

Установка может быть выполнена из репозитория (для CentOS 7) или путем загрузки портала с сайта разработчика (CentOS 8 или CentOS 7). Рассмотрим оба варианта.

Установка из репозитория

Данный вариант доступен только для CentOS 7.

Устанавливаем расширенный репозиторий EPEL:

# yum install epel-release

Устанавливаем phpMyAdmin:

# yum install phpmyadmin

* если мы увидим ошибку «пакета с названием phpmyadmin не найдено», проверяем еще раз наличие установленного репозитория epel.

Установка вручную

Данный способ универсальный — он подходит для CentOS 8 и CentOS 7.

Устанавливаем пакеты, необходимые для скачивания и распаковки архива:

# yum install wget unzip

Переходим на сайт разработчика phpMyAdmin и копируем ссылку на нужную нам версию, например, последнюю:

Воспользовавшись скопированной ссылкой, скачиваем архив с установочными файлами:

# wget https://files.phpmyadmin.net/phpMyAdmin/4.9.1/phpMyAdmin-4.9.1-all-languages.zip

* на момент написания инструкции, последняя стабильная версия была 4.9.1.

Распаковываем скачанный архив:

# unzip phpMyAdmin-*-all-languages.zip

Создаем каталог для phpmyadmin, например:

# mkdir /usr/share/phpMyAdmin

переносим в него содержимое распакованного архива:

# mv phpMyAdmin-*-all-languages/* /usr/share/phpMyAdmin/

Задаем владельца для каталога:

# chown -R apache:apache /usr/share/phpMyAdmin

* как правило, сервис, которых обрабатываем php-запросы работает от пользователя apache.

Установка модулей php

Для корректной работы портала управления СУБД необходимо установить следующие расширения php:

# yum install php-json php-mbstring php-mysqli

* скорее всего, они уже будут установлены, если установка выполнялась из репозитория.

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

php-fpm:

# systemctl restart php-fpm

Apache:

# systemctl restart httpd

Настройка виртуального домена

Настройка виртуального домена зависит от веб-сервера, который мы используем. Разберем примеры для NGINX и Apache.

NGINX

В данном примере мы рассмотрим настройку связки NGINX + php-fpm. Также мы сконфигурируем два варианта прослушивания — виртуальный домен и с добавлением пути /phpmyadmin.

1) На отдельном домене

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

# nano /etc/nginx/conf.d/phpMyAdmin.conf

следующего содержания:

server {
        listen       80;
        server_name  phpmyadmin.it-systems.su;
        set $root_path /usr/share/phpMyAdmin;

        location / {
                root $root_path;
                index index.php;
        }

        location ~ \.php$ {
                #fastcgi_pass 127.0.0.1:9000;
                fastcgi_pass unix:/run/php-fpm/www.sock;
                fastcgi_index index.php;
                fastcgi_param SCRIPT_FILENAME $root_path$fastcgi_script_name;
                include fastcgi_params;
                fastcgi_param DOCUMENT_ROOT $root_path;
                fastcgi_read_timeout 300;
        }
}

* где:

listen — порт, на котором слушает nginx для данного домена.
server_name — домен для которого применяются настройки server. В данном примере phpmyadmin.dmosk.local.
root_path — переменная, в которую мы заносим наш путь до phpMyAdmin.
location / — настройки для запросов к серверу. В конкретном случае, мы используем root_path в качестве корневой директории для скриптов сайта; опция index нужна для поиска скрипта по умолчанию, если нет явного обращения клиентом.
location ~ \.php$ — параметры для обработки скриптов php. В нашем случае, мы обрабатываем скрипты с помощью php-fpm. Стоить обратить внимание, что последний может слушать на порту (по умолчанию, 9000) или через сокет-файл. В примере выше используется последний вариант, а способ с портом закомментирован.
fastcgi_pass — данный параметр важен и зависит от настройки php-fpm. Если последний слушает на порту, мы задаем первый вариант (который закомментирован), иначе — указываем путь до сокетного файла.

Проверяем корректность настройки nginx:

# nginx -t

если ошибок нет, перезапускаем сервис:

# systemctl restart nginx

2) С помощью location /phpmyadmin

Открываем конфигурационный файл для домена по умолчанию:

# nano /etc/nginx/conf.d/default.conf

* в вашей ситуации, файл с доменом по умолчанию может быть другим.

Добавляем location ^~ /phpmyadmin со следующими настройками:

server {
        listen       80 default_server;

        ...

        location /phpmyadmin {
            root /usr/share/;
            index index.php;
            location ~ ^/phpmyadmin/(.+\.php)$ {
                root /usr/share/;
                #fastcgi_pass 127.0.0.1:9000;
                fastcgi_pass unix:/run/php-fpm/www.sock;
                fastcgi_index index.php;
                fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
                include fastcgi_params;
                fastcgi_read_timeout 300;
            }
            location ~* ^/phpmyadmin/(.+\.(jpg|jpeg|gif|css|png|js|ico|html|xml|txt))$ {
                root /usr/share/;
            }      
        }
}

* где:

root — каталог, в котором находится каталог с phpmyadmin с порталом.
location ~ \.php$ — параметры для обработки скриптов php. В нашем случае, мы обрабатываем скрипты с помощью php-fpm. Стоить обратить внимание, что последний может слушать на порту (по умолчанию, 9000) или через сокет-файл. В примере выше используется последний вариант, а способ с портом закомментирован.
fastcgi_pass — данный параметр важен и зависит от настройки php-fpm. Если последний слушает на порту, мы задаем первый вариант (который закомментирован), иначе — указываем путь до сокетного файла.

Проверяем корректность настройки nginx:

# nginx -t

если ошибок нет, перезапускаем сервис:

# systemctl restart nginx

3) Проверка настройки php-fpm

После настройки nginx проверяем настройку php-fpm:

# nano /etc/php-fpm.d/www.conf

Так как в нашем примере мы используем подключение на основе сокетов, то настройка опции listen должна быть такой:

listen = /run/php-fpm/www.sock

* на основе порта — listen = 127.0.0.1:9000.

Если конфигурационный файл пришлось менять, перезапускаем сервис:

# systemctl restart php-fpm

Apache

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

# nano /etc/httpd/conf.d/phpMyAdmin.conf

<VirtualHost *:80>
    Define root_domain phpmyadmin.it-systems.su
    Define root_path /usr/share/phpMyAdmin

    ServerName ${root_domain}
    ServerAlias www.${root_domain}
    DocumentRoot ${root_path}

    <Directory /usr/share/phpMyAdmin>
        AllowOverride All
        Options Indexes ExecCGI FollowSymLinks
        Require all granted
    </Directory>
</VirtualHost>

Проверяем корректность настройки apache:

# apachectl configtest

и если ошибок нет, перезапускаем сервис:

# systemctl restart httpd

Проверка

Открываем браузер и переходим по адресу нашего виртуального домена — в нашем случае, http://phpmyadmin.it-systems.su/ или http://<IP-адрес нашего сервере>/phpmyadmin (если настраивали с помощью домена по умолчанию для запросов на /phpmyadmin).

Адрес phpmyadmin.it-systems.su должен разрешаться в IP-адрес с помощью DNS или локального файла hosts.

В итоге, мы должны увидеть страницу с формой ввода логина и пароля:

Необходимо ввести учетные данные для подключения к СУБД.

Дополнительная настройка

Наш phpMyAdmin работает, но не оптимально. Внесем коррекции в его конфигурационный файл.

Для начала сформируем случайную последовательность символов — их будем использовать в качестве парольной фразы:

head /dev/urandom | tr -dc A-Za-z0-9 | head -c 32 ; echo ''

После копируем полученную последовательность и создаем конфигурационный файл phpMyAdmin:

vi /usr/share/phpMyAdmin/config.inc.php

Приводим его к виду:

<?php

$cfg['blowfish_secret'] = '1IQofoKj440tR1rTcvWvwF6opgT5lsOJ';
$cfg['TempDir'] = './tmp/';

?>

* где 1IQofoKj440tR1rTcvWvwF6opgT5lsOJ — парольная фраза. ./tmp/ — путь для хранения временных файлов.

Создаем каталог для хранения временных файлов

# mkdir /usr/share/phpMyAdmin/tmp

Задаем для нее правильного владельца и права:

chown apache:apache /usr/share/phpMyAdmin/tmp

chmod 755 /usr/share/phpMyAdmin/tmp