権限が閉じた MySQL のデータディレクトリにある CA 証明書は Web の PHP から読めず、プロジェクトの中に置くと読めることを示す図

【Laravel】SSL 接続が落ちる原因は CA 証明書の置き場所

今回は Laravel から MySQL に SSL 接続したら、マイグレーションは通るのに Web だけ failed loading cafile stream で落ちた話です。原因は CA 証明書の置き場所。直し方を解説します!

権限が閉じた MySQL のデータディレクトリにある CA 証明書は Web の PHP から読めず、プロジェクトの中に置くと読めることを示す図

こんにちは。ダタク @iQeeeda です。

自分で立てたサーバの MySQL に Laravel から SSL でつなごうとしました。
そこで出たのがこのエラーです。

PDOException: failed loading cafile stream

php artisan migrate は通ります。なのにブラウザから開くと接続エラー。
解決するまで 6 時間以上かかりました。

結論: CA 証明書は Web の実行ユーザが読める場所に置く

先に結論です。

  • failed loading cafile stream は PHP が証明書のファイルを開けなかったという警告
  • 僕は証明書を MySQL のデータディレクトリ /var/lib/mysql から直接読ませていた
  • /var/lib/mysql は MySQL サーバの実行ユーザ以外に読ませないのが公式の指針
  • artisan はターミナルのユーザ、Web の PHP は別のユーザで動く。読める側だけ通っていた
  • 証明書をプロジェクト内に置き、config/database.php の参照先をそちらに変える

今回は「Laravel の SSL 接続が Web だけ失敗する原因」という話をします。
それでは解説していきます。

failed loading cafile stream は「ファイルを開けなかった」

OpenSSL の読み込みが失敗したあと PHP が同じパスのファイルを開き直し、それも開けないと警告が出る流れの図

このエラーは証明書の中身が悪いときではなく、ファイルそのものを開けなかったときに出ます。

Laravel の DB 設定で CA 証明書のパスを渡すオプションが Pdo\Mysql::ATTR_SSL_CA (旧 PDO::MYSQL_ATTR_SSL_CA。PHP 8.5 で非推奨) です。
PHP の公式マニュアル では「SSL 認証局のファイルパス」と説明されています。

PHP はこのパスを SSL 接続の cafile として OpenSSL に渡します。cafile は接続先のサーバを検証するための CA (認証局) 証明書です。

警告を出しているのは PHP 本体のコード

場所は ext/openssl/xp_ssl.c にある CA 読み込み用の関数 php_openssl_load_stream_cafile です (リンク先は PHP 8.1.0 ですが、現行の master でも同じ文言です)。
サーバ証明書の検証を有効化するとき、OpenSSL 側での読み込みが失敗すると PHP が同じパスのファイルを自分で開き直します。それも開けなかったときにこのエラーになります。

stream = php_stream_open_wrapper(cafile, "rb", 0, NULL);

if (stream == NULL) {
    // ...
    php_error(E_WARNING, "failed loading cafile stream: `%s'", cafile);
    return 0;
}

つまりこの警告の意味は、「この PHP プロセスからはそのファイルを開けない」です。
僕の環境では PDOException のメッセージにこの文言が出てきましたが、環境によっては表示されず SQLSTATE[HY000] [2002] のような接続エラーになることもあります。

まず疑うのは 2 つです。

  • パスにファイルが無い
  • ファイルはあるが、この PHP プロセスに読む権限が無い

僕の場合は同じパスでマイグレーションが通っていたので、ファイルの場所自体は合っていました。疑うべきは権限のほうです。

artisan は通るのに Web が落ちるのは実行ユーザが違うから

同じ証明書のパスを、ターミナルのユーザは読めて Web の PHP のユーザは読めないことを示す図

マイグレーションは通るのに Web だけ落ちる。
この食い違いのせいでどこを疑えばいいのか分からず、6 時間以上悩みました。

ターミナルと Web では PHP を動かすユーザが違う

  • artisan: ターミナルにログインしているユーザで動く
  • Web: Web サーバ側の PHP (PHP-FPM など) の実行ユーザで動く

PHP-FPM なら設定ファイルの user に指定したアカウントが使われ、 公式の設定例 では www-data です。

たとえば root や sudo など権限の強いユーザで artisan を叩いていれば読める場所でも、www-data のような Web 側の実行ユーザからは読めないことがあります。

僕のケースでも、マイグレーションが通ったのは Web から読める配置だったからではなく、ターミナル側のユーザに読む権限があったからだと思います。

MySQL のデータディレクトリは Web などの他ユーザに読ませないのが指針

/var/lib/mysql が mysql ユーザ所有の 700 になっている環境では、中の ca.pem は 644 でも www-data がディレクトリの入口で止まることを示す図

僕が指していた証明書は /var/lib/mysql の中にありました。
MySQL がデータを置くディレクトリ (データディレクトリ) で、Ubuntu 22.04 の apt 版では既定の場所がここです。

ca.pem は MySQL がデータディレクトリに自動生成する

