Laragon番外編1｜複数バージョンを追加・切り替える仕組みを理解する

Laragonを使ってPHPやWordPressを学んでいると、「PHPのバージョンを変えて確認したい」「Apacheではなくnginxでも動かしてみたい」「Node.jsやPython、Go、Ruby、Javaなども同じローカル環境で扱えないだろうか」と思うことがあります。

Laragonは、PHPを動かすためだけのローカル開発環境ではありません。

ApacheやnginxなどのWebサーバー、MySQLなどのデータベース、PHP・Node.js・Python・Go・Rubyなどの言語・実行環境を、用途に合わせて追加したり、複数のバージョンを切り替えたりできる開発環境です。

さらに番外編10では、Java 25とMaven 3.9.16もLaragon環境へ組み込み、Javaプログラムの実行からMavenによるビルド、JAR実行まで検証しています。

ただし、すべてのソフトウェアを同じ方法で追加・切り替えられるわけではありません。

Quick addから追加しやすいもの、Laragonでは複数バージョン管理できてもQuick add一覧には含まれていないもの、手動で組み込むものなど、それぞれ扱い方が異なります。

この番外編1では、Apache・nginx・MySQL・phpMyAdmin・PHP・Node.js・Python・Go・Ruby・Ruby on Rails・Java・MavenなどをLaragon環境で扱うための土台として、Laragonが複数の開発環境をどのように管理しているのか、その基本的な考え方を整理します。

Laragon番外編1で学ぶこと

番外編1の目的は、個別のソフトを追加する前に「Laragonの中で何が起きているのか」を理解することです。

今回確認する内容は次のとおりです。

ここを理解しておくことで、番外編2以降で行うApache・nginx・MySQL・PHPなどの操作についても、「何を変更しているのか」が分かりやすくなります。

Laragonを「PHPを動かすソフト」から一歩進んで理解する

PHP学習を始めたばかりの段階では、Laragonを「PHPやMySQLを簡単に動かせるソフト」として使うだけでも十分です。

しかしLaragonの内部では、Webサーバー、データベース、実行環境、設定ファイル、Webプロジェクトなどが、それぞれ役割を分けて管理されています。

必要なソフトウェアやバージョンを組み合わせて、自分の目的に合ったローカル開発環境を構成できることがLaragonの大きな特徴です。

ひとつのPHP環境を固定して使うだけではなく、必要に応じて環境そのものを組み替えられます。

この番外編では実際の開発環境を使って確認する

Laragon番外編では、設定方法を紹介するだけでは終わりません。

実際にLaragon上で環境を追加・切り替えながら、

• Laragonのメニューではどのように認識されるのか
• Laragon Terminalではどのバージョンが実行されるのか
• WordPressなどのWebアプリケーションが正常に動作するのか
• 設定ファイルはどこにあるのか
• 問題が起きたときに元の環境へ戻せるのか

まで確認します。

また、このシリーズでは記事を制作する時点のLaragon公式仕様と、各ソフトウェア側の現行仕様を確認しながら進めます。

古いLaragonの記事や過去の画面だけを参考にせず、実際の環境で確認した内容を記事化していきます。

Laragonは複数の開発環境を管理できる

LaragonはPHPだけではなく、Webサーバー・データベース・複数の実行環境をまとめて扱える開発環境です。

Laragonでは、Apache・nginx・PHP・MySQL・PostgreSQL・Node.js・Python・Ruby・Goなど、複数の技術を管理できます。

この番外編では、その中からToshiLabで実際に利用していく技術を中心に確認します。

Apache・nginxなどのWebサーバー

Apacheとnginxは、Webブラウザからのリクエストを受け取り、Webページを返すWebサーバーです。

Laragonでは、代表的なWebサーバーとしてApacheとnginxを扱えます。

WordPressのローカル環境ではApacheを利用する機会が多い一方、nginxでもWordPressを動かすことができます。

ただし、nginxではApacheで利用される .htaccess をそのまま使う仕組みではありません。

