storageDatabasecodePHPsystem_updateUpdatelinkconnectionerrordatabase_errordangerousfatal_errorstar_halfUncommonwarningModerate

Error establishing a database connection after PHP 8.2 upgrade

The upgrade to PHP 8.2 introduces stricter type handling and removes several legacy functions. When WordPress or a plugin calls a removed function such as mysql_connect or passes null where a string is required, PHP throws a fatal error before the database connection is attempted.

Additionally, PHP 8.2 changes default settings like mysqli.allow_local_infile and may alter the socket path used by MySQL. If wp-config.php contains null values or an outdated host definition, the connection fails immediately.

Symptoms

[dashicons-warning]
White screen on front end
The site shows a blank page or the standard database connection error message.
[dashicons-admin-users]
Admin login blocked
Accessing /wp-admin/ returns the same error page.
[dashicons-admin-tools]
500 Internal Server Error
Browser dev tools report a 500 status code.

Common Causes

Removed legacy functions
Plugins or custom code still call mysql_connect or each, which no longer exist in PHP 8.2.
Strict type checking in mysqli/PDO
Passing null or an empty string for host or username triggers a TypeError.
Changed default mysqli.allow_local_infile
Import‑heavy plugins fail when the setting is false.
Incorrect DB_HOST socket path
PHP upgrade may reset the socket location, leaving wp-config.php pointing to a non‑existent file.
Need this fixed right now?

Don't waste your day debugging. Our experts can Fix your issues in under 2 hours.*

Success Rate

100% Guaranteed

Starting from

$35 /hour
99+

Trusted by Business Owners

“I spent 3 days trying to fix the Elementor loading loop. These guys fixed it in 20 minutes. Lifesavers!”

— Sarah J., Web Designer

Related Issues

contact_mail
Contact Form 7: REST API request failed: 503 Service Unavailable
A 503 Service Unavailable response stops Contact Form 7 from sending data...
apiREST APIerror503descriptioncontact-form-7
contact_mail
Contact Form 7: REST API request failed: 429 Too Many Requests

The form tries to send data through the WordPress REST API. The...

apiREST APIerrorerrorsecurityfirewalldescriptioncontact-form-7settingsserver_configuration
contact_mail
Contact Form 7: REST API request failed: 401 Unauthorized

The form tries to send data via the WordPress REST API. The...

apiREST APIadmin_panel_settingspermissionsdescriptioncontact-form-7lock401
contact_mail
Contact Form 7: File upload error: temporary directory missing

The error appears when Contact Form 7 cannot locate a writable temporary...

codePHPcloud_offupload erroradmin_panel_settingspermissionsdescriptiontemporary filedescriptioncontact-form-7
contact_mail
Contact Form 7: Mail (2) sending failed: PHP mail() function disabled

Contact Form 7 reports a failure for Mail (2) when the PHP...

codePHPerrorerrordescriptioncontact-form-7mailMailsettingsserver_configuration
contact_mail
Contact Form 7: Mail (2) sending failed: SSL certificate verification failed

Contact Form 7 reports a failure when trying to send the secondary...

errorerrorlocksslcodecURLdescriptioncontact-form-7