Как обновить phpMyAdmin на сервере с Linux


Тематические термины: phpMyAdmin, Linux.
phpMyAdmin может быть установлен как на веб-сервере, так и на отдельном компьютере для удаленного управления базами. Также он может быть как часть известных сбором — openserver, denwer и так далее. Его мы можем захотеть обновить по разным соображениям, чаще всего, для поддержки более новых версий СУБД mysql/mariadb. Данная инструкция демонстрируем процесс обновления для систем на базе Linux. Однако, процесс не сильно отличается для различных операционных систем.
Обновление phpMyAdmin выполняется путем замены файлов веб-приложения со старых на новые. Процедура несложная и выполняется в несколько шагов:
1. Получение информации о текущей версии
2. Поиск каталога, в котором находятся файлы приложения
3. Загрузка архива с новой версией
4. Соответствие системным требованиям
5. Резервирование текущего приложения
6. Замена файлов
Устранение ошибок, если они возникли
1. Смотрим текущую версию phpMyAdmin
Заходим на веб-интерфейс phpMyAdmin и подключаемся к базе, введя логин и пароль для самой базы. На главной странице в подразделе «phpMyAdmin» мы увидим информацию о нашем приложении, например:
* как видим, в данном примере используется версия 4.6.1, которую можно обновить до 4.8.5.
2. Ищем на сервере каталог phpMyAdmin
Проще всего воспользоваться командой find:
find / -iname "phpmyadmin*" -type d
* в данном примере мы ищем все папки, имя которых начинается на phpmyadmin.
В моем случае я получил ответ:
/var/www/phpMyAdmin
* в вашем случае команда может выдать несколько результатов — внимательнее проверяем содержимое найденного.
Также можно найти каталог с файлами phpMyAdmin, посмотрев путь в конфигурационном файле веб-сервера.
Типичные пути расположения phpMyAdmin:
- /usr/share/phpmyadmin
- /var/www/phpmyadmin
- /usr/local/www/phpmyadmin
3. Загружаем нужную версию
Переходим на сайт разработчика phpMyAdmin и копируем ссылку на нужную нам версию — в данной инструкции мы обновляем приложение до последней версии:
* на момент обновления инструкции, последняя версия была 4.9.0.1. Для рабочих сред версии alpha лучше не устанавливать.
В консоли сервера, используя скопированную ссылку, скачиваем архив:
wget https://files.phpmyadmin.net/phpMyAdmin/4.9.0.1/phpMyAdmin-4.9.0.1-all-languages.zip
* если система вернет ошибку, проверьте, что установлен пакет wget.
* мы можем также скачать архив на любой компьютер с Windows и перенести его на сервер Linux с помощью WinSCP.
Распаковываем скачанный архив:
unzip phpMyAdmin-*-all-languages.zip
* если система вернет ошибку «unzip: command not found» устанавливаем данное приложение командами apt-get install unzip или yum install unzip.
4. Изучаем системные требования к новой версии
На сайте, где мы загрузили phpMyAdmin, кликаем по его версии в левой колонке:
В открывшемся окне под описанием релиза находим информацию с требованиями к новой версии. Например, для скачанной нами версии требования «Current version compatible with PHP 5.5 to 7.2 and MySQL 5.5 and newer» — это значит, что на нашем сервере должна быть установлена PHP версии 5.5 и выше, а также MySQL 5.5. и выше.
Проверить версию php можно командой:
php -v
Проверить версию MySQL:
mysql -V
Если наш сервер не удовлетворяет требованиям веб-интерфейса управления базой данных, необходимо либо обновить PHP/MySQL, либо выбрать менее свежую версию phpMyAdmin.
5. Сохраняем файлы текущего приложения
Перед тем, как заменить приложение новыми файлами, переносим текущее в новый каталог. Это необходимо как для сохранения конфигурационного файла, так и для получения резерва на случай, если новое приложение заработает со сбоями.
Для переноса приложения используем команду mv:
mv /var/www/phpMyAdmin /var/www/old.phpMyAdmin
* где /var/www/phpMyAdmin — путь, который мы определили на шаге 2.
6. Заменяем файлы
Переносим содержимое ранее загруженного и распакованного архива в каталог по старому пути, где располагалась предыдущая версия веб-приложения:
mv phpMyAdmin-4.8.5-all-languages /var/www/phpMyAdmin
Задаем владельца на каталог.
а) если используем CentOS / Red Hat / Fedora:
chown -R apache:apache /var/www/phpMyAdmin
а) если используем Ubuntu / Debian:
chown -R www-data:www-data /var/www/phpMyAdmin
Возвращаем конфигурационный файл:
cp /var/www/old.phpMyAdmin/config.inc.php /var/www/phpMyAdmin/
phpMyAdmin обновлен.
Возможные проблемы
1. Ошибка при обработке запроса, код 200, parsererror (rejected)
Появляется во всплывающем окне сразу после входа в базу. Дополнительно сообщение: «Похоже соединение с сервером потеряно. Проверьте сетевое подключение и статус сервера.»
Причина: предыдущие сессии могут храниться на сервере. Когда мы подключаемся к базе, к которой ранее подключались со старого phpMyAdmin, приложение безуспешно пытается их использовать.
Решение: просто обновляем в браузере страницу и заходим в базу повторно.
2. Секретная парольная фраза в конфигурации (blowfish_secret) слишком короткая
Предупреждение может появиться снизу на страницах приложения.
Причина: в более новых версиях может потребоваться использовать более стойкую парольную фразу. Она задается в конфигурационном файле, который мы перенесли со старой версии.
Решение: меняем парольную фразу. Сначала генерируем ее командой:
head /dev/urandom | tr -dc A-Za-z0-9 | head -c 32 ; echo ''
После открываем конфигурационный файл:
vi /var/www/phpMyAdmin/config.inc.php
И редактируем строку:
$cfg['blowfish_secret'] = 'NiYR7z886zou9C50UczXL7zRp2Pg5sRC';