PHPエラーログ設定完全ガイド：php.ini・権限・Docker対応

2026年4月30日

お得なお知らせ

スポンサードリンク

AI時代のキャリア構築

プログラミング学習、今日から動き出す

「何から始めるか」で止まっている人こそ、無料説明会や本で自分に合うルートを30分で確定できます。

Enjoy Tech!｜月額制でWeb系に強い▶ (Kindle本)ＩＴエンジニアの転職学｜後悔しないキャリア戦略▶

▶ AIコーディング環境なら実践Claude Code入門（Amazon）が実務で即使える入門書です。Amazonベストセラーにも選ばれていますよ。

Contents

1 1️⃣ PHP 本体の設定 ― php.ini の主要ディレクティブ
- 1.1 設定例（Linux 用）
2 2️⃣ ログファイルの配置と OS 権限
3 3️⃣ コードからログ出力を制御するテクニック
4 4️⃣ 環境別ベストプラクティス ― 開発 / 本番 / Docker
- 4.1 4‑1. Dockerfile とエントリポイント例
5 5️⃣ トラブルシューティングフロー
6 📌 まとめ（ポイントだけ）

スポンサードリンク

1️⃣ PHP 本体の設定 ― `php.ini` の主要ディレクティブ

ディレクティブ	目的	推奨値 (例)
`log_errors`	エラーログ出力を有効化	`On`
`error_log`	ログファイルの保存先 (絶対パス)	`/var/log/php/error.log` （Linux） `C:\\php\\logs\\error.log`（Windows）
`display_errors`	エラーを画面に表示するか	本番: `Off`、開発: `On`
`error_reporting`	どのエラーレベルを対象にするか	`E_ALL`（開発） `E_ALL & ~E_DEPRECATED & ~E_STRICT`（本番）

設定例（Linux 用）

