PHPで外部コマンドを実行する方法について解説

<?php
// コマンド出力を格納する変数
$output = array();
// 'ls -l'コマンドを実行し、結果を$outputに格納する
exec('ls -l', $output, $status);
// 結果を表示する
print_r($output);
?>

Array
(
    [0] => total 12
    [1] => -rw-r--r-- 1 user group 100 Oct 10 12:34 file1.txt
    [2] => -rw-r--r-- 1 user group 120 Oct 10 12:35 file2.txt
)

<?php
$output = array();
// 'ls -l'コマンドを実行
exec('ls -l', $output, $status);
// 正常終了の場合の処理
if ($status === 0) {
    echo "コマンドは正常に実行されました。\n";
} else {
    // エラー時の処理
    echo "エラーが発生しました。終了ステータス: " . $status;
}
?>

コマンドは正常に実行されました。

<?php
// 'ls -l'コマンドを実行し、全体の出力を文字列として取得
$commandOutput = shell_exec('ls -l');
echo $commandOutput;
?>

total 12
-rw-r--r-- 1 user group 100 Oct 10 12:34 file1.txt
-rw-r--r-- 1 user group 120 Oct 10 12:35 file2.txt

<?php
// system()を使用してコマンド実行と同時に結果を画面に出力
$status = system('ls -l', $returnStatus);
echo "\n終了ステータス: " . $returnStatus;
?>

total 12
-rw-r--r-- 1 user group 100 Oct 10 12:34 file1.txt
-rw-r--r-- 1 user group 120 Oct 10 12:35 file2.txt
終了ステータス: 0

<?php
// 無効なコマンドを実行し、終了ステータスで失敗を確認する
$returnStatus = -1;
system('invalidCommand', $returnStatus);
if ($returnStatus !== 0) {
    echo "コマンド実行に失敗しました。ステータス: " . $returnStatus;
}
?>

コマンド実行に失敗しました。ステータス: 127

<?php
$output = array();
// exec()を利用して'ls -l'コマンドを実行
exec('ls -l', $output);
$result = implode("\n", $output); // 配列の各要素を連結して1つの文字列に変換する
echo $result;
?>

total 12
-rw-r--r-- 1 user group 100 Oct 10 12:34 file1.txt
-rw-r--r-- 1 user group 120 Oct 10 12:35 file2.txt

<?php
$output = array();
// exec()で出力結果を配列に格納する
exec('ls -l', $output);
// 配列の各要素をループで出力する
foreach ($output as $line) {
    echo $line . "\n";
}
?>

total 12
-rw-r--r-- 1 user group 100 Oct 10 12:34 file1.txt
-rw-r--r-- 1 user group 120 Oct 10 12:35 file2.txt

<?php
$output = array();
exec('ls -l', $output, $status);
if ($status === 0) {
    echo "コマンドは正常に終了しました。\n";
} else {
    echo "エラーが発生しました。終了ステータス\( $status \)です。\n";
}
?>

コマンドは正常に終了しました。

<?php
$output = array();
exec('invalidCommand', $output, $status);
if ($status !== 0) {
    // エラー情報をログへ出力する
    error_log("コマンド実行に失敗しました。ステータス: " . $status);
    echo "エラーが発生しました。詳細はログを確認してください。\n";
}
?>

エラーが発生しました。詳細はログを確認してください。

<?php
// 外部から受け取った入力値
$userInput = $_GET['filename'];
// 危険な文字を除去するためにエスケープ処理を実施
$sanitizedInput = escapeshellarg($userInput);
// 安全なコマンドを組み立てる
$command = 'ls -l ' . $sanitizedInput;
exec($command, $output, $status);
echo implode("\n", $output);
?>

-rw-r--r-- 1 user group 100 Oct 10 12:34 safe_file.txt

<?php
// 外部から受け取った入力値
$userInput = $_GET['filename'];
// FILTER_SANITIZE_STRINGで入力値のサニタイズを実施
if (filter_var($userInput, FILTER_SANITIZE_STRING) === false) {
    echo "無効な入力値です。";
    exit;
}
// さらにエスケープ処理を行い、安全なコマンドを組み立てる
$command = 'ls -l ' . escapeshellarg($userInput);
exec($command, $output, $status);
echo implode("\n", $output);
?>

-rw-r--r-- 1 user group 100 Oct 10 12:34 file.txt

<?php
// ユーザーからの入力値を受け取る
$userInput = $_GET['arg'];
// 入力値をシェル上で安全に扱うためのエスケープ
$safeArg = escapeshellarg($userInput);
// 安全にコマンドを構築する
$command = 'someCommand ' . $safeArg;
exec($command, $output, $status);
echo implode("\n", $output);
?>

someCommand実行結果...

<?php
// 実行が許可されたコマンドのホワイトリストを定義する
$allowedCommands = array('ls', 'cat', 'echo');
// ユーザーからコマンド名を受け取る
$commandInput = $_GET['cmd'];
if (in_array($commandInput, $allowedCommands)) {
    // 安全なコマンドとして実行する
    $command = escapeshellcmd($commandInput) . ' -l';
    system($command);
} else {
    echo "許可されていないコマンドです。";
}
?>

total 12
-rw-r--r-- 1 user group 100 Oct 10 12:34 file1.txt
-rw-r--r-- 1 user group 120 Oct 10 12:35 file2.txt

<?php
$output = array();
// 'sleep 2'で2秒待機後に'ls -l'コマンドを実行する例
exec('sleep 2 && ls -l', $output, $status);
echo implode("\n", $output);
?>

total 12
-rw-r--r-- 1 user group 100 Oct 10 12:34 file1.txt
-rw-r--r-- 1 user group 120 Oct 10 12:35 file2.txt

<?php
// バックグラウンドでコマンドを実行し、結果を一時ファイルに出力する例
$command = 'sleep 2 && ls -l > /tmp/output.txt &';
exec($command);
echo "コマンドをバックグラウンドで実行中です。\n";
?>

コマンドをバックグラウンドで実行中です。

<?php
$output = array();
// 現在実行中のプロセス情報を取得する
exec('ps aux | grep someProcess', $output);
echo implode("\n", $output);
?>

user 1234 0.0 0.1 123456 1234 ? S 12:34 0:00 someProcess