この違いは、Laragon番外編2で実際にWordPressをApacheからnginxへ切り替えながら確認しました。

MySQLなどのデータベース

MySQLは、PHPのような実行環境ではなく、WordPressなどが利用する実際のデータを保持するデータベースです。

WordPressでは記事・設定・ユーザー情報など、多くの情報がデータベースへ保存されます。

LaragonではMySQLのほか、PostgreSQLなども扱えます。

一方で、データベースはPHPのような実行環境とは性質が大きく異なります。

phpMyAdminはデータベース本体ではなく管理ツール

MySQLはデータベース本体、phpMyAdminはデータベースをWebブラウザから操作するための管理ツールです。

この2つは別のソフトウェアです。

そのため、

MySQLを追加すること
＝
phpMyAdminを追加すること

ではありません。

現在のLaragonでは、phpMyAdminは必要に応じてQuick addから追加して利用します。

この違いもLaragon番外編3で実際に確認しました。

PHP・Node.js・Python・Go・Rubyなどの実行環境

Laragonを使うと、PHPだけでなく複数のプログラミング言語や実行環境をひとつのローカル開発環境で扱えます。

たとえば、

• PHPでWordPressやLaravelを動かす
• Node.jsでJavaScriptを実行する
• npmを利用する
• Next.jsなどの開発環境へつなげる
• Pythonのプログラムを実行する
• GoでWebサーバーやAPIを作る
• Rubyのプログラムを実行する
• Ruby on RailsでWebアプリケーションを作る
• Javaのプログラムをコンパイル・実行する
• MavenでJavaプロジェクトをビルドする

といった方向へ広げられます。

LaragonをPHP専用環境としてだけ見るのではなく、複数のWeb開発技術を扱うための基盤として考えると、その役割が分かりやすくなります。

RubyもLaragonの複数バージョン管理対象

現在のLaragonでは、RubyもMulti-Version Servicesの対象として扱われています。

Laragon番外編では、Python・Goに続いてRubyを実際に追加し、Laragonから利用できる状態まで確認しました。

さらにRubyの環境を確認したあと、Ruby on Railsを導入してWebアプリケーションを動かすところまで検証しました。

PostgreSQLについては、必要性や今後の開発内容に応じて別途検証します。

Java・JDK・Mavenは
Laragon標準の複数バージョン管理とは分けて考える

Java・JDKは、PHPやGoと同じLaragon標準の複数バージョン管理対象として扱わず、Laragon環境へ組み込んで利用する方法を番外編10で実際に検証しました。

今回の実機環境では、Eclipse Temurin JDK 25.0.4.1+1をC:\laragon\bin\java\へ配置し、Laragon再起動後にJavaとJAVA_HOMEが認識されることを確認しています。

さらにApache Maven 3.9.16もLaragon配下へ追加しました。

ただしMavenは、Javaと同じように配置しただけではmvnコマンドとして認識されなかったため、Laragon TerminalのPATHに含まれているC:\laragon\usr\binへmvn.cmdを用意して利用しました。

Laragon番外編10では、

・Java 25とJDKの確認

・JAVA_HOME

・javaとjavac

・VS CodeでのJava実行・デバッグ

・Apache Maven 3.9.16

・Mavenプロジェクトの生成

・JUnitテスト

・Java 25をターゲットにしたMavenビルド

・実行可能JARの作成とjava -jarによる実行

まで実際に確認しています。

Laragonのフォルダ構成を理解する

Laragonで複数バージョンを扱うなら、まず bin・data・www・usr の役割を区別できることが重要です。

Laragonのルートフォルダには、主に次のフォルダがあります。

• bin
• data
• www
• usr
• etc
• tmp

それぞれの役割を確認していきます。

bin｜PHPやApacheなどの実行環境を置く場所

bin は、Laragonで利用するPHP・Apacheなどの実行環境を管理する場所です。

Apache・nginx・PHP・MySQLなどの実行環境を確認するときは、この周辺を見ることになります。

