Pesquisa de site

Instalação do phpMyAdmin no Ubuntu 24.04

Este tutorial existe para estas versões do sistema operacional

  • Ubuntu 24.04 (Nobre Numbat)
  • Ubuntu 22.04 (Jammy Medusa)
  • Ubuntu 18.04 (castor biônico)

Nesta página

  1. Pré-requisitos
  2. Configurando usuário MySQL/MariaDB
  3. Instalando o phpMyAdmin via repositório Ubuntu
  4. Protegendo a instalação do phpMyAdmin
  5. Testando sua instalação do phpMyAdmin

phpMyAdmin é uma ferramenta gratuita e de código aberto para gerenciar e administrar servidores MySQL. Ele permite que você gerencie dados MySQL a partir de um navegador da web e gerencie bancos de dados, tabelas, colunas, índices, relações, usuários, permissões, etc., a partir de uma única interface de painel em seu navegador.

Com o phpMyAdmin você pode importar e exportar dados para o servidor MySQL. Você pode importar dados CSV e SQL para seu MySQL e também exportar seus dados para vários formatos, como CSV, SQL, XML, Latex, XML, PDF e texto e planilha OpenDocument.

Este tutorial mostrará como instalar o phpMyAdmin no Ubuntu 24.04. Você instalará o phpMyAdmin e o protegerá por meio do módulo Apache basic_auth.

Pré-requisitos

Antes de prosseguir, confirme se você tem o seguinte:

  • Um servidor Ubuntu 24.04.
  • Um usuário não root com privilégios de administrador.
  • Uma pilha LAMP (Linux, Apache, MySQL/MariaDB e PHP) foi instalada.

Configurando usuário MySQL/MariaDB

Antes de instalar o phpMyAdmin, vamos criar um usuário MySQL/MariaDB dedicado para gerenciar bancos de dados via phpMyAdmin. Este usuário terá privilégios para acessar todos os bancos de dados no servidor MySQL/MariaDB, portanto certifique-se de usar uma senha forte.

Faça login em seu servidor MySQL/MariaDB com o seguinte comando 'mysql'. Digite sua senha root do MySQL/MariaDB quando solicitado.

sudo mysql -u root -p

Uma vez logado, execute as seguintes consultas para criar um novo usuário MySQL/MariaDB. Neste caso, você criará um usuário 'newuser' com a senha 'mystrongpassword'. Este usuário será utilizado para gerenciar bancos de dados via phpMyAdmin.

CREATE USER newuser@localhost IDENTIFIED BY 'mystrongpassword';
GRANT ALL PRIVILEGES ON *.* TO newuser@localhost;
FLUSH PRIVILEGES;

Agora verifique o usuário 'newuser' com a seguinte consulta. Certifique-se de que o usuário 'newuser' possa acessar todos os bancos de dados '*.*' em seu servidor MySQL/MariaDB.

SHOW GRANTS FOR newuser@localhost;

Digite quit para sair quando terminar.

Instalando o phpMyAdmin via repositório Ubuntu

No Ubuntu, o phpMyAdmin pode ser instalado de duas maneiras, através do repositório oficial do Ubuntu e manualmente a partir do código-fonte. Nesta seção, você instalará o phpMyAdmin através do repositório Ubuntu, que requer a instalação do LAMP Stack (Linux, Apache, MySQL/MariaDB).

Primeiro, atualize o índice do seu pacote Ubuntu com o seguinte comando.

sudo apt update

Verifique o pacote phpmyadmin com o seguinte comando 'apt info'.

sudo apt info phpmyadmin

Como você pode ver abaixo, o phpMyAdmin 5.2.1 está disponível no repositório Ubuntu Universe/web. o pacote phpMyAdmin exigia pacotes php-mysql e dbconfig-common para a instalação.

Agora instale o phpMyAdmin em seu servidor Ubuntu com o seguinte comando ‘apt install’. Digite Y para confirmar a instalação.

sudo apt install phpmyadmin

Selecione o servidor web padrão para 'apache2' e então OK.

Selecione Sim para confirmar o banco de dados para phpMyAdmin via dbconfig-common.

Agora insira a nova senha do usuário phpMyAdmin e repita a senha.

Repita sua senha:

Após a conclusão da instalação, a instalação do phpMyAdmin deverá estar disponível em:

  • /etc/phpmyadmin/: Este é o diretório principal de configuração do phpMyAdmin.
  • /usr/share/phpmyadmin: É aqui que o código-fonte do phpMyAdmin é armazenado.

Por último, abra seu navegador e visite http://192.168.5.30/phpmyadmin. Se a instalação for bem-sucedida, você verá a página de login do phpMyAdmin.

Faça login com o novo usuário MySQL/MariaDB que você criou e clique em Login para confirmar.

Se a sua autenticação for bem-sucedida, você deverá obter o painel do phpMyAdmin como o seguinte:

Protegendo a instalação do phpMyAdmin

Agora que você instalou o phpMyAdmin, você protegerá seu phpMyAdmin alterando o caminho de instalação padrão e implementando o módulo Apache basic_auth. Isso adicionará uma nova autenticação ao seu phpMyAdmin,

Primeiro, habilite o módulo de reescrita para o servidor web Apache com o seguinte comando.

sudo a2enmod rewrite

Abra o snippet padrão do Apache para phpMyAdmin '/etc/phpmyadmin/apache.conf' usando o seguinte editor nano.

sudo nano /etc/phpmyadmin/apache.conf

No topo da linha, altere o caminho de instalação do phpMyAdmin. Neste caso, o caminho do phpMyAdmin será alterado para '/padm'.

Alias /padm /usr/share/phpmyadmin

Adicione a opção 'AllowOverride All' à diretiva phpMyAdmin '...'. Isto permite que você substitua esta configuração de diretiva através do arquivo .htaccess.

<Directory /usr/share/phpmyadmin>
 ...
 ...
 AllowOverride All
...
...
<Directory>

quando terminar, salve o arquivo e saia do editor.

Agora crie um novo arquivo .htaccess dentro do diretório phpMyAdmin '/usr/share/phpmyadmin/' com o seguinte editor nano.

sudo nano /usr/share/phpmyadmin/.htaccess

Insira a seguinte configuração no arquivo. Com isso, você protegerá a diretiva phpMyAdmin por meio do módulo Apache basic_auth.

AuthType Basic
AuthName "Restricted Files"
AuthUserFile /etc/phpmyadmin/.htpasswd
Require valid-user

Salve o arquivo e saia do editor quando terminar.

Em seguida, execute o seguinte comando para gerar um novo arquivo de senha '/etc/phpmyadmin/.htpasswd' para autenticação básica. Neste exemplo, você criará um novo primeiro usuário 'padm'. Em seguida, insira sua senha e repita quando solicitado.

sudo htpasswd -c /etc/phpmyadmin/.htpasswd padm

Agora execute o seguinte comando para verificar sua configuração do Apache. Certifique-se de ter a sintaxe correta e você obterá a saída 'Syntax is OK'.

sudo apachectl configtest

Por último, execute o comando abaixo para reiniciar o servidor web Apache e aplicar sua nova configuração Apache.

sudo systemctl restart apache2

Testando sua instalação do phpMyAdmin

Abra seu navegador e visite a instalação do phpMyAdmin com o novo caminho, como http://192.168.5.30/padm. Se a sua configuração for bem-sucedida, será solicitada a autenticação por senha do módulo Apache basic_auth.

Insira seu usuário e senha e clique em Entrar.

Se a autenticação for bem-sucedida, você verá a página de login do phpMyAdmin. Caso contrário, você verá a página Não autorizado.

Faça login no phpMyAdmin com seu usuário e senha MySQL/MariaDB e clique em Login para confirmar.

Agora você verá que o phpMyAdmin está sendo executado no caminho personalizado '/padm'.

Agora você concluiu a instalação do phpMyAdmin no servidor Ubuntu 24.04 e protegeu o phpMyAdmin alterando a instalação padrão e implementando o módulo Apache basic-auth, que adiciona nova autenticação antes de acessar a página de login do phpMyAdmin.

Esta instalação permite acessar rapidamente o phpMyAdmin a partir de qualquer host virtual ou nome de domínio. Portanto, se o HTTPS estiver habilitado no seu nome de domínio, você também poderá acessar o phpMyAdmin via HTTPS seguro.