Installare phpMyAdmin su Debian

In questa guida vi mostrerò come installare phpMyAdmin su Debian. Se sei su questa pagina è perchè sai cos’è phpMyAdmin. Non ti farò quindi perdere troppo tempo spiegando nel dettaglio cos’è a cosa serve phpMyAdmin.

phpMyAdmin è uno strumento di gestione di database mysql basato sul interfaccia web. Con phpMyAdmin, avrai un’alternativa, più veloce e intuitiva, alla CLI (Command line utilities) di mysql.

Indice dei contenuti

• Prerequisiti per installare phpMyAdmin su Debian
  • Verifichiamo che apache sia istallato e attivo
  • Verifichiamo PHP
  • Verifichiamo che MariaDB sia presente e attivo
• Installazione e configurazione di phpMyAdmin
• Accesso a phpMyAdmin da Browser
• Contributo video
• Conclusioni

Siamo pronti. Let’s go!

Prerequisiti per installare phpMyAdmin su Debian

Affinché si possa procedere all’installazione e alla configurazione di phpMyAdmin su Debian, è necessario che alcuni prerequisiti siano soddisfatti.

Prima di tutto, ovviamente, dobbiamo avere una macchina, che sia fisica o virtuale, su cui sia attivo un sistema operativo Debian.

E’ inoltre necessario che sul server su cui stiamo lavorando abbiamo l’accesso come root o, in alternativa, con un utente che abbia privilegi equivalenti.

E’ inoltre fondamentale avere accesso in SSH alla macchina.

Prima di procedere è utile eseguire un aggiornamento del sistema operativo:

sudo apt update

A questo punto assicuriamoci anche di avere istallato nel nostro sistema operativo wget. Qualora non fosse disponibile, potete installarlo con:

sudo apt install wget -y

Qualora vi stiate chiedendo cosa sia, wget è un’utility che consente di scaricare i file, tramite riga di comando, direttamente dalla finestra del terminale.

A questo punto dobbiamo assicurarci che siano installati sul nostro server 3 componenti:

• Apache httpd server
• PHP
• Un’istanza di mysql server (mysqld) o MariaDB

In questo articolo non entrerò nei dettagli di come istallare Apache, php e mysqld, visto che se state cercando di istallare phpMyAdmin, presumo che il vostro ambiente sia già provvisto di queste componenti. Ci saranno comunque alcuni accenni utili.

In ogni caso vi mostro come verificare che abbiate tutto l’occorrente per andare avanti.

Verifichiamo che apache sia istallato e attivo

Per verificare se un’istanza Apache httpd sta girando sul vostro server, sarà sufficiente lanciare il comando:

ps -efa | grep apache

oppure, nel caso questo comando non dia alcun output:

ps -efa | grep httpd

L’output dovrebbe essere qualcosa di simile a:

in alternativa, con l’utente proprietario del servizio apache, potete lanciare il comando:

systemctl status apache2

che dovrebbe restituirvi come output:

Se il servizio è attivo, ovvero Active (running), possiamo andare avanti.

Verifichiamo PHP

Per verificare che PHP sia istallato sulla macchina, sarà sufficiente lanciare il comando:

php -version

che vi darà un output simile a:

username@hostname:~# php -version
PHP 8.0.0 (cli) (built: Jan 13 2023 10:38:46) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.1, Copyright (c) Zend Technologies
    with Zend OPcache v8.0.0, Copyright (c), by Zend Technologies

In caso contrario, sarà necessario installare php. Vi lascio una guida per installare, per esempio, php 8.2.

Verifichiamo che MariaDB sia presente e attivo

al pari di Apache httpd, per verificare che il servizio database sia attivo, sarà sufficiente lanciare il comando:

systemctl status mariadb

dal cui output ci si aspetta qualcosa di simile a:

A questo punto siamo pronti per installare phpMyAdmin sulla nostra macchina Debian.

Installazione phpMyAdmin su Debian