複数のPHPを利用する場合も、バージョンごとの環境をLaragon内へ共存させ、使用するものを切り替えるという考え方になります。

data｜MySQLなどのデータを保存する場所

data は、MySQLなどが実際のデータを保存する場所です。

ここは bin と意味が大きく異なります。

bin がソフトウェア本体や実行環境を扱う場所なのに対して、data は自分が作成したデータを保持します。

bin 内のMySQL本体と、data 内のデータを同じものとして扱わないようにします。

データベース関連の作業では、変更前のバックアップを基本とします。

www｜WordPressやWebアプリを置く場所

www は、WordPressやWebアプリケーションなどのプロジェクトを配置する場所です。

たとえば、

• WordPress
• PHPアプリケーション
• Laravel
• HTML・CSS・JavaScriptで作ったWebサイト

などを配置できます。

Laragonを日常的に使っていると、もっとも触れる機会が多いフォルダのひとつです。

usr｜Laragonのユーザー側設定を保存する場所

usr は、Laragonのユーザー側設定を保持する重要な場所です。

Laragonでは、ユーザーが変更した設定を本体側と分離して管理できる構成になっています。

Quick addで利用する packages.conf も usr 配下にあります。

etc｜共有設定や各種設定を置く場所

etc は、Apacheやnginxなどの設定を確認するときに重要になる場所です。

今後Apacheやnginxを扱うと、Virtual Hostなどの設定でこの周辺を見ることになりました。

特にLaragon番外編2では、Apacheとnginxの設定ファイルの違いまで確認していきました。

tmp｜一時ファイルを保存する場所

tmp は名前のとおり、一時的なデータを保存する場所です。

bin・data・www などと比べると、通常の学習で直接操作する機会は多くありません。

まずは、

実行環境 → bin
データ → data
Webプロジェクト → www
ユーザー設定 → usr

という違いを押さえておけば十分です。

「複数バージョンを入れる」とはどういうこと？

Laragonの複数バージョン管理では、現在の環境を削除して最新版へ置き換える必要はありません。

複数の環境をLaragon内へ共存させ、必要なものを選択して利用できます。

Windows全体へ何度もインストールするわけではない

Laragonは開発環境をLaragon側に分離して保持できます。

そのため、Windows全体へ複数のPHPやWebサーバーを何度もインストールするのではなく、Laragonの管理下へ環境をまとめられます。

Windows側をできるだけ汚さず、開発用環境をLaragon内部で管理できることも大きな特徴です。

Laragon内にバージョンごとのフォルダを共存させる

たとえばPHPであれば、

• 現在利用しているPHP
• 新しく試したいPHP
• 互換性確認用の旧PHP

などを共存させることができます。

既存環境をすぐに削除せず、新しい環境を追加して比較・検証できることがポイントです。

使用するバージョンをLaragonから選択する

Laragonが複数バージョンを認識すると、対応するメニューから使用するバージョンを選択できます。

PHPなら、LaragonのPHPメニューから目的のバージョンを選ぶという流れです。

「複数のバージョンを持っていること」と「現在どのバージョンを使用しているか」は別に考えます。

Profile（Multi-Stack）という考え方もある

Laragonには、個別のバージョン切り替えだけでなく、複数の技術構成をまとめて切り替えるProfile（Multi-Stack）という仕組みもあります。

たとえば、

環境A

• PHP
• MySQL
• nginx

環境B

• 別バージョンのPHP
• 別バージョンのMySQL
• Apache

のように、異なる開発構成を使い分けることもできます。

この番外編では、まず各ソフトウェアをひとつずつ理解してから、必要に応じて複数構成の管理へ進みます。

プロジェクトの互換性確認に複数バージョンを使う

複数バージョン管理の目的は、必ずしも「最新版を使うこと」ではありません。

たとえば、

• WordPressが新しいPHPで正常に動くか
• WordPressプラグインが対応しているか
• LaravelプロジェクトのPHP要件を確認する
• 古いプロジェクトを再現する
• 本番環境に近いバージョンをローカルで再現する
• バージョンアップ前後を比較する