; php.ini（または conf.d/*.ini）に追加
log_errors = On
error_log = /var/log/php/error.log
display_errors = Off          ; 本番環境では必ずオフ
error_reporting = E_ALL &amp; ~E_DEPRECATED &amp; ~E_STRICT

; php.ini（または conf.d/*.ini）に追加

log_errors = On

error_log = /var/log/php/error.log

display_errors = Off ; 本番環境では必ずオフ

error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT

公式マニュアル
- log_errors・error_log: https://www.php.net/manual/en/errorfunc.configuration.php#ini.log-errors
- display_errors: https://www.php.net/manual/ja/errorfunc.configuration.php#ini.display-errors
- error_reporting: https://www.php.net/manual/ja/errorfunc.configuration.php#ini.error-reporting

2️⃣ ログファイルの配置と OS 権限

2‑1. Linux（Ubuntu/Debian 系）

# ① ディレクトリ作成
sudo mkdir -p /var/log/php

# ② 所有者を Web サーバー実行ユーザーに変更 (Apache の場合 www-data、Nginx+PHP‑FPM は www-data)
sudo chown www-data:www-data /var/log/php

# ③ ディレクトリ権限は 0755、ファイルは 0644 が基本
sudo chmod 0755 /var/log/php
sudo touch /var/log/php/error.log
sudo chmod 0644 /var/log/php/error.log

# ① ディレクトリ作成

sudo mkdir -p /var/log/php

# ② 所有者を Web サーバー実行ユーザーに変更 (Apache の場合 www-data、Nginx+PHP‑FPM は www-data)

sudo chown www-data:www-data /var/log/php

# ③ ディレクトリ権限は 0755、ファイルは 0644 が基本

sudo chmod 0755 /var/log/php

sudo touch /var/log/php/error.log

sudo chmod 0644 /var/log/php/error.log

ポイント
chmod 0755 は「所有者が書き込み可、他は読み取り・実行可」なのでディレクトリ探索に必要です。
ファイル単位で 0644 にすれば、Web サーバー以外のユーザーからの書き込みを防げます。

2‑2. Windows（IIS）

エクスプローラーで C:\php\logs を作成。
フォルダーの [プロパティ] → [セキュリティ] にて、使用するアプリケーションプール ID（例：IIS AppPool\MyAppPool）または IUSR に「書き込み」権限を付与。
php.ini ではバックスラッシュを 二重にエスケープ することを忘れずに。

error_log = &quot;C:\\php\\logs\\error.log&quot;

1 2	error_log = "C:\\php\\logs\\error.log"

2‑3. SELinux / AppArmor の考慮

SELinux: setsebool -P httpd_unified 1 または対象ディレクトリにポリシー例外を追加。
AppArmor: /etc/apparmor.d/usr.sbin.php-fpm に "/var/log/php/** rw," を追記し、systemctl reload apparmor。

3️⃣ コードからログ出力を制御するテクニック

3‑1. ランタイムで設定を書き換える (`ini_set`)

&lt;?php
// 開発時だけ詳細ログを有効化
if (getenv('APP_ENV') === 'development') {
    ini_set('log_errors',      '1');
    ini_set('display_errors',  '1');
    ini_set('error_log',       __DIR__ . '/logs/dev.log');
}

// 本番環境では画面表示をオフに
else {
    ini_set('display_errors',  '0');
}
?&gt;

<?php

// 開発時だけ詳細ログを有効化

if (getenv('APP_ENV') === 'development') {

ini_set('log_errors', '1');

ini_set('display_errors', '1');

ini_set('error_log', __DIR__ . '/logs/dev.log');

}

// 本番環境では画面表示をオフに

else {

ini_set('display_errors', '0');

}

3‑2. `error_log()` の活用例

&lt;?php
// カスタムフォーマットでログを書き込む
$context = [
    'user_id'   =&gt; $userId ?? null,
    'uri'       =&gt; $_SERVER['REQUEST_URI'],
    'ip'        =&gt; $_SERVER['REMOTE_ADDR'] ?? '',
];
$msg = sprintf(
    &quot;[%s] %s - %s&quot;,
    date('c'),                                 // ISO8601 タイムスタンプ
    $context['uri'],
    $context['user_id'] ? &quot;User {$context['user_id']} error&quot; : 'Anonymous request'
);
error_log($msg, 3, __DIR__ . '/logs/custom.log');
?&gt;

<?php

// カスタムフォーマットでログを書き込む

$context = [

'user_id' => $userId ?? null,

'uri' => $_SERVER['REQUEST_URI'],

'ip' => $_SERVER['REMOTE_ADDR'] ?? '',

];

$msg = sprintf(

"[%s] %s - %s",

date('c'), // ISO8601 タイムスタンプ

$context['uri'],

$context['user_id'] ? "User {$context['user_id']} error" : 'Anonymous request'

);

error_log($msg, 3, __DIR__ . '/logs/custom.log');

第2引数 3 は「ファイルへ直接書き込む」モード。
複数行の構造化ログが必要なら JSON にシリアライズして出力すると、後続の Logstash/Fluentd との相性が良くなります。

3‑3. Monolog で高度なロギング

composer require monolog/monolog

1 2	composer require monolog/monolog

&lt;?php
use Monolog\Logger;
use Monolog\Handler\StreamHandler;

$log = new Logger('app');
$log-&gt;pushHandler(new StreamHandler(__DIR__.'/logs/monolog.log', Logger::DEBUG));

$log-&gt;error('Invalid parameter', ['user_id' =&gt; $userId, 'param' =&gt; $input]);
?&gt;

<?php

use Monolog\Logger;

use Monolog\Handler\StreamHandler;

$log = new Logger('app');

$log->pushHandler(new StreamHandler(__DIR__.'/logs/monolog.log', Logger::DEBUG));

$log->error('Invalid parameter', ['user_id' => $userId, 'param' => $input]);

メリット
- ログレベル（debug、info、warning、error…）の細分化
- 複数ハンドラ（ファイル・syslog・Slack 等）への同時出力が可能

4️⃣ 環境別ベストプラクティス ― 開発 / 本番 / Docker

環境	`php.ini` の要点	補足
開発（ローカル）	`display_errors = On` `log_errors = On` `error_reporting = E_ALL` `error_log = /path/to/dev/error.log`	IDE と同時にファイルを tail すれば即座に原因把握が可能
本番（物理/仮想サーバ）	`display_errors = Off` `log_errors = On` `error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT` `error_log = /var/log/php/error.log`	ログは外部 SIEM へ転送（例: Filebeat → Elasticsearch）
Docker コンテナ	`error_log = /proc/self/fd/2`（stderr）	Docker の標準ロギングドライバが自動収集。環境変数で上書き可能にすると柔軟性が向上

4‑1. Dockerfile とエントリポイント例

# Dockerfile
FROM php:8.3-fpm

# 必要な拡張をインストール（例：pdo_mysql）
RUN docker-php-ext-install pdo_mysql

# カスタム設定ファイルをコピー
COPY ./conf/php.ini /usr/local/etc/php/conf.d/custom.ini

# エントリポイントスクリプトを配置
COPY ./docker-entrypoint.sh /usr/local/bin/
ENTRYPOINT [&quot;docker-entrypoint.sh&quot;]
CMD [&quot;php-fpm&quot;]

# Dockerfile

FROM php:8.3-fpm

# 必要な拡張をインストール（例：pdo_mysql）

RUN docker-php-ext-install pdo_mysql

# カスタム設定ファイルをコピー

COPY ./conf/php.ini /usr/local/etc/php/conf.d/custom.ini

# エントリポイントスクリプトを配置

COPY ./docker-entrypoint.sh /usr/local/bin/

ENTRYPOINT ["docker-entrypoint.sh"]

CMD ["php-fpm"]

# docker-entrypoint.sh（抜粋）
#!/bin/sh
set -e

if [ &quot;$APP_ENV&quot; = &quot;production&quot; ]; then
    # 本番は stderr に出力
    php -d display_errors=Off -d error_log=/proc/self/fd/2
else
    # 開発はローカルファイルへ
    php -d display_errors=On -d error_log=/var/log/php/dev.log
fi

exec &quot;$@&quot;

# docker-entrypoint.sh（抜粋）

#!/bin/sh

set -e

if [ "$APP_ENV" = "production" ]; then

# 本番は stderr に出力

php -d display_errors=Off -d error_log=/proc/self/fd/2

else

# 開発はローカルファイルへ

php -d display_errors=On -d error_log=/var/log/php/dev.log

exec "$@"

PHP_INI_SCAN_DIR を利用すれば、conf.d/ 配下に複数の設定ファイルを分割管理でき、コンテナ起動時に自動でマージされます。

5️⃣ トラブルシューティングフロー

ログファイルが生成されているか
ls -l /var/log/php/error.log（Linux）やエクスプローラーで確認。
書き込み権限は正しいか
Linux: stat -c "%U %A" /var/log/php/error.log → 所有者が Web サーバーユーザーか、パーミッションが rw- か。
Windows: 「プロパティ → セキュリティ」で対象ユーザーに「書き込み」権限があるか。
SELinux / AppArmor の制約
bash # SELinux が拒否している場合は audit.log に記録される ausearch -m avc -ts recent | audit2allow -w -a
必要に応じて setsebool かカスタムポリシーで例外を付与。
パスのエスケープミス（Windows）
error_log = "C:\php\logs\error.log" → バックスラッシュが1つだけだと文字列が途中で切れる。必ず "C:\\php\\logs\\error.log" と記述。
リアルタイム確認コマンド

OS	コマンド
Linux	`tail -F /var/log/php/error.log` （ログローテーション対応）
macOS	同上（BSD版 `tail -f` でも可）
Windows PowerShell	`Get-Content -Path C:\php\logs\error.log -Wait`

PHP‑FPM のエラーログ
conf ; php-fpm.conf (global) error_log = /var/log/php/fpm_error.log log_level = notice
systemd 管理下なら journalctl -u php-fpm -f で一元閲覧できる。

📌 まとめ（ポイントだけ）

php.ini の主要ディレクティブは必ず明示的に設定し、公式マニュアルのリンクを添えておく。
ログ保存先は 絶対パス とし、OS の所有者・権限を正しく付与する（Linux は www-data、Windows はアプリプール ID）。
ランタイムで ini_set() や error_log() を使い、モジュール単位の細かい制御や JSON/Monolog で構造化ログを実現。
環境別（開発／本番／Docker）に設定を分け、Docker では stderr 出力＋環境変数で切り替えると運用が楽になる。
トラブル時は「ファイル・権限」「SELinux/AppArmor」「パスエスケープ」の順にチェックし、tail -F や Get-Content -Wait でリアルタイム監視する。

これらのベストプラクティスを導入すれば、PHP 8.3 のエラーログは確実に取得でき、障害対応やパフォーマンスチューニングが格段にスムーズになります。

スポンサードリンク

お得なお知らせ

スポンサードリンク

AI時代のキャリア構築

プログラミング学習、今日から動き出す

「何から始めるか」で止まっている人こそ、無料説明会や本で自分に合うルートを30分で確定できます。

Enjoy Tech!｜月額制でWeb系に強い▶ (Kindle本)ＩＴエンジニアの転職学｜後悔しないキャリア戦略▶

▶ AIコーディング環境なら実践Claude Code入門（Amazon）が実務で即使える入門書です。Amazonベストセラーにも選ばれていますよ。

-PHP

comment コメントをキャンセル

: PHP

WordPress6.xとPHP8でローカル開発環境を構築しモダンプラグイン作成

最新の WordPress と PHP をローカルにセットアップし、Composer と PSR‑4 でモダンなカスタムプラグインを作成する手順と、デバッグ・テスト・CI/CD のベストプラクティスを紹介します。

: PHP

Laravel 10 と PHP 8.3 の互換性とパフォーマンス向上ガイド

本稿では PHP 8.3 の主要機能と Laravel 10 への互換性を検証し、実測ベンチマークでの性能向上結果や安全なアップグレード手順、トラブルシューティングを包括的に紹介します。

: PHP

Laravel vs Symfony 徹底比較：2025年版開発速度・学習コスト・保守性

Laravel は開発スピードと豊富なエコシステム、Symfony は設計柔軟性と大規模プロジェクト向け堅牢性に特化しています。

: PHP

Docker と Composer で Laravel 最新 PHP 環境を構築する方法

Docker Desktop または Laravel Sail を使って OS に依存しない開発環境を構築し、PHP8.2 と Composer が同梱されたコンテナで Laravel プロジェクトを作成・設定する手順と、主要な Artisan コマンドや Todo アプリの実装方法を紹介します。

: PHP

PHP 8.3 新機能と安全なアップグレード手順【型定数・Enum・readonly】

PHP 8.3 の型システム拡張や Enum 改善、readonly プロパティの挙動変更などをまとめ、phpstan と rector による互換性チェックと具体的なアップグレード手順を提示します。

Android Studio Giraffeで始めるJetpack Compose環境構築ガイド

HubSpot SSO設定ガイド：導入効果と手順完全解説

PHPエラーログ設定完全ガイド：php.ini・権限・Docker対応

1️⃣ PHP 本体の設定 ― php.ini の主要ディレクティブ

設定例（Linux 用）

2️⃣ ログファイルの配置と OS 権限

2‑1. Linux（Ubuntu/Debian 系）

2‑2. Windows（IIS）

2‑3. SELinux / AppArmor の考慮

3️⃣ コードからログ出力を制御するテクニック

3‑1. ランタイムで設定を書き換える (ini_set)

3‑2. error_log() の活用例

3‑3. Monolog で高度なロギング

4️⃣ 環境別ベストプラクティス ― 開発 / 本番 / Docker

4‑1. Dockerfile とエントリポイント例

5️⃣ トラブルシューティングフロー

📌 まとめ（ポイントだけ）

1️⃣ PHP 本体の設定 ― `php.ini` の主要ディレクティブ

3‑1. ランタイムで設定を書き換える (`ini_set`)

3‑2. `error_log()` の活用例