Windows11にWSL2＋DockerでPHP開発環境構築

環境構築

WSL2 のインストール

まずはDockerを利用するためにWindows Sub Linux 2をインストールします。具体的な手順は、マイクロソフト・イグナイトのドキュメントを参考します。

learn.microsoft.com
 
WSL のインストール
https://learn.microsoft.com/ja-jp/windows/wsl/install
コマンド wsl --install を使用して Linux 用 Windows サブシステムをインストールします。 Windows コンピューター上で、好みの Linux ディストリビューションによって実行される Bash ターミナルを使用します。Ubuntu、Debian、SUSE、Kali、Fedora、Pengwin、Alpine などを使用できます。

以下は、インストールする際に Windows Power Shell で実行した実行したコマンドです。コマンドの詳細の内容は上記のページでご確認ください。

wsl --install # WSL コマンドのインストール
wsl -l -v # 実行している WSL のバージョンを確認

インストールは以上で完了です。しかし、筆者の開発環境はCドライブよりDドライブの容量が大きいですので、WSL2 をDドライブに移動しました。以下の例ではC:\Users\《ユーザー名》\AppData\Local\Packages\CanonicalGroupLimited.UbuntuonWindows_《コード？》\LocalStateからD:\Users\《ユーザー名》\AppData\Local\Packages\UbuntuonWindows\LocalState配下に移動しています。

# WSLを停止
wsl --shutdown
# WSLの状態確認（NAME（ディストリビューション名）とSTATEがStoppedになっているか）
wsl -l -v
# エクスポート：wsl <コマンド> <ディストリビューション名> <エクスポート先>
wsl --export Ubuntu D:\Users\《ユーザー名》\Downloads\Ubuntu.tar
# 解除：wsl <コマンド> <ディストリビューション名>
wsl --unregister Ubuntu
# アンインストールされていることを確認
wsl -l -v
# 指定パスのフォルダを作成
New-Item D:\Users\《ユーザー名》\AppData\Local\Packages\UbuntuonWindows\LocalState -ItemType Directory
# インポート：wsl <コマンド> <ディストリビューション名> <インポート場所> <ファイル名> <オプション>
wsl --import Ubuntu D:\Users\《ユーザー名》\AppData\Local\Packages\UbuntuonWindows\LocalState D:\Users\《ユーザー名》\Downloads\Ubuntu.tar
# 起動されていることを確認
wsl -l -v
# デフォルトのユーザをrootから変更
Ubuntu config --default-user 《ユーザー名》

Windows ターミナルのインストール

Windows標準のコマンドプロンプトや PowerShell だけでもターミナルとして利用できますが、Windows ターミナルを利用すると作業効率が上がりそうなのでインストールします。インストール方法はマイクロソフト・イグナイトのドキュメントを参考します。

learn.microsoft.com
 
Windows ターミナルのインストール
https://learn.microsoft.com/ja-jp/windows/terminal/install
Windows ターミナルをインストールしてセットアップする方法について説明します。

WSL2 上の Ubuntu に接続する時の配色を Ubuntu のGUI風に変更したい場合は、以下を参考して設定します。

learn.microsoft.com
Windows ターミナルの Raspberry Ubuntu
https://learn.microsoft.com/ja-jp/windows/terminal/custom-terminal-gallery/raspberry-ubuntu
これは Raspberry Ubuntu のテーマです。

Git for windows のインストール

公式サイトでインストーラーをダウンロードしてインストールを行います。インストールする際に、いくつかの設定画面が表示されます。

gitforwindows.org
 
Git for Windows
https://gitforwindows.org
We bring the awesome Git VCS to Windows

基本的にはデフォルトのままでいいですが、１箇所注意して変更するところがあります。筆者は WSL2 上でソースコードを crone したいと思いますので checkout する際に改行コードをLF⇒CRLFに変更しないように設定を変えます。

筆者は Windows Terminal を利用するつもりですので、一番下のチェックボックスを選択しました。
筆者は Windows 用バッチファイルも commit や checkout するので、改行コードは LF⇔CRLF に変換しないように設定します。Linxu 用開発だけ方は改行コードを変換するように設定いた方が便利だと思います。

Gitのアップデートなどによって、上記の改行コードの自動変換のコンフィグ設定が変わる可能性があります。そのため、インストール後には、Gitのコンフィグ設定で改行コードの自動変換を有効にすることをお勧めします。例えば無効にする場合は、Windows Power Shell でgit config --global core.autocrlf falseを実行します。