といった用途があります。

Quick addとは

Quick addは、Laragonから対応パッケージを追加しやすくするための機能です。

すべての環境を自分で探してダウンロード・展開する必要を減らせます。

Laragonからパッケージを追加できる機能

Quick addでは、Laragonのメニューから対応しているパッケージを選択して追加できます。

PHP・Apache・nginx・Node.js・phpMyAdmin・MySQL・PostgreSQL・MongoDB・Goなど、複数のパッケージを扱えます。

Quick addと複数バージョン管理は同じ意味ではない

Quick addとMulti-Version Servicesは別の仕組みです。

ここは今回の記事で特に重要です。

たとえばPythonはMulti-Version Servicesの対象として扱われますが、Quick addの標準一覧とは分けて考える必要があります。

逆にphpMyAdminはQuick addから追加できますが、PHPやWebサーバーのような「実行環境を切り替えるサービス」と同じものではありません。

packages.confの役割

Quick addで利用するパッケージ情報は設定ファイルで管理できます。

標準の設定ファイルは、

{LARAGON_ROOT}\usr\packages.conf

{LARAGON_ROOT}\usr\packages.conf

です。

LaragonのメニューからQuick addのConfigurationを開いて確認することもできます。

番外編1では、Quick addもLaragon内部の設定によって成り立っているということを理解しておけば十分です。

実際に設定を変更する必要がある場合は、その対象記事で確認します。

Quick addにない環境はどうする？

Quick addに表示されない環境でも、Laragonで利用できる場合があります。

Quick addは環境追加のひとつの方法であり、Laragonで開発環境を追加する唯一の方法ではありません。

ZIPなどを展開して手動で追加する考え方

Windows向けにZIP形式などで配布されているソフトウェアでは、適切な場所へ展開してLaragonから利用する方法があります。

ただし、単純にLaragonのどこかへZIPを展開すればよいわけではありません。

Laragonが認識できるフォルダ構成を理解する

手動追加では、

• どのフォルダへ配置するのか
• Laragonがどのように認識するのか
• 必要な設定ファイルはあるのか
• PATHはどう扱われるのか

などを確認する必要があります。

PHPで成功した追加方法を、そのままPythonやJavaへ流用できるとは限りません。

Pythonでは現行仕様を確認して追加する

PythonはLaragonで複数バージョンを扱える対象ですが、追加方法についてはその時点のLaragonとPython側の仕様を確認して判断します。

Laragon番外編6では、Python・pip・venvまで含めて実際の環境で検証しました。

Rubyは手動追加してLaragonから利用する

RubyはLaragonのMulti-Version Servicesの対象ですが、Quick addの標準一覧から追加するものとは分けて考えます。

Rubyを利用する場合は、Ruby本体をLaragonの所定フォルダへ追加し、Laragon Terminalから実際に利用できるRubyのバージョンを確認します。

Rubyの導入方法と複数バージョンの扱いについてはLaragon番外編8で実際に検証しました。

その後、番外編9ではRuby on Railsを導入し、Webアプリケーションを起動するところまで確認しました。

Java・JDK・Mavenではさらに扱い方が異なる

Java・JDKについては、Laragon標準のMulti-Version Servicesと同じものだとは考えません。

番外編10では、JDK 25をLaragon配下へ配置してJavaとJAVA_HOMEの認識を確認し、VS Codeからの実行・デバッグまで検証しました。

さらにMaven 3.9.16を追加し、Laragon Terminalからmvnを利用できる構成を作成しています。

同じLaragon配下へ追加する場合でも、JavaとMavenでは認識方法が異なることを実機で確認できました。

バージョンを切り替える基本的な流れ

Laragonでのバージョン変更は、「追加 → 選択 → 反映 → 実際のバージョン確認」の4段階で考えると分かりやすくなります。

新しいバージョンをLaragonへ追加する

