PHP開発環境構築｜Docker・VSCode・XAMPPなどWindows・Mac対応の完全ガイド

公開したサービスでは、レンタルサーバーなどを利用したオンライン環境が必須ですが、PHPを学ぶ環境としては、自身のパソコンに構築したローカル環境で開発を進めるのがおすすめです。その最大の理由は実行確認のしやすさです。ファイルを保存してすぐにブラウザで反映結果を確認できるため、学習効率が高まるでしょう。

また、インターネット接続が不要な点もローカル環境の魅力です。ネット環境に左右されず、自宅でも出先でも自由に学習を進められます。

PHP開発環境を構築する流れ

PHPの開発環境を構築する一般的な流れは次の通りです。

Webサーバーの確保
PHP・データベースの
コードエディタの導入
テストファイルの作成と実行確認
設定ファイルの調整

まずは、Webサーバーを確保しましょう。レンタルサーバーでも良いですし、自身のパソコンにローカルサーバーを準備しても良いでしょう。

サーバーが確保出来たら、PHPやデータベースを導入してください。セットで導入できるツールとして代表的なものにXAMPPやMAMPがあります。数回のクリックで必要な構成が整うので活用するのがおすすめです。

必要に応じて、Dockerを用いた仮想環境の構築もこの時点でやっておくと良いでしょう。

次に、コードを書くためのエディタをインストールします。インストール後は、PHPファイルを作成し、サーバーに配置して動作を確認しましょう。ファイルが正常に読み込まれ、意図通りの表示が確認できれば、環境構築は成功です。

必要に応じて、設定ファイルであるphp.iniを編集してください。たとえば、エラーメッセージの表示設定やタイムゾーンの変更などが可能です。

2.PHPの開発環境でおすすめを紹介

PHPの開発環境で、どのツールを使えばいいのか？悩むことがあります。さまざまなツールがあり選択肢が多く、自身のスキルレベルや目的に合ったツールを見極めなければなりません。

ここでは、初心者向けと実務向けの代表的な開発環境を紹介し、それぞれの特徴や適した利用シーンを紹介します。

PHPの開発環境でおすすめツール一覧

ツール名	対応OS	難易度	特長	想定ユーザー
XAMPP	Windows / Mac / Linux	低	初心者向け、一体型で手軽	初学者・入門者
MAMP	Mac / Windows	低	GUI操作がわかりやすい	Macユーザー
Laragon	Windows	中	軽量・高速・多機能	学習＋実務中級者
Docker	全OS対応	高	柔軟で実務向けの構成が可能、チーム開発向き	中級以上・チーム開発者
VSCode	全OS対応	中	軽量、拡張性が高く、IDE的に使える	初心者〜中級者
PHPStorm	全OS対応	中〜高	実務向け、豊富な機能が充実、有償	現場エンジニア

学習目的ならXAMPP・MAMPがおすすめ

PHPをこれから学び始める人には、XAMPPやMAMPのような一体型パッケージを利用した開発環境がおすすめです。これらには、WebサーバーのApache、データベースのMySQL、PHP本体がすべて含まれていて、複雑な設定をせずにすぐ使い始めることができます。

いずれも、PHPの基本的な書き方を学んだり、フォーム送信やデータベース接続といった初歩的な処理を試すには十分な機能を備えています。XAMPPやMAMPを使って、PHPに慣れるところから始めてみましょう。

実務ならDocker・IDEがおすすめ

ある程度PHPの基礎を理解していて、より本格的な開発やチームでの作業を視野に入れるなら、DockerやIDEの導入を検討すべきです。

Dockerは、アプリケーションをコンテナとして動作させる仕組みです。PHPのバージョンや依存ライブラリをプロジェクトごとに柔軟に切り替えられるため、実務で求められる再現性や保守性の高い環境を実現できます。また、複数人で開発を行う場合も、環境の差異による不具合を最小限に抑えられます。

Docker Composeを使えば、PHPだけでなくApacheやMySQLも含めた構成を簡単に管理できます。開発初期に構築した環境をそのまま本番に近い形で運用できるのも大きなメリットです。

IDEについては、PHPStormがおすすめです。コード補完やシンタックスチェック、ブレークポイントを用いたデバッグ機能、Gitやデータベースとの連携など、業務に必要な機能を幅広く備えています。開発の生産性を高めたい場合に非常におすすめのツールです。

