Come appare il messaggio
PHP Fatal error: Uncaught Error: Call to undefined function mysqli_connect() in /var/www/example.com/db.php:4
Stack trace:
#0 /var/www/example.com/index.php(2): require()Cause frequenti
- Il pacchetto con le estensioni MySQL (
php-mysql) non è installato. - È stato installato per una versione di PHP diversa da quella che serve il sito, per esempio dopo un upgrade con più versioni affiancate.
- L'estensione è installata ma disattivata nei
conf.ddella configurazione FPM. - PHP-FPM non è stato riavviato dopo l'installazione e i worker in esecuzione non hanno ancora il modulo.
- In un container l'estensione non è mai stata inclusa nell'immagine.
Verifica
- Il PHP da CLI conosce mysqli?
php -m | grep -i mysql - Quali pacchetti PHP-MySQL sono installati?
dpkg -l | grep -E '^ii +php[0-9.]*-mysql' - Ogni binario PHP-FPM installato elenca mysqli? (è quello che usa il sito)
for f in /usr/sbin/php-fpm*; do echo "$f"; $f -m | grep -i mysqli; done - È attiva nella configurazione FPM?
ls -l /etc/php/*/fpm/conf.d/ | grep -i mysql
Soluzione
- Installa l'estensione per la versione in uso:
apt install php-mysql, oppurephp8.x-mysqlcon il nome di versione esatto del tuo FPM. - Se serve, attivala:
phpenmod mysqli. - Riavvia il servizio PHP-FPM di quella versione così i worker caricano il modulo.
- Ricontrolla con il binario PHP-FPM di quella versione:
php-fpm8.x -m | grep mysqli. - In un'immagine Docker aggiungi
docker-php-ext-install mysqlial Dockerfile e ricostruisci.
Scenario tipico
Hai aggiornato un server Ubuntu a una nuova versione che include PHP 8.3. L'applicazione prima girava con la 7.4 da un repository esterno. Installi php8.3-mysql, ma il sito mostra ancora "Call to undefined function mysqli_connect()". nginx passa ancora le richieste al vecchio socket php7.4-fpm.sock, dove l'estensione non è caricata. Controlla prima con phpinfo() dal browser quale versione di PHP serve davvero la pagina.
Domande frequenti
Perché da riga di comando funziona e dal browser no?
CLI e PHP-FPM usano configurazioni diverse e possono anche essere versioni PHP diverse. Verifica con il binario PHP-FPM, non solo con php -m.
Class mysqli not found ha la stessa causa?
Sì. Entrambi i messaggi derivano dall'estensione mysqli mancante. Per PDO vale lo stesso: could not find driver significa che manca pdo_mysql, fornito dallo stesso pacchetto.
In cosa differiscono mysqli, pdo_mysql e mysqlnd?
mysqli e pdo_mysql sono due interfacce al database, una specifica per MySQL, l'altra generica tramite PDO. mysqlnd è il driver sottostante, integrato in PHP. Su Debian e Ubuntu il pacchetto php-mysql porta tutti e tre.
Come si chiama il pacchetto su AlmaLinux, Rocky o RHEL?
Lì si chiama php-mysqlnd e contiene mysqli e pdo_mysql. Con il repository Remi è legato alla versione, per esempio php83-php-mysqlnd. Poi riavvia il servizio PHP-FPM corrispondente perché l'estensione venga caricata. Su hosting con pannello di solito attivi l'estensione nelle impostazioni PHP del dominio.
Succede lo stesso con altri database?
Sì, con lo stesso schema. Per PostgreSQL a pg_connect() manca l'estensione php-pgsql, per SQLite alla classe SQLite3 il pacchetto php-sqlite3. "Call to undefined function" indica sempre un'estensione non caricata. Il messaggio indica sempre che l'estensione corrispondente non è caricata nella versione di PHP che serve la richiesta.