PHPのインストール方法：Windows・Mac・Linux（php -vで確認）

PHPをインストールするには、使っているシステム用のコマンドを1つ実行します。Windowsはwinget install PHP.PHP.8.3、macOSはbrew install php、UbuntuとDebianはsudo apt install php-cliです。そのあと新しいターミナルを開いてphp -vを実行します。バージョン番号が表示されれば、PHPはインストールされています。

php -v

PHP 8.3.19 (cli) (built: Mar 27 2025 11:08:15) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.3.19, Copyright (c) Zend Technologies
    with Zend OPcache v8.3.19, Copyright (c), by Zend Technologies

バージョンとビルド日は環境によって異なります。スクリプトの中では、同じ情報をPHP_VERSIONとphpversion()から得られます。Runを押すと、このページのPHPが返す値を確認できます。

<?php
echo "PHP version: " . phpversion() . "\n";
echo "Version as a number: " . PHP_VERSION_ID . "\n";
echo "Operating system family: " . PHP_OS_FAMILY . "\n";
echo "Integer size: " . PHP_INT_SIZE * 8 . " bit\n";

WindowsにPHPをインストールする

いちばん手早いのはwingetで、Windows 10と11に標準で入っています。PowerShellかWindows Terminalを開きます。

winget install PHP.PHP.8.3

ターミナルを閉じて新しく開き、php -vを実行します。ターミナルは起動時のPATHを持ち続けるので、新しいウィンドウが必要です。

手動でインストールする場合は次のとおりです。

1. windows.php.net/downloadから「VS16 x64 Non Thread Safe」のzipをダウンロードします。
2. C:\phpのような短いパスに展開します。
3. 同じフォルダーでphp.ini-developmentをphp.iniとしてコピーします。
4. C:\phpをPath変数に追加します（スタートメニューで「システム環境変数の編集」、環境変数）。
5. 新しいターミナルを開いてphp -vを実行します。

ApacheとMySQLも1つのインストーラーでまとめて入れたいなら、XAMPPやLaragonにPHPが同梱されています。

macOSにPHPをインストールする

macOSにはもうPHPが入っていません。Homebrewでインストールします。

brew install php
php -v

brew install phpで最新のリリースが入ります。バージョンを固定するには、brew install php@8.3のように名前を指定してインストールします。バージョン付きのformulaはデフォルトではリンクされないので、インストールの最後にHomebrewが表示するコマンドでPATHに追加してください。あとで更新するときはbrew upgrade phpです。

LinuxにPHPをインストールする

Ubuntu 24.04とDebian 13は、公式リポジトリでPHP 8.3以降を提供しています。

sudo apt update
sudo apt install php-cli php-mbstring php-xml php-curl
php -v

Fedora、RHELなどでは次のとおりです。

sudo dnf install php-cli php-mbstring php-xml
php -v

拡張機能はphp-<name>という名前の別パッケージです。DebianとUbuntuではphp-mysqlでMySQLドライバー（Fedoraではphp-mysqlnd）が、php-intlでintl拡張が入ります。Ubuntuでディストリビューションより新しいPHPが必要なら、広く使われているppa:ondrej/phpリポジトリにサポート中の全バージョンがあります。

sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install php8.3-cli

コードでPHPのバージョンを確認する

ライブラリには最低バージョンが必要なことがよくあります。version_compareはPHPと同じ方法でバージョン文字列を比較し、PHP_VERSION_IDは比較しやすい整数（80300は8.3.0）を返します。

<?php
$required = '8.1.0';

if (version_compare(PHP_VERSION, $required, '>=')) {
    echo "PHP " . PHP_VERSION . " is new enough (need $required)\n";
} else {
    echo "Please upgrade: this code needs PHP $required\n";
}

echo PHP_VERSION_ID >= 80300 ? "8.3 features are available\n" : "Older than 8.3\n";
echo "Major: " . PHP_MAJOR_VERSION . ", minor: " . PHP_MINOR_VERSION . "\n";

インストール済みの拡張機能を確認する

インストール直後のエラーの多くは、拡張機能が足りないことが原因です。ターミナルではphp -mで読み込まれている拡張機能がすべて表示されます。コードではextension_loadedで名前を指定して1つずつ確認できます。

<?php
$needed = ['mbstring', 'json', 'ctype', 'dom'];

foreach ($needed as $ext) {
    $status = extension_loaded($ext) ? 'loaded' : 'MISSING';
    printf("%-10s %s\n", $ext, $status);
}

echo "\nTotal extensions loaded: " . count(get_loaded_extensions()) . "\n";

プロジェクトに必要な名前（たとえばpdo_mysql、intl、gd）を追加して自分のパソコンで実行すると、何をインストールすべきかがわかります。

php.iniの場所を調べる

display_errors、memory_limit、upload_max_filesizeなどの設定はphp.iniにあります。どのファイルが読み込まれているかは、ターミナルでphp --iniを実行すると表示されます。コードからは次のように調べます。

<?php
$ini = php_ini_loaded_file();
echo $ini === false ? "No php.ini loaded, PHP uses its defaults\n" : "Loaded: $ini\n";

echo "memory_limit = " . ini_get('memory_limit') . "\n";
echo "max_execution_time = " . ini_get('max_execution_time') . "\n";

CLIとWebサーバーは別々のphp.iniを使うことがあるので、片方で変えた設定がもう片方に効くとは限りません。開発環境で最初に変えておきたい設定はエラー表示のページで紹介しています。

よくある問題：ターミナルで古いバージョンが動く

アップグレードしたのに、php -vが前のバージョンを表示することがあります。which php（macOS、Linux）かwhere php（Windows）を実行すると、ターミナルが最初に見つけるバイナリがわかります。macOSでは、インストールはされていてもリンクされていないHomebrewのバージョンであることが多く、Windowsでは、XAMPPの中にあるような古いフォルダーがPathの前のほうにあることがほとんどです。順番を直し、新しいターミナルを開いてもう一度確認してください。そのあとはPHPファイルの実行に進みます。