PHP、Docker、MySQLi で別の Docker コンテナ内の MariaDB に接続できない問題の解決策

2024-07-27

Docker コンテナ内で PHP を使用して、別の Docker コンテナ内の MariaDB に接続しようとすると、MYSQLI Connection refused エラーが発生することがあります。これは、ネットワーク設定や認証情報の間違いなど、いくつかの原因が考えられます。

解決策

以下の手順で、問題を解決することができます。

ネットワーク設定を確認する

MariaDB コンテナと PHP コンテナが同じ Docker ネットワークに属していることを確認してください。ネットワークが異なる場合は、docker network connect コマンドを使用して接続することができます。

docker network connect network-name container-name

認証情報を確認する

MariaDB コンテナの起動時に設定したユーザー名とパスワードが、PHP コネクションで使用されているものと一致していることを確認してください。パスワードを忘れた場合は、MariaDB コンテナ内にログインして RESET PASSWORD コマンドを実行することで、パスワードをリセットすることができます。

ポート設定を確認する

MariaDB コンテナのポート設定が、PHP コネクションで使用されているポートと一致していることを確認してください。デフォルトのポートは 3306 ですが、起動時に変更した場合は、そのポート番号を使用する必要があります。

ファイアウォールを確認する

MariaDB コンテナのファイアウォール設定が、外部からの接続を許可していることを確認してください。ファイアウォールが無効化されていない場合は、3306 ポートへのアクセスを許可する必要があります。

上記の手順で問題が解決しない場合は、以下の点も確認してみてください。

使用している PHP ライブラリと MariaDB サーバのバージョンが互換性があることを確認する
MariaDB コンテナのログを確認して、エラーメッセージがないかを確認する
docker-compose を使用している場合は、設定ファイルを確認して、ネットワーク設定とポート設定が正しいことを確認する

<?php

// データベース接続情報
$dbhost = "mysql";
$dbuser = "docker";
$dbpass = "password";
$dbname = "sample";

// データベース接続
try {
    $dbh = new PDO("mysql:host=$dbhost;dbname=$dbname", $dbuser, $dbpass);
    echo "接続成功\n";
} catch (PDOException $e) {
    echo "接続失敗: " . $e->getMessage() . "\n";
}

// データベース操作
$sql = "SELECT * FROM users";
$stmt = $dbh->query($sql);
$users = $stmt->fetchAll();

foreach ($users as $user) {
    echo "ID: " . $user['id'] . ", 名前: " . $user['name'] . "\n";
}

// データベース切断
$dbh = null;