Update December 6, 2019: Ayesh Karunaratne shared his post on fixing this issue, and clarified that PHP 7.4 does indeed support the new default MySQL password plugin. This post has been updated to correct some inaccurate information in the original post.
If you’ve tried to upgrade your Laravel applications to use MySQL 8, you might have run into the following error that left you scratching your head:
SQLSTATE[HY000]  MySQL server has gone away
The php.net manual has an explanation:
When running a PHP version before 7.1.16, or PHP 7.2 before 7.2.4, set MySQL 8 Server’s default password plugin to mysql_native_password or else you will see errors similar to The server requested authentication method unknown to the client [caching_sha2_password] even when caching_sha2_password is not used.
This is because MySQL 8 defaults to caching_sha2_password, a plugin that is not recognized by the older PHP (mysqlnd) releases. Instead, change it by setting default_authentication_plugin=mysql_native_password in my.cnf. The caching_sha2_password plugin will be supported in a future PHP release. In the meantime, the mysql_xdevapi extension does support it.
PHP 7.4 now supports
caching_sha2_password authentication, but you still might run into the above error if your database user isn’t using the new default plugin. Ayesh Karunaratne published an in-depth post on fixing this issue, you should check it out for the real fix!
However, if you’re on an older version of PHP, follow along to get MySQL 8 working with PDO:
First, we need to find the paths MySQL will look for a configuration file. We can find out by running
mysql --help. The command prints out a lot of info, but you’re looking for something like the following:
mysql --help ... Default options are read from the following files in the given order: /etc/my.cnf /etc/mysql/my.cnf /usr/local/etc/my.cnf ~/.my.cnf
Take the paths from your command output and adapt the following with the paths you get from
ls -la \ /etc/my.cnf \ /etc/mysql/my.cnf \ /usr/local/etc/my.cnf \ ~/.my.cnf ls: /etc/my.cnf: No such file or directory ls: /etc/mysql/my.cnf: No such file or directory -rw-r--r-- 1 paul staff 61 Dec 5 19:40 /Users/paul/.my.cnf -rw-r--r-- 1 paul admin 113 Oct 28 2017 /usr/local/etc/my.cnf
I like to manage the file from
~/.my.cnf, but unless you’ve previously done that, you’ll probably have to create the file if you want to manage configuration from that path.
I suggest you use the
~/.my.cnf path, but whatever path you determine you need to add the following:
If you’re using Homebrew and you want to update the
/usr/local/etc/my.cnf file, add the following at the end of the file under
# Default Homebrew MySQL server config [mysqld] # Only allow connections from localhost bind-address = 127.0.0.1 default_authentication_plugin=mysql_native_password
Last, you need to restart MySQL using whatever method is appropriate for your system. If you’re using Homebrew on a Mac, you can run
brew services restart mysql
If you’re using Docker, here’s an example Docker Compose configuration to get MySQL 8 working with Laravel and other PHP projects:
services: # ... mysql: image: mysql:8.0 # PDO Doesn't support MySQL 8 caching_sha2_password Authentication # @see https://dev.mysql.com/doc/refman/8.0/en/upgrading-from-previous-series.html#upgrade-caching-sha2-password command: --default-authentication-plugin=mysql_native_password ports: - 13306:3306 volumes: - mysql:/var/lib/mysql environment: MYSQL_DATABASE: my_database MYSQL_ROOT_PASSWORD: root volumes: mysql: driver: "local"
With that change in place, you should be able to connect to MySQL 8 from PHP applications!Filed in: News
- Senior Full-Time Laravel Developer (REMOTE)
- Senior Laravel Developer
Remote, USA & Canada Only
- Backend Software Engineer
Remote, USA Only
- Full Stack Laravel Developer (Full-time/Contract)
Remote or Columbus, OH
- Backend PHP Developer
ABOUT YOU GmbH
Join 31,000+ others and never miss out on new tips, tutorials, and more.
Statamic v3 Open Beta
The Statamic team recently launched its first open beta for v3 of the flat-file CMS and they are ready for you to giv…
NPM Package to Automate Installing the Tailwind CSS Preset
The use-tailwind-preset NPM package by Christopher Pitt is a tiny helper that installs the Tailwind Laravel preset.