Quick addを利用する場合もあれば、公式配布ファイルを利用して手動で追加する場合もあります。

この時点で、正常に動作している既存バージョンを削除しないことが基本です。

まず新しい環境を追加し、正常に動作することを確認します。

Laragonのメニューから使用するバージョンを選ぶ

Laragonが新しい環境を認識したら、使用するバージョンを選択します。

選択できることは、Laragonがその環境を認識していることを確認するひとつの目安になります。

Laragonを再読み込み・再起動する

バージョンやサービスを変更した場合は、必要に応じて再読み込みや再起動を行います。

古いサービスやTerminalをそのまま利用していると、変更前の状態が残る場合があります。

Terminalから実際のバージョンを確認する

最後は必ず、実際に呼び出されているバージョンを確認します。

代表的な確認コマンドは次のとおりです。

PHP：

php -v

Node.js：

node -v

Python：

python --version

Go：

go version

Ruby :

ruby --version

Java：

java -version

Javaコンパイラ：

javac -version

echo %JAVA_HOME%

Maven：

mvn -version

Laragon Terminalで環境を確認する

Laragon Terminalは、Laragonが用意した開発環境を実際に確認するための重要な場所です。

Windows全体のPATHとLaragon Terminalから利用される環境が、必ずしも同じとは限りません。

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

PHPでは、

php -v

を実行します。

Laragonで選択したPHPと、実際に表示されたPHPバージョンが一致しているか確認します。

Node.jsのバージョンを確認する

Node.jsでは、

node -v

を利用します。

Get-ExecutionPolicy -List

Get-ExecutionPolicy -List

npmも確認する場合は、

npm -v

を実行します。

Pythonのバージョンを確認する

Pythonでは、

python --version

などを利用します。

Windows側にもPythonがインストールされている場合は、どのPythonが実行されているのかを確認する必要があります。

Goのバージョンを確認する

Goでは、

go version

を利用します。

ここでも、Laragonで利用したいGoと実際にTerminalから呼び出されるGoが一致していることを確認します。

Rubyのバージョンを確認する

Rubyでは、

ruby --version

を利用します。

RubyがWindows側にもインストールされている場合は、Laragon Terminalから実際にどのRubyが呼び出されているのかも確認します。

Java・JDKの環境を確認する

Javaでは、

java -version

を利用します。

Javaコンパイラでは、

javac -version

を利用します。

あわせて、

echo %JAVA_HOME%

を実行し、JDKの参照先も確認します。

Laragon番外編10では、Java 25.0.4.1とJAVA_HOMEがLaragon配下のJDKを参照していることを実機で確認しました。

Mavenのバージョンを確認する

Mavenでは、

mvn -version

を利用します。

Laragon番外編10では、Apache Maven 3.9.16がJava 25.0.4.1を利用していることまで確認しました。

JavaとMavenではLaragonからの認識方法が異なったため、単にバージョン番号だけではなく、どの実行環境が呼び出されているのかも確認することが重要です。

WindowsのPATHへ追加するかは別の話

Laragon内で使えることと、Windows全体のPATHへ登録することは別の設定です。

Laragon Terminal内だけで利用するのであれば、必ずしもWindows全体の環境変数を変更する必要はありません。

バージョンを変更するときに注意したいこと

Laragonで「切り替えられる」ことと、「安全に切り替えてよい」ことは同じではありません。

特にデータベースや既存プロジェクトでは、変更前の確認が重要です。

実行環境とデータを同じものとして扱わない

PHP・Node.jsなどの実行環境と、MySQLなどのデータベースでは扱うものが違います。

PHP本体を切り替えることと、実際のデータを保持するデータベースサーバーを変更することは同じではありません。

MySQLはPHPのように気軽に切り替えない

MySQLでは、

• データディレクトリ
• バージョン間の互換性
• アップグレード方法
• バックアップ

などを確認する必要があります。

データを扱う環境では、切り替え操作よりバックアップを先に考えます。

設定ファイルや拡張機能の違いにも注意する

