XAMPPを使ったPHPローカル環境の構築方法

PHP

PHP開発を始めるときに最初につまずくポイントが環境構築です。Apache、MySQL、PHPをそれぞれ個別にインストールして設定するのは初心者にとって非常に複雑です。そこで活躍するのがXAMPPです。XAMPPはApache、MySQL、PHP、Perlを1つのパッケージにまとめたもので、これをインストールするだけで、複雑な設定作業をほぼスキップして、すぐにPHP開発が始められます。本記事では、WindowsとMacの両方で、XAMPPを使用してPHP開発環境を構築する手順を詳しく解説します。

XAMPPとは

XAMPPは「クロス・プラットフォーム」を意味するX、そしてApache、MySQL、PHP、Perlの頭文字をとったものです。Apachefriends という組織によって開発・配布されており、誰でも無料で利用できます。Windows、Mac、Linuxのすべてのオペレーティングシステムに対応しており、パソコンのOSを選ばずに同じ環境を構築できる点が大きなメリットです。

XAMPPがなぜこんなに広く使われているのかというと、複雑な設定をほぼしなくても、これ1つをインストールすればPHP開発がすぐに始められるからです。通常はApacheの設定ファイルを編集したり、MySQLのユーザー権限を設定したり、PHPが正しく読み込まれているか確認したりなど、かなりの手間がかかります。しかしXAMPPではこれらすべてが自動で行われるため、インストール直後から開発を始められます。

Windowsでの環境構築

XAMPPのダウンロード