MySQL 8.4 のリファレンス によると、SSL の設定を何もしていなければ、起動時に CA 証明書 (ca.pem) などをデータディレクトリへ自動生成します (auto_generate_certs は既定で有効)。
証明書のファイル自体は 644 で、誰でも読める権限です。

閉じているのはファイルではなくディレクトリ

ディレクトリ側が閉じていると、中のファイルが 644 でも Web からは読めません。
MySQL 8.4 のセキュリティの章 にも、データディレクトリを読み書きできる Unix ユーザは mysqld (MySQL サーバ本体) の実行ユーザだけに絞るよう書かれています。
この Ubuntu 環境ではそれが mysql ユーザです。

Make sure that the only Unix user account with read or write privileges in the database directories is the account that is used for running mysqld.

2026 年 10 月に Ubuntu 22.04 標準の apt パッケージ (MySQL 8.0) で確認したところ、実際に 700 で閉じていました。データディレクトリに ca.pem があり、auto_generate_certs も ON です。現行の MySQL 8.4 でも、公式リファレンス上の自動生成と権限の指針は同じです。

# データディレクトリは mysql ユーザ所有で、他ユーザは入れない (700)
ls -ld /var/lib/mysql
drwx------ 7 mysql mysql 4096 Oct  7 01:28 /var/lib/mysql

# 中の証明書は 644 なのに、www-data からは開けない
su -s /bin/sh www-data -c "cat /var/lib/mysql/ca.pem"
cat: /var/lib/mysql/ca.pem: Permission denied

だから www-data の PHP は 644 の証明書にたどり着く前に、ディレクトリの入口で止まります。

Ubuntu 環境で root と www-data から PDO 接続を試すと

同じ Ubuntu 22.04 環境 (PHP 8.1) で、PDO::MYSQL_ATTR_SSL_CA に証明書のパスを渡して接続を試した結果です。
接続先の検証を通すため、接続先ホスト名 (CN) を 127.0.0.1 にした CA とサーバ証明書を自前で作って MySQL に設定しました。その CA 証明書を自動生成の ca.pem と同じ 644 の権限で /var/lib/mysql に置いて検証しました。

  • root + /var/lib/mysql の中の証明書: つながる (root は権限の制限を受けない)
  • www-data + 同じパス: 接続失敗 (この環境では SQLSTATE[HY000] [2002] が返った)
  • www-data + プロジェクト側に置いた同じ証明書: つながる

www-data で変えたのは証明書の場所だけです。
僕が出くわしたのもまさにこの構図でした (ターミナルでは通る、Web では落ちる、場所を変えると通る)。

直し方: 証明書をプロジェクトに置いて base_path で指す

CA 証明書を /var/lib/mysql からプロジェクト直下に置き直し、config/database.php の証明書パスを base_path で指す手順の図

やることは 2 ステップです。

  1. CA 証明書を Laravel プロジェクトの中に置く
  2. config/database.php に書く証明書のパスをそちらに向ける

1. CA 証明書をプロジェクトの直下に置く

Laravel のプロジェクトは、Web の PHP がもともと読んでいる場所です。
僕は /var/lib/mysql にあった証明書をここに置きました。サーバ側に設定している CA 証明書をコピーするならこうです (自動生成の証明書だと接続先ホスト名と CN が合わず別の検証エラーになることがあるため、実際に使っているものを指定します)。

# root (または sudo) で、MySQL に設定している CA 証明書をプロジェクト直下にコピーする
sudo cp /var/lib/mysql/[CA証明書] [プロジェクトのパス]/ca.pem

※ コピーするのは CA 証明書だけです。同じ場所にある ca-key.pem などの鍵ファイルはサーバ検証に使わないので、一緒に持ち出さないでください。

2. config/database.php の証明書パスを base_path で書く

Laravel 12.x 標準の config/database.php にある mysql 接続には、最初から CA 証明書を指定する行があります。
既定では .env の MYSQL_ATTR_SSL_CA から読む形です。

僕はここを base_path() で書きました。プロジェクトのルートからの絶対パスを返すヘルパです。

config/database.php

'mysql' => [
    // ...
    'options' => extension_loaded('pdo_mysql') ? array_filter([
        // プロジェクト直下に置いた CA 証明書を指す (PHP 8.5 以降は Pdo\Mysql::ATTR_SSL_CA)
        (PHP_VERSION_ID >= 80500 ? \Pdo\Mysql::ATTR_SSL_CA : \PDO::MYSQL_ATTR_SSL_CA) => base_path('ca.pem'),
    ]) : [],
],

これで Web からも読めるようになりました。

※ /var/lib/mysql の権限を緩める発想もありますが、MySQL 公式が「閉じておけ」としている場所なので、僕は証明書を置き直すほうをオススメします。

当時、僕はインフラ周りだと年に数回こういう壁に当たっていました。どれだけ検索しても答えに行き着けないやつです。
原因をたどってみたら、証明書の中身ではなく実行ユーザと権限の話でした。

関連記事

まだコメントはありません