【Docker × Laravel】 php artisan migrateを実行すると「Access denied for user」のエラーが出る

Question

前提

Docker環境でLaravelを使って開発したいのですが、コンテナ内でphp artisan migrateを実行できない原因がわからず困っています。

こちらのハンズオン形式の記事を参考にして環境構築を進めており、「マイグレーション実行(再実行)」の箇所でエラーが発生しています。(その箇所までエラーは一切起きていません)

• https://qiita.com/ucan-lab/items/56c9dc3cf2e6762672f4

発生している問題・エラーメッセージ

dockerコンテナ内でphp artisan migrateを実行時のエラー

Illuminate\Database\QueryException 
SQLSTATE[HY000] [1045] Access denied for user '$DB_USERNAME'@'xx' (using password: NO)
後略

vendor/laravel/framework/src/Illuminate/Database/Connection.php:760
    756▕         // If an exception occurs when attempting to run a query, we'll format the error
    757▕         // message to include the bindings with SQL, which will make this exception a
    758▕         // lot more helpful to the developer instead of just the database's errors.
    759▕         catch (Exception $e) {
  ➜ 760▕             throw new QueryException(
    761▕                 $query, $this->prepareBindings($bindings), $e
    762▕             );
    763▕         }
    764▕     }

      +36 vendor frames 
  37  artisan:37
      Illuminate\Foundation\Console\Kernel::handle(Object(Symfony\Component\Console\Input\ArgvInput), Object(Symfony\Component\Console\Output\ConsoleOutput))

該当のソースコード

db:
    platform: linux/amd64
    build: ./infra/mysql
    volumes:
      - db-store:/var/lib/mysql

DB_CONNECTION=mysql
DB_HOST=db # yamlファイルの「db」に揃える
DB_PORT=3306
DB_DATABASE=DB名
DB_USERNAME=Mysqlのユーザー名
DB_PASSWORD=上記ユーザーのパスワード

現状と試したこと

現状

• コンテナは全て立ち上がっています
• webページの表示はできていますが、DBに接続ができていません

試したこと

• ハンズオン記事の通りに作業
• .envの値が間違っていないか確認
• コンテナの削除と立ち上げ直し
• laravelのcache削除
• mac M1用に yamlファイルの「db:」に platform: linux/amd64 を追加
• mysqlでユーザー作成・DBの存在をチェック

エラーメッセージで調べて出てきたことは大体実行したのですが、migrateがやはりできません。
どなたかピンと来ることがあれば何でもいいので教えていただきたいです。。。

バージョンなど

• PC: Mac M1
• docker-compose.yaml: "3.9"
• composer: 2.2.1
• php: 8.1.14
• laravel/framework: "^9.19"
• mysql 8.0
• nginx/1.20.2

Answer 1

根本的な間違いは「初心者が書いた変なブログを参考にしてること」
Laravelで絶対にやってはいけないことの筆頭。
初心者から見ると「ブログを書いてる人はきっとLaravelに詳しいんだろう」と勘違いするけどそんなことは全くなく「ブログを書いてるのも99%は初心者」
ベテランから見ると間違ったことばかり書いてる初心者で迷惑すぎる存在。

開発環境にDockerを使いたいなら公式のLaravel Sailを使う。これ以外は全部無視していい。
公式ドキュメト通りにlaravel.buildで新規プロジェクトを作ればそのまますぐsailが使えるように全部準備される。
DBが使えるように.envも自動で変更されるので自分で変更するような余計なことはしなくていい。
初心者が間違えるのは変なブログを見てしなくていい余計なことをするから。
https://laravel.com/docs/9.x/installation#laravel-and-docker

curl -s "https://laravel.build/example-app" | bash

cd example-app
 
./vendor/bin/sail up

大事なことはsailコマンドは「コンテナの外で実行」
コンテナ内では作業しない。

マイグレーションも「sailをコンテナ外で実行」すれば「コンテナ内のDBに反映される」

sail art migrate

Comments

[tiffany_rom_24]

yamlやDockerfileを自分で書くしか環境構築はできないと思い込んでいて、laravel sailを使うという発想にすらなりませんでした。
公式ドキュメント通りに作業したところエラーは起きずmigrateの実行まで行うことができました。

※公式を読みましょう、初心者の皆さん