A questo punto siamo pronti per scaricare e installare phpMyAdmin. Se ricordate, a inizio articolo abbiamo parlato di wget. Beh, è giunto il momento di utilizzarlo.

Collegati in SSH alla macchina e vai nella cartella /tmp e lancia il comando:

wget https://www.phpmyadmin.net/downloads/phpMyAdmin-latest-all-languages.tar.gz

Andiamo ora nella docroot di Apache http e creiamo la cartella phpmyadmin:

mkdir /var/www/html/phpmyadmin

Ora scompattiamo il file precedentemente scaricato, nella cartella che abbiamo appena creato:

sudo tar xvf phpMyAdmin-latest-all-languages.tar.gz --strip-components=1 -C /var/www/html/phpmyadmin

Creiamo il file di configurazione a partire da quello di esempio:

sudo cp /var/www/html/phpmyadmin/config.sample.inc.php /var/www/html/phpmyadmin/config.inc.php

Ora lo andiamo a editare (scegliete se con vi, vim o tramite un editor di testo) e cercate la stringa $cfg[‘blowfish_secret’] = ”; modificandola, aggiungendo, tra gli apici, una password complessa. Il risultato sarà qualcosa di simile a:

$cfg['blowfish_secret'] = '769f75f%&F865d(&RdGtdc_tTurD%$es5t43wqa45y7i';

E’ ora importante che la cartella phpmyadmin sia di proprietà dell’utente www-data (che è l’owner dei servizi httpd) e che il file modificato sia leggibile dall’utente proprietario. Dopodiché possiamo riavviare apache. Per raggiungere questi obiettivi, possiamo lanciare i tre seguenti comandi:

sudo chown -R www-data:www-data /var/www/html/phpmyadmin
sudo chmod 660 /var/www/html/phpmyadmin/config.inc.php
sudo systemctl restart apache2

Siamo pronti per verificare la nostra istallazione funzioni correttamente.

Accesso a phpMyAdmin da Browser

Non ci resta far altro che aprire un browser e digitare l’FQDN del servizio che stiamo erogando. Nel mio caso sarà https://iegri.com/phpmyadmin. Vi anticipo che se proverete a visitare la pagina, vi darà errore in quanto questo sito non usa phpmyadmin, per motivi di sicurezza.

Se proprio deciderete di usarlo e di esporlo, vi consiglio di cambiare nome alla cartella phpmyadmin con un nome strano e casuale, del tipo, phpmyadmin765ff5rfyricyrr5furuy e di proteggere la cartella con una Basic authentication. L’ideale sarebbe quello di fare in modo che la cartella di phpmyadmin sia esposta solo su localhost, oppure mettere un’ACL per fare in modo che sia accessibile soltanto dall’IP da cui vi collegate. Affronteremo il tema dell’accesso a specifici path da determinati IP in uno dei prossimi articoli.

In alternativa, potete rinominare la cartella in .phpmyadmin quando non avete necessità di utilizzarlo e ridargli il nome corretto quando ne avrete bisogno. In questo modo eviterete di esporre il database sul frontend.

Se tutto è andato a buon fine vi apparirà una schermata come questa:

Contributo video per installare phpMyAdmin su Debian

Come di consueto, vi propongo anche un contributo video da cui prendere ulteriore spunto in quanto mostra un diverso punto vi vista. Nel video infatti si va a installare phpmyadmin tramite il comando sudo app install phpmyadmin anziché andarlo a scaricare da internet. Questa procedura a me non piace molto, ma mi sembrava corretto mostrarvela per darvi più opzioni possibili.

Conclusioni

Come avete notato i passi da fare sono veramente pochi e sopratutto sono estremamente semplici.

Spero che il contenuto vi risulti utile.

Se avete dubbi o problemi, sentitevi liberi di commentare. Sarò felice di aiutarvi.

Buon lavoro

Se volete restare aggiornati, potete iscrivervi alla mia newsletter su LinkedIn.