Visual Studio Codeも優秀で、多くの拡張機能を組み合わせれば、IDEに近い機能を実現できます。

PHPの開発環境でWindowsのおすすめはXAMPP・Laragon

WindowsでPHPを学習・開発する場合、XAMPPがおすすめです。PHP、Apache、MySQLがひとつのインストーラーにまとめられており、導入が非常に手軽です。

ボタン操作で各サービスの起動や停止を管理できるため、コマンド操作に慣れていない初心者でも扱いやすい環境といえるでしょう。

WindowsユーザーにはLaragonもおすすめです。XAMPPよりも動作が軽快で、PHPやMySQLのバージョンを柔軟に切り替えられる点が魅力です。

将来的にフレームワークを扱いたい方や、複数のプロジェクトを並行して扱う予定がある方には、Laragonが適しているかもしれません。

PHPのローカル環境をwindowsで作るときに気をつける設定ポイント

WindowsでPHPのローカル環境を構築する場合には、いくつか注意すべき点があります。

まず1つ目はポート番号の競合です。ApacheやMySQLが起動しない場合の原因として多いのが、ポート番号の競合です。

Apacheはポート80を使用しますが、SkypeやIISなど他のアプリケーションと重なると起動に失敗することがあります。必要に応じて、使用ポートを変更するか、競合アプリを一時停止して対応しましょう。

また、ファイルパスの扱いにも注意が必要です。Windowsではバックスラッシュ（\）が使われますが、PHP内ではスラッシュ（/）の方が安全で汎用性が高いため、パス指定時には意識して使い分けることが推奨されます。

なお、ファイアウォールやセキュリティソフトがApacheやMySQLの通信をブロックしてしまうケースも見られます。インストール後に動作しない場合は、これらの設定も確認してみてください。

PHPの開発環境でmacのおすすめはMAMP

macOSでPHPを使いたい場合は、MAMPがおすすめです。インストーラー形式でApache、MySQL、PHPがまとめて導入できます。

GUI操作でサーバーの起動や設定が行えるため、ターミナルに不慣れな方でも安心です。MAMPには無料版とPro版がありますが、学習目的であれば無料版でも十分です。

一方、コマンドライン操作に抵抗がなければ、Homebrewを使って個別にApacheやPHP、MySQLを導入する方法もあります。バージョン管理や細かな設定が可能となるため、より柔軟で実践的な環境構築が実現できます。

Macには元々PHPがプリインストールされていることもありますが、古いバージョンである場合が多く、Homebrewで最新版に置き換えることが可能です。Mac特有の構成やパーミッション管理に慣れておくと、後々フレームワークの導入や本格開発への移行もスムーズに対応できるでしょう。

UNIXとLinuxの違いとは？共通点や選択基準などをわかりやすく解説

PHPでできること・できないことを解説！初心者でも作れるものや学習方法も紹介

3.PHPの開発環境でdockerを使ってみましょう

PHPの開発に慣れてきたら、より柔軟で効率的な環境構築を目指してみましょう。実務では、チームで同じ環境を共有したり、プロジェクトごとに異なる構成を維持したりする必要があります。そんな時に役立つのがDockerを活用した開発環境です。

Dockerを使えば、ApacheやMySQL、PHPのバージョンを自由に切り替えられるだけでなく、すべての構成をコード化して管理できます。ここでは、Dockerの基礎から具体的な構成例、さらにはphp.ini設定やデータ永続化の注意点までを解説します。

Dockerとは？仮想環境の基礎とメリット

Dockerはアプリケーションをコンテナと呼ばれる仮想環境上で動かします。通常の仮想マシンとは異なり、ホストOSのカーネルを共有することで軽量かつ高速な動作を実現しています。PHPのようなWebアプリケーション開発においても、この仕組みは非常に有用です。

最大のメリットは、開発環境をまるごとコードで再現できることです。Apacheの設定やPHPのバージョン、MySQLの構成まで、すべてをDockerfileやYAMLファイルに記述することで、同じ環境を何度でも構築できるようになります。このおかげで、チーム全員が同じ環境で開発でき、動作確認やコードの修正もスムーズに対応可能です。

