その他

PHP exec関数の使い方とセキュリティ対策について解説

2025-04-15更新日: 2025-04-15

PHPのexec関数は、プログラム内からシェルのコマンドを実行し、その結果を取得することができる便利な機能です。

たとえば、ファイル操作やシステムの状態確認などの日常的な処理を自動化する際に利用されます。

ただし、実行するコマンドに外部からの入力が関わる場合は不正な操作につながるリスクがあるため、十分な検証と安全対策が求められます。

目次から探す

exec関数の基本操作
- 構文と動作の流れ
- 出力結果の取り扱い
セキュリティ対策
- コマンド実行時のリスク管理
- PHP設定と環境チェック
実用例と注意事項
- サンプルコードの紹介
- 発生しやすい問題への対処
まとめ

exec関数の基本操作

構文と動作の流れ

パラメータと戻り値の詳細

PHPのexec関数は外部コマンドを実行するための関数です。

基本的な構文は以下のようになっています。

$lastLine = exec($command, $outputArray, $returnCode);

各パラメータの役割は次のとおりです。

$command: 実行するシェルコマンドの文字列です。
$outputArray: コマンド実行中に標準出力に出力された各行の情報が格納される配列です。
$returnCode: シェルが返す終了ステータスが格納されます。通常、0の場合は正常終了を意味します。

戻り値の$lastLineは、出力結果の最終行の値となります。

全体の出力が必要な場合は、$outputArrayを活用してください。

コマンド実行の順序

exec関数は指定された$commandを外部のシェル経由で実行します。

以下の流れで動作します。

指定したコマンド文字列をシェルに渡して実行開始
コマンドの標準出力が順次$outputArrayに格納
コマンドの終了後、最後の出力行が関数の戻り値として返され、終了ステータスが$returnCodeにセットされる

このため、実行順序や出力の内容については、実行するコマンドごとに差異が出る点に注意が必要です。

出力結果の取り扱い

標準出力の取得方法

標準出力の結果を配列に格納するには、2番目の引数として配列変数を指定します。

例えば、以下のサンプルコードでは、ディレクトリ内のファイル一覧を取得する例を示します。

<?php
// 実行するコマンド
$command = 'ls -1';
// 出力結果を格納する配列
$outputArray = array();
// 終了ステータスを格納する変数
$returnCode = 0;
// exec関数でコマンドを実行
$lastLine = exec($command, $outputArray, $returnCode);
// 各行の出力結果を表示
foreach ($outputArray as $line) {
    echo $line . "\n";
}
?>

file1.txt
file2.php
ディレクトリ名
...

上記の例では、実行されたコマンドの標準出力結果が$outputArrayに行単位で格納され、各行を順次表示しています。

エラー検出と処理手法

exec関数自体はエラー情報を直接出力しませんので、コマンドの実行結果や返り値で判定する必要があります。

具体的には、以下の方法でエラー検出と対策を行うことができます。

$returnCodeの値が0以外の場合は、エラーが発生したと判断する。
$outputArrayにエラーメッセージが含まれる場合を考慮し、必要に応じてログに記録する。

これらの情報をもとに、ユーザーにエラーメッセージを表示するか、システムログに詳細情報を残すなどの処理を追加すると良いでしょう。

セキュリティ対策

コマンド実行時のリスク管理

インジェクション防止の手法

exec関数を利用する際に特に注意する点は、外部からの入力値をそのままコマンドに渡さないことです。

入力値のバリデーションや、コマンドに埋め込む際のサニタイズが必須となります。

また、escapeshellcmd()やescapeshellarg()といった関数を利用して、シェルメタ文字の混入を防ぐ方法が推奨されます。

コマンドエスケープの具体例

以下は、外部入力を利用する場合のエスケープ処理の例です。

<?php
// 外部からの入力(例としてユーザーが入力したファイル名)
$userInput = "example.txt; rm -rf /"; // 危険な入力例
// escapeshellargを利用して入力値をエスケープ
$safeInput = escapeshellarg($userInput);
// 安全なコマンド文字列を生成
$command = 'cat ' . $safeInput;
// コマンド実行
$outputArray = array();
$returnCode = 0;
exec($command, $outputArray, $returnCode);
// 結果を表示
foreach ($outputArray as $line) {
    echo $line . "\n";
}
?>

ファイルの内容
...

上記の例では、$userInputに対してescapeshellarg()を適用することで、コマンドインジェクションのリスクを低減しています。