まずはApachefriends の公式サイト(https://www.apachefriends.org)にアクセスします。ページを開くと大きなダウンロードボタンが表示されています。複数のバージョンが用意されていますが、Windows環境を使用している場合は「Windows」と表示されたボタンをクリックしてください。

ダウンロードが始まると、ファイル名は「xampp-windows-x64-[バージョン番号]-installer.exe」のようになります。ファイルサイズはおおよそ170MB程度です。ダウンロード完了まで少し時間がかかるので、インターネット接続が安定した場所で実行することをお勧めします。ダウンロードが完了したら、ファイルをダブルクリックしてインストーラーを起動します。

インストール手順

インストーラーが起動すると、言語選択画面が表示されます。デフォルトは英語ですが、日本語を選択することもできます。言語を選択したら「Next」ボタンをクリックして次に進みます。

次に表示される画面は「Select Components」です。ここでは、インストールするコンポーネントを選択します。XAMPPのパッケージには、Apache、MySQL、PHP、phpMyAdminなどが含まれていますが、すべてにチェックが入っている状態がデフォルトです。PHP開発には、Apache、MySQL、PHPが必須です。Perlを使わないのであれば、Perlのチェックを外しても問題ありません。ただ、特に理由がなければ、すべてをインストールすることをお勧めします。

次に表示されるのが「Installation Folder」画面です。XAMPPをインストールするフォルダを指定します。デフォルトは「C:\xampp」ですが、この設定のままで問題ありません。「Next」をクリックして進みます。

その後、「Bitnami for XAMPP」に関する画面が表示される場合があります。これは追加のプリセットアプリケーションのインストールオプションですが、今回は不要なので、チェックを外して「Next」をクリックしてください。

続いて、インストール内容の確認画面が表示されます。ここまでの設定が正しいかを確認して「Next」をクリックします。その後、ファイルのコピーが開始されます。インストール完了までには数分かかる場合があります。

インストール完了画面では「Finish」ボタンをクリックします。通常、XAMPPコントロールパネルが自動的に起動します。

XAMPPコントロールパネルの使い方

XAMPPをインストールすると、「XAMPP Control Panel」と呼ばれるアプリケーションが起動します。これは黒いウィンドウで、複数のサービスがリスト表示されています。主なものはApacheとMySQLです。

Apacheは、ウェブサーバーの役割を果たします。PHPファイルをブラウザで表示させるには、Apacheが起動している必要があります。「Apache」という行を見つけて、その右側にある「Start」ボタンをクリックします。Apacheが起動すると、「Start」ボタンは押せなくなり、「Stop」ボタンが表示されます。また、Apacheの左側の丸いインジケータが緑色に変わります。これはApacheが正常に起動したことを示しています。

次にMySQLも起動させます。MySQLはデータベースの役割を果たすため、データベースを使用するアプリケーション開発では必須です。「MySQL」という行を見つけて、「Start」ボタンをクリックします。Apacheと同様に、起動するとインジケータが緑色になります。

ApacheとMySQLの両方が起動したら、環境構築は完了です。

Macでの環境構築

XAMPPのダウンロード

Macでも基本的な手順はWindowsと変わりません。Apachefriends の公式サイト(https://www.apachefriends.org)にアクセスして、「Mac」と表示されたボタンをクリックしてください。

Macの場合、ファイルは「xampp-osx-[バージョン番号]-installer.dmg」という形式でダウンロードされます。ファイルサイズはWindows版と同程度で、おおよそ170MB~180MB程度です。

インストール手順

ダウンロードが完了したら、ファイルをダブルクリックします。するとディスクイメージが自動的にマウントされ、インストーラーウィンドウが表示されます。ウィンドウに「XAMPP」というアイコンが表示されているので、これをダブルクリックしてインストーラーを起動します。

インストーラーが起動すると、言語選択やコンポーネント選択などの画面が表示されます。手順はWindows版とほぼ同じです。選択画面では、すべてのコンポーネントにチェックが入った状態のままで問題ありません。

インストール先ディレクトリについて、Macのデフォルトは「/Applications/XAMPP」です。Macではアプリケーションはこのディレクトリに配置するのが通例なので、このデフォルト設定のまま進めてください。

インストール過程で管理者パスワードの入力を求められる場合があります。Macにログインしているユーザーのパスワードを入力してください。

Mac版XAMPPの起動

Macの場合、インストール完了後は自動的にXAMPPコントロールパネルが起動します。パネルのウィンドウ内に、Apache、MySQL、FTPといったサービスが表示されています。

Apacheを起動するには、「Apache Web Server」という行にある「Start」ボタンをクリックします。起動すると、ボタンが「Stop」に変わり、左側のランプが緑色に点灯します。

次にMySQLを起動します。「MySQL Database」という行の「Start」ボタンをクリックします。同様に、起動するとランプが緑色に点灯します。

Mac版でも、ApacheとMySQLが両方起動したら、PHP開発環境の準備完了です。

ブラウザで動作確認

ApacheとMySQLが起動したら、実際に動作しているかブラウザで確認してみましょう。

ブラウザを開いて、アドレスバーに「http://localhost」と入力してEnterキーを押します。すると、XAMPPのウェルカムページが表示されます。このページに「Welcome to XAMPP」というタイトルが表示されていれば、Apacheが正常に動作しています。

ウェルカムページの上部にはナビゲーションメニューが表示されています。「phpMyAdmin」というリンクをクリックすると、データベース管理ツールが開きます。ユーザー名に「root」、パスワードは空白のまま「ログイン」ボタンをクリックしてください。ログインができれば、MySQLも正常に動作しています。

PHPファイルの配置場所

XAMPPをインストールすると、「htdocs」というフォルダが作成されます。このフォルダが、Apacheがファイルを探す場所、つまりウェブサイトのルートディレクトリになります。

Windows環境の場合、htdocsフォルダの場所は「C:\xampp\htdocs」です。Macの場合は「/Applications/XAMPP/xamppfiles/htdocs」です。

PHP開発を行うときは、このhtdocsフォルダの中に、PHPファイルやHTMLファイルを配置します。例えば、「test.php」というファイルをhtdocsフォルダに保存した場合、ブラウザで「http://localhost/test.php」にアクセスすることで、そのファイルが実行されます。

PHPの動作確認

環境構築が完了したら、実際にPHPが動作するか確認してみましょう。テキストエディタ(メモ帳やVisual Studio Codeなど)を使用して、以下のコードを新規ファイルに記入してください。

<?php
echo "Hello, PHP!";
?>

このファイルを「hello.php」という名前で、htdocsフォルダに保存します。その後、ブラウザで「http://localhost/hello.php」にアクセスすると、「Hello, PHP!」というテキストが表示されます。このように表示されれば、PHPが正常に動作していることの証です。

もう少し複雑な例として、PHPのバージョン情報を表示してみましょう。テキストエディタに以下のコードを入力し、「phpinfo.php」という名前で保存します。

<?php
phpinfo();
?>

ブラウザで「http://localhost/phpinfo.php」にアクセスすると、インストールされているPHPのバージョンや、有効になっている拡張機能などの詳細情報が表示されます。

MySQLの動作確認

MySQLが正常に動作しているか確認するには、phpMyAdminを使うのが簡単です。ブラウザで「http://localhost/phpmyadmin」にアクセスしてください。phpMyAdminのログイン画面が表示されます。ユーザー名に「root」と入力し、パスワード欄は空白のままログインボタンをクリックします。

ログインに成功すると、データベース管理画面が表示されます。ここから、新しくデータベースを作成したり、テーブルを追加したり、データを入力したりできます。

新しいデータベースを作成してみましょう。画面左側にある「+」ボタンまたは「新規作成」ボタンをクリックします。データベース名を入力するフィールドが表示されるので、例えば「testdb」と入力して、「作成」ボタンをクリックしてください。データベースが作成されます。

トラブルシューティング

XAMPPを使用していて、うまく動作しない場合の対処方法を紹介します。

Apacheが起動しない場合

Apacheが起動しない最も一般的な原因は、ポート番号の競合です。ポート80番は標準的なウェブサーバーのポートですが、別のアプリケーションがすでにこのポートを使用しているかもしれません。この場合、XAMPPコントロールパネルの「Apache」の横にある「Config」ボタンをクリックして、「httpd.conf」を選択します。ファイルが開いたら、「Listen 80」という行を見つけて、数字を別のポート(例えば「8080」)に変更して保存してください。その後、ブラウザでアクセスする際には「http://localhost:8080」と指定する必要があります。

MySQLが起動しない場合

MySQLが起動しない場合は、まずコントロールパネルのMySQLの「Logs」ボタンをクリックして、エラーログを確認してください。エラーメッセージがあれば、それが問題解決の手がかりになります。多くの場合、MySQLが以前のセッションで不適切に終了したために、ロックファイルが残っている可能性があります。この場合、XAMPPのインストールフォルダ内の「data」フォルダを確認して、問題になっているファイルを削除することで解決することがあります。

PHPファイルがダウンロードされてしまう場合

PHPファイルにアクセスしたときに、ファイルがダウンロードされてしまい、実行されない場合は、Apacheの設定にPHP処理の設定が含まれていない可能性があります。コントロールパネルから「Apache」の「Config」をクリックして「httpd.conf」を開き、以下の行が含まれているか確認してください。

LoadModule php_module modules/mod_php.so
AddType application/x-httpd-php .php

これらの行がなければ、ファイルに追加して保存した後、Apacheを再起動してください。

本番環境へのステップアップ

XAMPPはあくまでローカル開発用の環境です。PHPアプリケーションを完成させて、インターネット上で公開する際には、レンタルサーバーやクラウドサーバーなど、本番環境にデプロイする必要があります。

本番環境ではセキュリティがより厳密に求められます。ローカル環境ではrootユーザーにパスワードが設定されていませんでしたが、本番環境では強力なパスワードを設定することが必須です。また、アプリケーションが必要としない機能は無効化して、サーバーへの攻撃面を減らす工夫も重要です。

まとめ

XAMPPを使用することで、PHP開発に必要な複雑なサーバー構築作業をスキップして、すぐに開発を開始できます。WindowsでもMacでも、インストール手順はほぼ同じで、数分で環境構築が完了します。本記事で紹介した手順に従えば、初心者でも確実にPHP開発環境を完成させることができます。まずはXAMPPでローカル環境を整備し、思う存分PHPの学習と開発に取り組んでください。

コメント

タイトルとURLをコピーしました