また、ローカル環境の設定ミスやOS依存の問題を回避できる点も見逃せません。フレームワークを導入する場合や、外部パッケージとの整合性を保ちたい場合に、Dockerは強力な武器になります。開発から本番運用まで、一貫した構成を維持したい場合にはぜひDockerの導入を検討してみてください。

Docker Composeを使った構成

PHPの開発にDockerを活用する場合、Docker Compose を使えば、複数のコンテナを連携させた構成を簡単に管理可能です。たとえば、PHPを動かすためのApacheコンテナと、データベース用のMySQLコンテナをそれぞれ作成し、ネットワークでつなぐことが可能です。

具体的には、docker-compose.yml というファイルに次の情報を記述します。

ApacheとPHPを統合したWebサーバーのイメージ
MySQLのバージョンや初期設定
ボリュームのマウントによるソースコードの共有
各サービス間のネットワーク設定

このファイルを用意すれば、docker-compose up のコマンドひとつで、複数のコンテナが自動で立ち上がります。手動でインストールや設定を行う必要がないため、環境構築の手間が大幅に減らせるでしょう。

また、コンテナごとに設定を分けて管理できるため、PHPのバージョンを変更したり、MySQLを別のデータベースに置き換えたりする場合にも、必要な箇所だけを修正すればよくなるのが便利です。バージョン管理や再構築が多い案件では、この柔軟性が大きく貢献してくれます。

php.ini設定

Docker環境でPHPを運用するには、php.iniの設定に注意してください。デフォルトでは一部の設定が最適化されていないため、開発に必要な項目を明示的に調整する必要があります。たとえば、エラー表示やログの出力の有効化設定は、ぜひ設定しておきたいポイントです。

設定ファイルは、Dockerfileやdocker-compose.ymlでマウントすることでコンテナに反映させられます。ホスト側の設定ファイルをそのままコンテナ内に読み込むことで、カスタマイズも柔軟に対応可能です。

エラー表示の有効化

初期状態では、エラーが非表示になっているケースが多く、原因不明の真っ白な画面に悩まされることも少なくありません。そのような状況を防ぐためには、php.ini を編集してエラー表示を有効にしましょう。次の2つの項目を確認・変更してください。

display_errors = On

error_reporting = E_ALL

この設定によって、致命的なエラーだけでなく、警告や注意レベルのメッセージも表示されるようになります。設定後はWebサーバーを再起動してください

ログ出力の有効化

ログ出力を有効にしておくと、画面に表示されないエラーでもログファイルから原因を追跡できるようになります。

log_errors = On

error_log = "/path/to/php-error.log"

データの永続化

もうひとつ重要なのがデータの永続化です。Dockerコンテナは停止や再作成によって内部のデータが消える仕様になっているため、MySQLのデータベースやPHPのログ、アップロードファイルなどは、必ずホスト側のディレクトリにボリュームとして保存する設定を加えておかなければいけません。

volumes オプションを使って /var/lib/mysql や /var/www/html などをマウントしておけば、コンテナを削除してもデータは残ります。

Laravel【PHP】とは？入門のためのインストール方法やコード付きで解説

phpの三項演算子とは？issetや省略、echoと複数条件の使い方と実例を解説

4.PHPの開発環境でVisual Studio Codeを使ってみましょう

PHPの開発環境にはエディタ選びも重要です。Visual Studio Code（VSCode）は、PHPの初心者からベテランまで幅広く支持を集めています。無料でありながら、軽い動作と豊富な拡張機能を兼ね備えたエディタとして、IDE並みの機能を備えている点も大きな魅力です。

ここでは、VSCodeをPHP開発に最適化するための拡張機能や初期設定、さらに補完やデバッグといった実用的な機能について解説します。

PHPの開発環境でVSCodeに必要な拡張機能と初期設定

VSCodeをPHPの開発環境として使うには、拡張機能を導入すると作業効率が大きく向上します。まず基本として入れておきたいのが「PHP Intelephense」です。PHP Intelephenseはコード補完・関数ジャンプ・構文チェック・ドキュメントの表示など、PHPの開発に欠かせない機能を一通り備えています。

次に「PHP Debug」も導入するのをおすすめします。Xdebugと連携することで、ブレークポイントやステップ実行、変数のウォッチといった高度なデバッグ機能が使えるようになります。開発中のエラー原因を特定しやすくなり、コードの品質が向上するでしょう。