PHP設定と環境チェック

設定項目の確認ポイント

PHPの設定ファイルphp.iniでは、exec関数を含む外部コマンド実行系の関数が制限されている場合があります。

確認すべきポイントは以下の通りです。

disable_functionsに対象の関数がリストアップされていないか
セキュリティ強化のために追加の設定(例: open_basedir)が施されていないか
システム環境に依存する実行パスの設定が正しく行われているか

これらの設定内容を開発環境や本番環境でチェックすることで、予期しない動作を防ぐことができます。

制限事項への対応方法

PHP設定で外部コマンドの実行が制限されている場合、以下のような対応が考えられます。

管理者権限でphp.iniの設定を確認・修正する
proc_openなど、別の方法で外部コマンド実行を検討する
コマンド実行が不要なロジックの場合は、実行を避ける、またはライブラリを利用して代替する

環境ごとに制限事項が異なるため、実行前に該当の設定を確認することが重要です。

実用例と注意事項

サンプルコードの紹介

シンプルな実装例

ここでは基本的なコマンド実行のサンプルコードを紹介します。

以下の例では、現在の作業ディレクトリ内のファイル一覧を取得するシンプルな実装を示しています。

<?php
// システムコマンドを格納する変数
$command = 'ls -l';
// 出力結果用の配列と終了コード用の変数
$outputArray = array();
$returnCode = 0;
// exec関数でコマンドを実行
$lastLine = exec($command, $outputArray, $returnCode);
// 取得した全出力を表示
foreach ($outputArray as $line) {
    echo $line . "\n";
}
// 終了コードが0でない場合、エラー発生と判断
if ($returnCode !== 0) {
    echo "エラーが発生しました。終了コード: {$returnCode}\n";
}
?>

drwxr-xr-x  4 user  staff  128 Jan  1 12:34 .
drwxr-xr-x  7 user  staff  224 Jan  1 12:00 ..
-rw-r--r--  1 user  staff   54 Jan  1 12:35 sample.php
...

出力結果の活用事例

取得した出力結果は、例えばログの記録やウェブページへの表示、後続の処理でのデータ入力などに活用することができます。

次の例では、取得した配列から必要な情報をフィルタリングして表示する場合の例です。

<?php
// execを利用してシステム情報を取得
$command = 'uname -a';
$outputArray = array();
exec($command, $outputArray);
// 配列から特定の情報(例: OS情報)を抽出して表示
if (!empty($outputArray)) {
    // 先頭行にOS情報が含まれる前提
    $systemInfo = $outputArray[0];
    echo "システム情報: " . $systemInfo . "\n";
} else {
    echo "システム情報の取得に失敗しました。\n";
}
?>

システム情報: Linux hostname 5.4.0-42-generic #46-Ubuntu SMP Wed Jul 15 10:00:00 UTC 2020 x86_64 x86_64 x86_64 GNU/Linux

発生しやすい問題への対処

エラー発生時のチェックポイント

exec関数を利用する際に発生しやすい問題として、以下の点に注意する必要があります。

コマンド実行後の$returnCodeの値の確認
コマンド出力が空の場合は、実行環境またはコマンド自体に問題がある可能性
権限エラーの確認(実行ユーザーがコマンドを実行する権限を持っているか)
PHPの設定(例: disable_functions)によりexec関数が無効化されていないか

これらのチェックポイントを確認することで、原因究明や対策が行いやすくなります。

実行結果の最適な処理方法

実行結果をそのまま利用するのではなく、以下のような対策を講じることで、より安全かつ安定したシステム運用が可能となります。

出力結果に対する文字列操作や正規表現によるフィルタリング
複数行の出力データを連結して、利用しやすい形に整形
エラー時には即座にログを出力し、ユーザーにはシンプルなエラーメッセージのみを表示する

これにより、出力結果の内容に基づくさらなる処理が容易になると考えられます。

まとめ

この記事では、PHPのexec関数の基本操作や出力結果の取得方法、エラー検出の仕組みとともに、インジェクション防止やPHP設定のチェックなど、セキュリティ対策に関する実例を交えた安全な実装方法を紹介しましたでした。

exec関数の使用方法やリスク管理、実用例を通して、より堅牢なコード設計の必要性が浮き彫りになったと言えます。

ぜひ今回の内容を参考に、実際の環境で安全なコマンド実行の実装を試してみてください。