更新日: 2015年10月11日
PHP & CakePHP

CakePHP3のDB接続でMySQLソケットのパスを設定

CakePHP 3 のチュートリアルをやっていたら、データベース（MySQL）に接続できないエラーが発生しました。原因は MySQL のソケットの場所を、config/app.php の Datasources に指定していなかったため。

ブックマークチュートリアル — CakePHP Cookbook 3.x ドキュメント

— 環境 —
CakePHP 3.1.1
PHP 5.5.19
MySQL 5.6.19
Mac OS X Yosemite

【お知らせ】英単語を画像イメージで楽に暗記できる辞書サイトを作りました。英語学習中の方は、ぜひご利用ください！

画像付き英語辞書 Imagict | 英単語をイメージで暗記
【開発記録】
英単語を画像イメージで暗記できる英語辞書サービスを作って公開しました

マイグレーションでDB接続のエラー発生

CakePHP 3 ではデフォルトでマイグレーションが使えるようになっています。Phinx というマイグレーション用ライブラリがデフォルトでバンドルされていて、Rails と同じような感じで DB のマイグレーションを行える。

Migrations — CakePHP Cookbook 3.x ドキュメント
 Phinx

それで、マイグレーションファイルを作成後、マイグレートを実行したところ以下のエラーが発生。


$ bin/cake migrations migrate

Welcome to CakePHP v3.1.0 Console
---------------------------------------------------------------
App : src
Path: /path/to/CakePHP/tutorials/bookmarker/src/
PHP : 5.5.19
---------------------------------------------------------------
using migration path /path/to/CakePHP/tutorials/bookmarker/config/Migrations

  [InvalidArgumentException]
  There was a problem connecting to the database: SQLSTATE[HY000] [2002] No such file or directory

migrate [-t|--target TARGET] [-d|--date DATE] [-p|--plugin PLUGIN] [-c|--connection CONNECTION] [-s|--source SOURCE]

$ bin/cake migrations migrate

Welcome to CakePHP v3.1.0 Console

---------------------------------------------------------------

App : src

Path: /path/to/CakePHP/tutorials/bookmarker/src/

PHP : 5.5.19

---------------------------------------------------------------

using migration path /path/to/CakePHP/tutorials/bookmarker/config/Migrations

[InvalidArgumentException]

There was a problem connecting to the database: SQLSTATE[HY000] [2002] No such file or directory


There was a problem connecting to the database: SQLSTATE[HY000] [2002] No such file or directory

There was a problem connecting to the database: SQLSTATE[HY000] [2002] No such file or directory

とエラーメッセージが出ていたので、MySQL の接続情報でどこか間違いがあるのだろうなと予測しました。まず、MySQL のDB名、ユーザー名、パスワード、ポートなどの設定に間違いがないかを確認しました。CakePHP での DB 接続情報の設定については以下参考。

Database 設定 – ブックマークチュートリアル — CakePHP Cookbook 3.x ドキュメント

config/app.php の Datasources に MySQL ソケットのパスを指定して解決

既存の DB 設定が正しいことを確認後、おそらく MySQL ソケットの読み込みがエラーの原因じゃないかと当たりを付けて、Phinx のドキュメントにあたってみました。上記の CakePHP 公式ページにはソケット指定について記述がなかったですので。

Configuration — Phinx 0.4.6 documentation

Phinx のドキュメントに unix_socket 指定の方法があったので、それを真似て config/app.php に追加して試す。

config/app.php

<?php
return [
    // ...

    'Datasources' => [
        'default' => [
            'className' => 'Cake\Database\Connection',
            'driver' => 'Cake\Database\Driver\Mysql',
            'persistent' => false,
            'host' => 'localhost',
            //'port' => 'nonstandard_port_number',
            'username' => 'username',
            'password' => 'password',
            'database' => 'cake_bookmarks',
            'encoding' => 'utf8',
            'timezone' => 'UTC',
            'cacheMetadata' => true,
            'log' => false,
            'quoteIdentifiers' => false,
            'unix_socket' => '/path/to/mysql/mysql.sock'
        ],
        // ...

<?php

return [

// ...

'Datasources' => [

'default' => [

'className' => 'Cake\Database\Connection',

'driver' => 'Cake\Database\Driver\Mysql',

'persistent' => false,

'host' => 'localhost',

//'port' => 'nonstandard_port_number',

'username' => 'username',

'password' => 'password',

'database' => 'cake_bookmarks',

'encoding' => 'utf8',

'timezone' => 'UTC',

'cacheMetadata' => true,

'log' => false,

'quoteIdentifiers' => false,

'unix_socket' => '/path/to/mysql/mysql.sock'

// ...

'unix_socket' => '/path/to/mysql/mysql.sock'

1	'unix_socket' => '/path/to/mysql/mysql.sock'

の行を追加して、MySQL のソケットのパスを指定しました。結論から言うとこれが正解で、上手く MySQL データベースに接続できるようになった。

マイグレーションやり直し

Datasources に MySQL ソケットの場所を指定した後に、もう一度マイグレーションを実行。


$ bin/cake migrations migrate

Welcome to CakePHP v3.1.0 Console
---------------------------------------------------------------
App : src
Path: /path/to/CakePHP/tutorials/bookmarker/src/
PHP : 5.5.19
---------------------------------------------------------------
using migration path /path/to/CakePHP/tutorials/bookmarker/config/Migrations
using environment default
using adapter mysql
using database cake_bookmarks

 == 20151007022746 CreateUsers: migrating
 == 20151007022746 CreateUsers: migrated 0.0242s

 == 20151007023000 CreateBookmarks: migrating
 == 20151007023000 CreateBookmarks: migrated 0.0219s

 == 20151007023018 CreateTags: migrating
 == 20151007023018 CreateTags: migrated 0.0183s

 == 20151007023029 CreateBookmarksTags: migrating
 == 20151007023029 CreateBookmarksTags: migrated 0.0198s

All Done. Took 0.1168s