また、「Prettier」や「PHP CS Fixer」などのコード整形ツールを組み合わせると、記述スタイルが統一され、可読性の高いコードを維持しやすくなります。チームで開発を行う場合にも、こうした自動整形の仕組みは大きな効果を発揮しますので、導入を検討してみてください。

初期設定としては、文字コードや改行コードの統一、タブ幅の設定なども確認しておきたいポイントです。VSCodeの設定画面から、プロジェクト全体に適用する基本設定を整えておくことで、開発の効率が高まるはずです。

デバッグ・補完・LintなどIDE的機能を使いこなす

VSCodeは、適切な拡張機能を導入すれば、IDEとしても十分に活用できます。なかでも注目すべきは、デバッグ・補完・コード診断（Lint）の機能です。これらを使いこなすことで、開発効率とコードの信頼性が格段に向上します。

Dockerとは〖初心者向け〗コンテナの仕組みや使い方、基本コマンド、学習法までわかりやすく解説

5.PHPの開発環境でXAMPPを使わない方法

XAMPPは手軽に使える開発環境として人気がありますが、XAMPPを使わずPHP環境を整えることも可能です。ここではXAMPPを使わない方法で、Apache・MySQL・PHPを個別に導入する方法などについて解説します。

Apache・MySQL・PHPを個別にインストールする方法

XAMPPを使わずに開発環境を構築する場合、Apache・MySQL・PHPをそれぞれ単独でインストールして構成を手動で整えなければなりません。主導で対応するメリットとしては、構成を細かく制御できる点があります。それぞれのソフトウェアのバージョン選定や設定変更が自由にできるため、本番に近い環境の再現や、特定の仕様に合わせた調整がしやすいです。

まず、Apacheを公式サイトからダウンロードし、適切なディレクトリに配置します。インストール後は、設定ファイル（httpd.conf）でポート番号やドキュメントルートの指定を行います。

次にPHPを導入し、Apacheと連携させるためにmod_phpやphp.iniのパス設定を行います。MySQLは、MySQL Community EditionやMariaDBをインストールし、初期パスワードの設定や文字コードの指定を忘れずに行いましょう。

これらの設定はすべて自分で記述・確認しなければなりませんが、そのぶん動作の仕組みを深く理解できることがスキル向上に大きなメリットとなるでしょう。実務環境では、こうした手動構築スキルが役立つ場面が多くあります。

GUIに頼らないことのメリット

XAMPPのようなGUIツールは便利で直感的ですが、コマンドラインや設定ファイルに慣れることで得られる知識やスキルは、エンジニアとしての基盤になります。

たとえば、Apacheの設定ファイルを直接編集すれば、ポートの変更やリダイレクトの追加、SSL対応の有効化といった高度な設定も自在に扱えるようになります。

また、MySQLではコマンドを使ったデータベース操作を習得することで、SQLの構文理解や、エラーハンドリング能力も自然と養われるでしょう。GUIでは隠れてしまいがちな動作の裏側を意識することで、トラブル対応力や応用力が高まることも期待できます。

もちろん最初からすべてを手動で行う必要はありませんが、ステップアップを目指すのであれば、GUIに頼り切らない姿勢が重要です。少しずつコマンドラインや設定ファイルに触れておくと、現場での適応力に大きな差がつくでしょう。

6.まとめ

本記事では、PHPの開発環境について基礎知識から構築方法、目的別ツールの選び方、DockerやVSCodeの活用法までをくわしく解説しました。

初心者でも迷わず環境構築を進められるよう、実践的なポイントを押さえています。PHPを動かす準備が整ったら、ぜひ実際にコードを書いて学習をスタートしてみてください。

本記事が皆様にとって少しでもお役に立てますと幸いです。

「フリーランスボード」は、数多くのフリーランスエージェントが掲載するITフリーランスエンジニア・ITフリーランス向けの案件・求人を一括検索できるサイトです。

開発環境、職種、単価、稼働形態、稼働日数など様々な条件から、あなたに最適なフリーランス案件・求人を簡単に見つけることができます。

単価アップを目指す方や、自分の得意なスキルを活かせる案件に参画したい方は、ぜひ「フリーランスボード」をご利用ください。

自身に最適なフリーランスエージェントを探したい方はこちらよりご確認いただけます。