Windows 10でコマンドプロンプトからPHPを実行する方法

はじめに (対象読者・この記事でわかること)

この記事は、Windows 10環境でPHPをコマンドプロンプトから実行したいと考えているプログラミング初学者や開発者を対象にしています。特に、ローカル環境でPHPスクリプトをテストしたい方に最適です。

この記事を読むことで、Windows 10にPHPをインストールする方法、環境変数の設定方法、コマンドプロンプトからPHPを実行する方法、基本的なPHPコマンドラインオプションの使い方、PHPスクリプトの作成と実行方法を理解できます。また、実装中に遭遇するであろう問題やエラーの解決策も学ぶことができます。

前提知識

この記事を読み進める上で、以下の知識があるとスムーズです。 - Windows 10の基本的な操作 - コマンドプロンプトの基本的な使い方 - プログラミングの基本的な概念

PHPをWindows 10で実行するための準備

PHPはサーバーサイドのスクリプト言語として広く使用されていますが、コマンドラインインターフェース（CLI）を通じて、直接スクリプトを実行することも可能です。Windows 10環境でPHPをコマンドプロンプトから実行するためには、いくつかの設定が必要です。

まず、PHPの公式サイトからWindows用のインストーラーをダウンロードする必要があります。また、インストール後は環境変数の設定を行い、コマンドプロンプトからPHPコマンドをどこからでも実行できるようにする必要があります。

この記事では、これらの手順を詳しく解説し、Windows 10環境でPHPをコマンドラインから利用するための完全なガイドを提供します。

Windows 10でPHPをコマンドプロンプトから実行する具体的な手順

ステップ1: PHPのインストール

まずはPHPをWindows 10にインストールします。

PHP公式サイト（https://www.php.net/downloads.php）にアクセスします。
Windows用のインストーラーをダウンロードします。現在の最新バージョンはPHP 8.2ですが、お使いのアプリケーションに互換性のあるバージョンを選択してください。
ダウンロードしたインストーラーを実行します。
インストールウィザードに従って、PHPをインストールします。インストール先はデフォルトのままで問題ありませんが、パスを覚えておいてください（例：C:\php）。
「Add to PATH」オプションにチェックを入れると、環境変数が自動的に設定されます。これにチェックを入れておくと後の手順が簡単になります。

インストールが完了したら、コマンドプロンプトを開き、以下のコマンドを入力してPHPが正しくインストールされているか確認します。

php -v

バージョン情報が表示されれば、インストールは成功です。

ステップ2: 環境変数の設定（自動設定がされていない場合）

インストーラーで「Add to PATH」オプションにチェックを入れなかった場合、手動で環境変数を設定する必要があります。

Windowsキーを押し、「システム環境設定」と入力してEnterキーを押します。
「システムの詳細設定」をクリックします。
「環境変数」ボタンをクリックします。
「システム環境変数」セクションで「Path」を選択し、「編集」ボタンをクリックします。
「新規」ボタンをクリックし、PHPのインストール先ディレクトリ（例：C:\php）を追加します。
「OK」をクリックしてすべてのダイアログを閉じます。

環境変数を設定した後は、コマンドプロンプトを再起動する必要があります。再度「php -v」コマンドを実行し、バージョン情報が表示されることを確認してください。

ステップ3: PHPスクリプトの作成と実行

次に、簡単なPHPスクリプトを作成し、コマンドプロンプトから実行してみましょう。

メモ帳やVisual Studio Codeなどのテキストエディタを開きます。
以下のコードを入力します。

Php

<?php
echo "Hello, World!\n";
?>

ファイルを「hello.php」という名前でデスクトップに保存します。
コマンドプロンプトを開き、以下のコマンドを入力してスクリプトを実行します。

cd C:\Users\ユーザー名\Desktop
php hello.php

「Hello, World!」と表示されれば、PHPスクリプトの実行は成功です。

ステップ4: PHPコマンドラインオプションの使い方

PHPには便利なコマンドラインオプションが多数用意されています。以下に主要なオプションをいくつか紹介します。

-f オプション

指定したファイルを実行します。

php -f hello.php

-r オプション

コードを直接実行します。ファイルを作成する必要はありません。

php -r "echo 'Hello, World!\n';"

-l オプション

構文チェックを行います。エラーがある場合はエラーメッセージが表示されます。

php -l hello.php

-i オプション

PHPの設定情報を表示します。

php -i

-h オプション

利用可能なオプションの一覧を表示します。

php -h

ステップ5: 複雑なPHPスクリプトの実行

より複雑なPHPスクリプトを実行する方法を見てみましょう。以下に、コマンドライン引数を受け取り、その合計を計算するスクリプトの例を示します。

Php

<?php
if ($argc < 2) {
    echo "使用法: php calculate.php 数値1 数値2 ...\n";
    exit(1);
}

$sum = 0;
for ($i = 1; $i < $argc; $i++) {
    $sum += $argv[$i];
}

echo "合計: $sum\n";
?>

このスクリプトを「calculate.php」として保存し、以下のように実行します。

php calculate.php 10 20 30

「合計: 60」と表示されれば成功です。

ハマった点やエラー解決

エラー1: 'php'は、内部コマンドまたは外部コマンド、操作可能なプログラムまたはバッチファイルとして認識されていません。

このエラーは、PHPがシステムのPATHに含まれていない場合に発生します。環境変数の設定を確認し、PHPのインストール先ディレクトリがPATHに含まれているか確認してください。

エラー2: スクリプトの実行時に「PHP Parse error: syntax error, unexpected ...」エラーが表示される

これはPHPコードに構文エラーがある場合に発生します。特にWindows環境では、改行コードがLFではなくCRLFになっていることが原因であることがあります。テキストエディタの設定で改行コードをLFに変更してみてください。

エラー3: スクリプトの実行時に「Access is denied」エラーが表示される

これは、PHPが実行ファイルやディレクトリへのアクセス権を持っていない場合に発生します。ファイルやディレクトリのアクセス権を確認し、PHPが読み書きできるように設定してください。

解決策

上記のエラーが発生した場合、以下の手順で問題を解決できます。

'php'が認識されない場合: - 環境変数の設定を確認し、PHPのインストール先ディレクトリがPATHに含まれているか確認します。 - コマンドプロンプトを再起動して設定を反映させます。
構文エラーの場合: - テキストエディタの設定で改行コードをLFに変更します。 - PHPコードの構文を確認し、エラー箇所を修正します。
アクセス権エラーの場合: - ファイルやディレクトリのアクセス権を確認し、PHPが読み書きできるように設定します。 - UAC（ユーザーアカウント制御）の設定を変更して、管理者権限で実行する必要がある場合は、管理者としてコマンドプロンプトを実行します。

まとめ

本記事では、Windows 10でコマンドプロンプトからPHPを実行する方法について解説しました。

PHPのインストール方法
環境変数の設定方法
PHPスクリプトの作成と実行方法
主要なPHPコマンドラインオプションの使い方
よくあるエラーとその解決策

この記事を通して、Windows 10環境でPHPをコマンドラインから利用するための基本的な知識を得られたことと思います。これにより、ローカル環境でのPHPスクリプトのテストや自動化スクリプトの作成が容易になります。

今後は、PHPのWebサーバーとしての機能や、より高度なコマンドラインツールの作成方法についても記事にする予定です。

Windows 10でコマンドプロンプトからPHPを実行する方法💻