Laravelでプロジェクトを作って接続先DBをMariaDBに変えるまでの話

はじめに

お仕事でLaravelを使うことになり、いよいよ勉強しないといけないということで取り掛かったのだけど、DBがSQLiteのままで話が進んでいく記事がほとんどで、いろいろ戸惑ったので、最初からDBMSを切り替える手順を検証してメモ。

環境

• AlmaLinux 9.4
• Laravel v11.2.0
• MariaDB 10.5.22
• PHP 8.3 (Remi project)
  • cd /bin ; ln -s php83 php してある

MariaDBのインストール・設定

まずはおもむろにMariaDBをインストールして起動する。

dnf -y install mariadb-server
systemctl enable mariadb
systemctl start mariadb

続いて、MariaDBの接続情報（認証情報）を変更しておく。

mysql
MariaDB [(none)]> ALTER USER ‘root'@'localhost' IDENTIFIED BY '<password>’;
MariaDB [(none)]> flush privileges;
MariaDB [(none)]> \q
mysql -u root -p
password: <password>
MariaDB [(none)]> CREATE DATABASE laravel_sample;
MariaDB [(none)]> \q

そして忘れてはならないのが、PHPからMariaDBに接続するためのドライバーのインストール。

dnf -y install php83-php-mysqlnd

Laravelのサンプルプロジェクトの作成

適当にサンプルプロジェクトを作っていく。

composer create-project --prefer-dist laravel/laravel laravel-sample
cd laravel-sample
chmod -R a+w storage/
chmod a+w bootstrap/cache

そして、接続先DBの設定を変更。ここでは「.env」ファイルを編集することで設定を変更する。

vi .env
DB_CONNECTION=mariadb
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_sample
DB_USERNAME=root
DB_PASSWORD=<password>

変更が終わったら、必要な（最低限の）テーブルを作成するために以下のコマンドを実行。

php artisan migrate