Docker Desktop on Windows のインストール

ウェブサーバーやデータベースサーバーなどを動かす時はDockerのコンテナーを利用するため、Docker Desktopをインストールします。具体的な手順は、Dockerの公式ドキュメントを参考します。

Docker Documentation
 
Install Docker Desktop on Windows
https://docs.docker.com/desktop/install/windows-install/
How to install Docker Desktop for Windows

Docker も WSL2 を利用しているので、場所を C ドライブから D ドライブに移動します。以下の例C:\Users\《ユーザー名》\AppData\Local\Docker\wsl\dataからD:\Users\《ユーザー名》\AppData\Local\Docker\wsl\data配下に、C:\Users\《ユーザー名》\AppData\Local\Docker\wsl\distroからD:\Users\《ユーザー名》\AppData\Local\Docker\wsl\distro配下に移動したコマンドです。

# ★注意：Docker Desktop on Windows が停止されていることが前提条件です。
# WSLを停止
wsl --shutdown
# WSLの状態確認（NAME（ディストリビューション名）とSTATEがStoppedになっているか）
wsl -l -v
# エクスポート：wsl <コマンド> <ディストリビューション名> <エクスポート先>
wsl --export docker-desktop-data D:\Users\《ユーザー名》\Downloads\docker-desktop-data.tar
wsl --export docker-desktop D:\Users\《ユーザー名》\Downloads\docker-desktop.tar
# 解除：wsl <コマンド> <ディストリビューション名>
wsl --unregister docker-desktop-data
wsl --unregister docker-desktop
# アンインストールされていることを確認
wsl -l -v
# 指定パスのフォルダを作成
New-Item D:\Users\《ユーザー名》\AppData\Local\Docker\wsl\data -ItemType Directory
New-Item D:\Users\《ユーザー名》\AppData\Local\Docker\wsl\distro -ItemType Directory
# インポート：wsl <コマンド> <ディストリビューション名> <インポート場所> <ファイル名> <オプション>
wsl --import docker-desktop D:\Users\《ユーザー名》\AppData\Local\Docker\wsl\data D:\Users\《ユーザー名》\Downloads\docker-desktop.tar
wsl --import docker-desktop-data D:\Users\《ユーザー名》\AppData\Local\Docker\wsl\distro D:\Users\《ユーザー名》\Downloads\docker-desktop-data.tar

IDE のインストール

弊社ではJetBrains社の PhpStorm を愛用しています。有料ツールではありますが、利用した方が開発効率が圧倒的に上がりますので、精神的にも経済的にも利点があると思います。

無料ツールを利用したい場合は、Visual Studio Code を使っています。

pleiades.io
 
403 Forbidden
https://pleiades.io/help/phpstorm/installation-guide.html
code.visualstudio.com
 
Running Visual Studio Code on Windows
https://code.visualstudio.com/docs/setup/windows
Get Visual Studio Code up and running on Windows

PhpStorm をインストールした後は、Git バイナリのパスを設定することをお勧めします。設定しなくても動作はしますが、たまにバージョン情報がリモートと同期されなかったりして不便を感じます。

Git バイナリのパスを設定する箇所です。

GitHub Copilot

最近 Github の Copilot を利用していますが、なかなか優れたもので作業効率がかなり上がったと考えています。まさに副操縦士です。コメントや Github 状のソースコードを参考して、これから実装するコードを予測してくれます。細かいところまでは予測できないですが、大まかな処理の流れやメソッドの選定など自動で提案してくれるので本当に参考になります。特に変数名や関数名を決める時結構面倒だと思っていましたが、自動で命名規則に従って変数名や関数名を付けてくれるのでとても便利です。有償ではありますが、払い価値があるサービスだと筆者個人では思っています。

以下の公式ドキュメントを参考して Phpstorm で設定ができます。

GitHub Docs
 
Quickstart for GitHub Copilot - GitHub Docs
https://docs.github.com/en/copilot/quickstart

公式ドキュメントでは Visual Studio Code でインストールする手順が記載されていますが、PhpStorm でもプラグインが準備されています。

PhpStorm で Copilotを利用するためのプラングインをインストールします。

※参考サイト

関連記事

コメント

この記事へのコメントはありません。

カテゴリー

お問い合わせはコチラ！