概要
会社ではMac、自宅ではWindowsのような環境の場合、自宅でも慣れ親しんだBashを使って開発環境を整えたい場合や、WindowsにPHPやComposerを入れるのがめんどくさい、あまり汚したくないというなどという理由で、Windows Subsystem for Linuxを使ってPHPが動作する環境及びLaravel Homesteadが動作する環境を構築する手順を以下にまとめる。
なお、Homesteadはプロジェクトごとにインストールすることを前提とする。
プロジェクトごとにインストール - Laravel Homestead 5.6 Laravel
https://readouble.com/laravel/5.6/ja/homestead.html#per-project-installation
VirtualBoxのインストール
Oracle VM VirtualBox - Downloads | Oracle Technology Network | Oracle
http://www.oracle.com/technetwork/server-storage/virtualbox/downloads/index.html?ssSourceSiteId=otnjp
Windows Subsystem for LinuxのUbuntu 18.04のインストール
Microsoft Storeからインストールする
Ubuntu 18.04 を入手 - Microsoft Store ja-JP
https://www.microsoft.com/ja-jp/p/ubuntu-1804/9n9tngvndl3q
Ubuntu 18.04を起動する
スタートメニューからUbuntu 18.04を起動することで、シェルが起動される。
初回起動時ユーザー作成が必要となるので、ユーザー名の入力、パスワードを入力する。
パスワードは以後、aptを利用する際にsudoを実行した時に聞かれるので覚えておくこと。
必要なパッケージのインストールする
- php-cli
- php-mbstring
- php-mysql
- php-xml
- php-zip
- composer
$ sudo apt update
$ sudo apt install php-cli php-mbstring php-mysql php-xml php-zip composer
ソース格納ディレクトリの準備とシンボリックリンクの作成
Windows Subsystem for Linuxでは、Ubuntu内からWindowsのファイルシステムにアクセスする場合/mnt配下にあるドライブレターごとのディレクトリ配下を参照することになる。
毎回ディレクトリを移動するのが面倒なため、Ubuntuのホームディレクトリ配下に、Windowsのホームディレクトリ配下に作成したディレクトリのシンボリックリンクを作成する。以下を実行しsrcというディレクトリでプロジェクトを管理できるようにする。
$ mkdir /mnt/c/Users/<Windowsのユーザー名>/src
$ ln -s /mnt/c/Users/<Windowsのユーザー名>/src ~/src
Vagrantのインストール
VagrantはWindowsとWindows Subsystem for Linuxの両方にインストールする必要がある。
Windowsへのインストール
Download - Vagrant by HashiCorp
https://www.vagrantup.com/downloads.html
Windows Subsystem for Linuxへのインストール
$ wget https://releases.hashicorp.com/vagrant/2.1.1/vagrant_2.1.1_x86_64.deb
$ sudo apt install ./vagrant_2.1.1_x86_64.deb
$ rm vagrant_2.1.1_x86_64.deb
Vagrantの設定
Vagrant and Windows Subsystem for Linux - Vagrant by HashiCorp
https://www.vagrantup.com/docs/other/wsl.html
$ echo 'export VAGRANT_WSL_ENABLE_WINDOWS_ACCESS="1"' >> ~/.bashrc
$ source ~/.bashrc
必要に応じて、秘密鍵と公開鍵を生成しておく。Vagrantを起動する際に必要だが、他に利用用途が無い場合にはパスワードを設定しなくても良いかも。
$ ssh-keygen -t rsa -b 4096
ここまで設定すれば、後の手順はLinuxやMacで行う手順とほぼ同じとなる。
Laravelコマンドのインストール
$ composer global require laravel/installer
$ echo 'export PATH="$PATH:$HOME/.config/composer/vendor/bin"' >> ~/.bashrc
$ source ~/.bashrc
プロジェクトの作成とHomesteadの追加
$ cd ~/src
$ laravel new blog
$ cd blog
$ composer require laravel/homestead --dev
$ php vendor/bin/homestead make
Homesteadの起動
Homesteadを初めて利用する場合、必要なBoxイメージをダウンロードするため時間がかかる。
$ vagrant up
vagrant sshを実行した際、vagrantのユーザーのパスワードを聞かれた場合にはパスワードとしてvagrantを入力する。