メインコンテンツへスキップ
見出し画像
Photo byasahikigyou

Laragonでデータベースに繋がらない ── エラー10061の正体は、拍子抜けするほど単純でした

    久しぶりにLaragonを立ち上げた

    XAMPPの代わりにLaragonを使っている方は、それなりにいるのではないかと思います。私もその一人です。

    Laragonの良いところは、Apacheだけでなく Nginx(エンジンエックス)を選べる点でした。当時の私は「Nginxとは結局何なのか」がまるで分かっていなかったので、解説サイトを読みながら実際に立てて壊してを繰り返す教材として、この環境がちょうど良かったのです。

    先日、久しぶりにLaragonを起動して、Nginxのサーバーを立てました。ここまでは問題ありませんでした。ところが、本当に使いたかったのは MariaDB のほうで、こちらで完全に止まりました。

    Laragonでは「Database」ボタンから HeidiSQL というセッションマネージャーが立ち上がり、そこでセッションを新規登録して、実際のデータベースを作成します。流れ自体は覚えていました。しかし、セッションを開こうとした瞬間に弾かれたのです。

    難所① エラー10061が出る

    表示されたのは、こういう類のメッセージです。

    Can't connect to MySQL server on 'localhost' (10061)

    10061は、噛み砕けば「指定された宛先で待ち受けているサーバーが見当たりません」という意味です。ホスト名も合っている、ポートも合っている、それでも開けない。

    エラーメッセージ自体は原因を正確に述べているのですが、初めて見ると、まず疑うのは自分が入力した設定値のほうです。私もセッションの設定画面を何度も開き直しました。

    難所② 検索結果が、自分の記憶と噛み合わない

    そこでWebを検索しました。ところが出てくるのは英語の記事が中心で、内容も

    • Windowsサービスの一覧を開いて、MySQLのサービスを手動で起動しろ

    • SSHトンネルの設定を見直せ、接続方式は何を使っているのか

    といったものばかりでした。

    読みながら、ずっと違和感がありました。Laragonを使っていた当時、私はそんな操作を一度もしていないからです。Windowsのサービス画面など開いた記憶がありません。

    これは検索の落とし穴だと思います。エラーコードで検索すると、そのコードが出うるあらゆる環境の記事が並びます。素のMySQLをWindowsに直接入れた人、リモートサーバーに繋いでいる人、Dockerの人。Laragonという前提が抜けた解決策を、そのまま自分の環境に持ち込もうとしていたわけです。

    難所③ どこが原因なのか切り分けられない

    初心者がここで詰まる理由は、はっきりしています。接続画面に並んだ項目のうち、どれが犯人か分からないからです。

    • ネットワーク種別が違うのか

    • ホスト名は `localhost` でいいのか、`127.0.0.1` にすべきなのか

    • ポート番号が違うのか

    • ユーザー名とパスワードが違うのか

    どれも「間違っていれば接続できない」項目なので、片っ端から書き換えては試す、という不毛な作業に入ってしまいます。私もしばらくそれをやりました。

    転換 ── HeidiSQLは「繋ぐ道具」であって「起こす道具」ではない

    結論から言うと、原因は接続設定ではありませんでした。

    Laragon側でデータベースを起動していなかった、それだけです。

    考えてみれば当たり前の話です。HeidiSQLは、すでに動いているデータベースサーバーに接続しにいくクライアントであって、サーバーを起動する機能は持っていません。停止しているサーバーに向かって正しい設定で接続しても、返ってくるのは10061です。

    そして10061は、まさにそう言っていたのです。「設定が違う」ではなく「そこに誰もいない」と。

    Windowsサービスを触る必要も、SSHの設定を見直す必要もありませんでした。単に、手順を守れば起きない問題でした。

    結論 ── 手順として覚えてしまう

    忘れてもまた同じ場所で転ばないよう、順番として固定しておきます。

    1. HeidiSQLを閉じて、Laragonのメイン画面に戻る

    2. 左下の起動ボタンを押す(押すと表示が「停止」に切り替わります。この状態が起動中です)

    3. 設定したデータベースが起動していることを確認する

    4. 「Database」ボタンを押してHeidiSQLを開く

    5. 作成済みのセッションを選び、ホスト名(多くの場合 `localhost`)とポートが正しいことを確認して「開く」

    6. テーブル一覧の画面が表示されたら接続成功です

    7. データベースを新規作成する(左のツリーで右クリック → 新規作成 → データベース。照合順序は迷ったら `utf8mb4_general_ci`)

    8. ユーザーにパスワードを割り当てる場合は、ツール → ユーザーマネージャーから対象ユーザーを選んで設定します

    ポイントは1と2です。先にサーバーを走らせる。これだけで10061は出ません。

    画像
    httpとDBサーバーを走らせておくのを忘れずに
    画像

    PostgreSQLを使う場合の注意

    同じ感覚でPostgreSQLを繋ごうとすると、別の壁があります。HeidiSQLのPostgreSQL対応は正式なものではないため、ユーザー管理まわりが正常に動作しないことがあります。接続はできてもパスワード設定でつまずくようなら、それはあなたの設定ミスではなく、対応範囲の問題です。pgAdminなど、PostgreSQL側の純正ツールに切り替えるほうが早いです。

    そもそもDockerでいいのでは、という話

    正直に書くと、この手の環境はDockerであれば一発で立ち上がります。「サーバーが動いていないから繋がらない」という今回のような状態自体が起きにくい。安定を取るならDockerをお勧めします。

    ただ、Laragonには手で操作している感覚があります。何を起動し、何に接続しているのかが目に見えるので、仕組みを理解する段階の教材としては悪くありません。私がNginxを覚えたのも、まさにこの環境でした。

    それに、ちょっとしたものを試すたびにコンテナを用意するのは、正直やや大げさです。Laragonを立ち上げて、ドキュメントルートだけ設定して動作確認する。その手軽さは、今でも十分に使いどころがあります。

    同じところで止まってしまった方、私と同じように手順を忘れてしまった方の、参考になれば幸いです。

     
     
    会社員をしながら20年近く、PHPとMySQLを中心にサンデープログラムをしてきました。 最初に勉強したのはBasic(もう忘れました)、そしてJavaScript, Perl, PHPとWeb系アプリが中心です。

    あなたへのおすすめ