PHPを変更した場合でも、

• php.ini
• PHP拡張機能
• Composer
• WordPress
• WordPressプラグイン
• Laravelなどのフレームワーク

との互換性が関係します。

PHP本体が起動しただけでは、既存プロジェクトが正常に動作することまでは確認できません。

バージョン変更前に元の環境へ戻せる状態を残しておく

複数バージョン管理の利点は、現在正常に動いている環境を残したまま新しい環境を試せることです。

Laragon番外編の全体構成

Laragon番外編では、PHP学習用として使っていたLaragonから一歩進み、自分で開発環境を構成・検証できるところまで進めます。

• Laragon番外編1｜複数バージョンを追加・切り替える仕組みを理解する
• Laragon番外編2｜Apache・nginxを追加・切り替える｜WordPressをnginxで動かす
• Laragon番外編3｜MySQL・phpMyAdminを追加・切り替える
• Laragon番外編4｜PHPの複数バージョンを追加・切り替える
• Laragon番外編5｜Node.js・npmをLaragonで使う
• Laragon番外編6｜Python・pip・venvをLaragonで使う
• Laragon番外編7｜GoをLaragonで使う
• Laragon番外編8｜RubyをLaragonに追加・切り替えて使う
• Laragon番外編9｜Ruby on Railsの開発環境をLaragonで構築する
• Laragon番外編10｜Java 25とMaven 3.9.16をLaragon環境へ導入する

今後の予定

番外編10のJava・Maven環境を土台として、次はSpring Bootを使ったJavaのWeb開発環境も実機で確認する予定です。

その後は、Laragon環境のバックアップ・復元を扱う記事、またはLaragon番外編全体を整理するまとめ記事へ進むことを検討しています。

今後の構成は、実際の検証内容とシリーズ全体の流れを確認しながら決定します。

番外編2からは、実際のLaragon環境を操作しながら進めます。

Laragon番外編1のまとめ

Laragon番外編1では、実際のバージョン追加へ進む前に「Laragonが何を、どこで管理しているのか」を整理しました。

Laragonの内部構造が分かると、これから行う操作が「どこを、何のために変更しているのか」見えやすくなります。

番外編1は、これから複数の開発環境を扱うための土台です。

次回からは、実際のWebサーバーや実行環境を操作していきます。

次に読む｜Laragon番外編2へ

Laragon番外編1では、複数バージョンを扱うための基本的な仕組みと、Laragonが開発環境をどのように管理しているのかを整理しました。

bin・data・www・usr などのフォルダの役割、Quick addと複数バージョン管理の違い、そして「追加 → 選択 → 反映 → 確認」という基本的な流れが分かれば、次はいよいよ実際の環境を操作して確認する段階です。

次のLaragon番外編2では、Apacheとnginxを追加・切り替えながら、WordPressをnginxで動かします。

• Apacheとnginxは何が違うのか
• LaragonではWebサーバーをどのように切り替えるのか
• WordPressをnginxへ切り替えても正常に表示できるのか
• Apacheで使っていた .htaccess はどうなるのか
• nginxではパーマリンクをどう処理するのか
• Virtual Hostの設定はどこにあるのか
• nginxとPHPはどのように連携しているのか
• 問題があった場合にApacheへ戻せるのか

まで、実際のLaragon環境を使って確認していきます。

番外編1で「仕組みを理解する」、番外編2で「実際に切り替えて確かめる」。

ここからLaragon番外編は、より実践的な開発環境の検証へ進みます。

Laragon番外編2｜Apache・nginxを追加・切り替える｜WordPressをnginxで動かす

Laragon番外編2｜Apache・nginxを追加・切り替える｜WordPressをnginxで動かす

toshi

フルスタックエンジニア

XFacebookInstagramContact

C型肝炎や感染症の闘病を経て現在通院中
フリーランスとして今日を生きる、それがすべて。
静かな光の中で、歩みを止めずに生きていく。
実験大好きなので色々とやっていきます。