PHPからPythonプログラムを実行する方法【shell_exec関数の使い方】

PHPからPythonスクリプトを実行する基本

PHPからPythonプログラムを呼び出して実行したい場面は少なくありません。そんなときに役立つのが、PHPの shell_exec 関数です。

shell_exec 関数を使うと、シェル経由で外部コマンドやスクリプトを実行し、その実行結果を文字列（string）として受け取ることができます。

なお、コマンドラインからNULLが渡された場合や、何らかの出力も返されなかった場合には、エラーが発生する点に注意が必要です。

コード例：PHPからPythonファイルを実行する

以下に、実際のコード例を示します。

<?php
    $command_exec = escapeshellcmd('path-to-.py-file');
    $str_output = shell_exec($command_exec);
    echo $str_output;
?>

このコードの流れを簡単に解説します。

処理の流れ

まず escapeshellcmd() 関数を使って、実行したいPythonファイルのパスをエスケープ処理しています。これにより、シェルのメタ文字による意図しない動作（コマンドインジェクションなど）を防ぐことができます。

次に、shell_exec() 関数にそのコマンドを渡して実行し、結果を変数 $str_output に格納します。最後に echo で出力すれば、Pythonスクリプトの実行結果が表示されます。

実行に必要な権限設定

Pythonスクリプトを正常に実行するためには、適切な権限（パーミッション）を付与することが重要です。スクリプトファイルや関連ディレクトリに対して、実行権限が正しく設定されているか確認しましょう。

Unix系プラットフォームでの注意点

注意： Unix系のプラットフォームでは、PHPのコードはWebユーザーとして実行されます。そのため、Webユーザーに対象となるディレクトリやサブディレクトリへの必要なアクセス権限を付与しておく必要があります。権限が不足していると、スクリプトが実行できない、または期待どおりの出力が得られないといった問題が発生します。

まとめ

PHPからPythonプログラムを実行するには、shell_exec 関数と escapeshellcmd 関数を組み合わせるのが基本的な方法です。セキュリティ対策としてコマンドのエスケープ処理を行い、Unix環境ではWebユーザーへの権限設定を忘れないようにしましょう。