PHPのWebアプリケーションフレームワークLaravelの環境構築

１．開発環境の構成
２．環境構築手順
３．VirtualBoxのインストール
４．仮想マシンの作成とUbuntu（Ubuntuディスクトップ環境）をインストール
５．Dockerインストール
６．Docker-Composeのインストール
７．SSHサービスのインストール
８.WinScp（FTPソフト）のインストール
９.Dockerコンテナの作成とLaravelプロジェクトの作成
１０.ホストOS（windows）のブラウザからゲストOS（Ubuntu）にアクセスするポートを追加
１１．Putty（SSH対応リモートターミナルクライアント）ソフトのインストール
１２．WinScp（FTPソフト）をUbuntuに接続して、root権限で操作するための設定追加

１．開発環境の構成
　　Laravelの開発環境の構成をイメージ図に示します。
開発環境のイメージ図

２．環境構築手順
Laravelの開発環境の構成を以下の順で説明します。
（１）VirtualBoxのインストール
（２）仮想マシンの作成とUbuntu（Ubuntuディスクトップ環境）をインストール
（３）Dockerインストール
（４）Docker-Composeのインストール
（５）SSHサービスのインストール
　ローカルと仮想マシン間でFTP通信ができるようにするため
（６）WinScp（FTPソフト）のインストール
（７）Dockerコンテナの作成とLaravelプロジェクトの作成
（８）ホストOS（windows）のブラウザからゲストOS（Ubuntu）にアクセスするポートを追加
（９）Putty（SSH対応リモートターミナルクライアント）ソフトのインストール
（１０）WinScp（FTPソフト）をUbuntuに接続して、root権限で操作するための設定追加

３．VirtualBoxのインストール
https://www.virtualbox.org/wiki/Downloads

４．仮想マシンの作成とUbuntu（Ubuntuディスクトップ環境）をインストール
４．１　64-bitPC(AMD64)desktop imageをダウンロードします。
http://www.releases.ubuntu.com/16.04/

上記サイトからダウンロードしたファイル

４．２　仮想マシンの作成
①VirtualBoxを起動します。

②「新規」を選択し、名前の入力とタイプ、バージョンの選択

③メモリサイズの設定

④ハードディスクの選択

ここで仮想マシンが作成されます。

４．３　起動ハードディスクの設定
　今回作成した仮想マシンを選択して、「起動」します。

フォルダの釦を押します。

「追加」釦押すとディレクトリが表示されるので、ダウンロードしたUbuntuのイメージファイルを選択し、「開く」釦を押すと、光学ディスク選択の選択肢にUbuntuが表示されるので、Ubuntuを選択して、「選択｣釦を押します。
「起動ハードディスクを選択」の画面に移ります。

４．４　Ubuntuを選択して、起動します。

「日本語」を選択して、「Ubuntuをインストール」を押します。

名前、ユーザ名、パスワードを登録します。

しばらく待つ（本稿では約１時間）

remove・・・がでたらリターン

マウス右ボタンでメニューが出て、「端末を開く」を選択するとコマンド入力画面が開きます。

４．５　Ubuntuのバージョン確認
$ cd /etc
$ cat os-release

５．Dockerインストール
$ sudo apt-get update

$ sudo apt-get install docker.io

$ docker –version

６．Docker-Composeのインストール

（途中、省略）

Yを入力

Docker-composeのバージョン確認

sudoなしでもdockerを使えるようにするため、dockerグループを作ります。
$ sudo groupadd docker
ユーザをdockerグループに追加します。
$ sudo gpasswd -a $USER docker

７．SSHサービスのインストール
　ローカルと仮想マシン間でFTPでファイル転送ができるようにするため、SSHサービスを使えるようにします。

７．１　仮想マシンの設定
①仮想マシンを選択して、「設定」釦押下します。

②ネットワーク＞高度＞ポートフォワーディングを選択

③「＋」（追加）釦を押します。

④名前、プロトコル、ホストポート、ゲストポートを設定します。

ここではホストポート番号”2222”とした仮想マシンのUbntuにはローカルループバックアドレス127.0.0.1、ポート番号:2222で接続できます。

７．２　Ubuntuにopensshをインストールする
$ sudo apt-get install openssh-server

（途中、省略）

８.WinScp（FTPソフト）のインストール
https://forest.watch.impress.co.jp/library/software/winscp/

WinScpを起動します。

仮想マシンは起動されているものとします。

９.Dockerコンテナの作成とLaravelプロジェクトの作成
①　/home/（ユーザ）配下にアプリケーションをおくフォルダを作成します。ここでは、”ｋａｄａｉ”としました。
②”kadai”配下　にdockerフォルダとdocker-compose.ymlファイルを置きます。

\kadai\docker\web\default.conf

server {
    listen 80;

    root  /var/www/html/sample-app/public;
    index index.php index.html index.htm;

    access_log /var/log/nginx/access.log;
    error_log  /var/log/nginx/error.log;

    location / {
        try_files $uri $uri/ /index.php$is_args$args;
    }


    location ~ \.php$ {
          fastcgi_split_path_info ^(.+\.php)(/.+)$;
          fastcgi_pass   app:9000;
          fastcgi_index  index.php;

          include        fastcgi_params;
          fastcgi_param  SCRIPT_FILENAME $document_root$fastcgi_script_name;
          fastcgi_param  PATH_INFO $fastcgi_path_info;
    }
}

server {

listen 80;

root /var/www/html/sample-app/public;

index index.php index.html index.htm;

access_log /var/log/nginx/access.log;

error_log /var/log/nginx/error.log;

location / {

try_files $uri $uri/ /index.php$is_args$args;

}

location ~ \.php$ {

fastcgi_split_path_info ^(.+\.php)(/.+)$;

fastcgi_pass app:9000;

fastcgi_index index.php;

include fastcgi_params;

fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

fastcgi_param PATH_INFO $fastcgi_path_info;

}

\kadai\docker\phpdocker\Dockerfile

FROM php:7.2-fpm

# install composer
RUN cd /usr/bin && curl -s http://getcomposer.org/installer | php && ln -s /usr/bin/composer.phar /usr/bin/composer
RUN apt-get update \
&& apt-get install -y \
git \
zip \
unzip \
vim

RUN apt-get update \
    && apt-get install -y libpq-dev \
    && docker-php-ext-install pdo_mysql pdo_pgsql

WORKDIR /var/www/html

FROM php:7.2-fpm

# install composer

RUN cd /usr/bin && curl -s http://getcomposer.org/installer | php && ln -s /usr/bin/composer.phar /usr/bin/composer

RUN apt-get update \

&& apt-get install -y \

git \

zip \

unzip \

vim

RUN apt-get update \

&& apt-get install -y libpq-dev \

&& docker-php-ext-install pdo_mysql pdo_pgsql

WORKDIR /var/www/html

\kadai\docker-compose.yml

version: '3'
services:
  web:
    image: nginx:1.15.6
    ports:
      - "8000:80"

    depends_on: # 追加
      - app
    volumes:
      - ./docker/web/default.conf:/etc/nginx/conf.d/default.conf
      - .:/var/www/html

  app:
    #image: php:7.2-fpm
    build: ./docker/php #定義したDockerfileを元にイメージを作るように変更
    depends_on:
      - db 
    volumes:
      - .:/var/www/html
  
  db:
    image: postgres:12.1-alpine
    volumes:
      - db-store:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=${DB_NAME}
      - POSTGRES_USER=${DB_USER}
      - POSTGRES_PASSWORD=${DB_PASS}
      - POSTGRES_ROOT_PASSWORD=${DB_ROOT_PASS}
      - TZ=${TZ}
    ports:
      - "5432:5432"

volumes:
  db-store:

version: '3'

services:

web:

image: nginx:1.15.6

ports:

- "8000:80"

depends_on: # 追加

- app

volumes:

- ./docker/web/default.conf:/etc/nginx/conf.d/default.conf

- .:/var/www/html

app:

#image: php:7.2-fpm

build: ./docker/php #定義したDockerfileを元にイメージを作るように変更

depends_on:

- db

volumes:

- .:/var/www/html

db:

image: postgres:12.1-alpine

volumes:

- db-store:/var/lib/postgresql/data

environment:

- POSTGRES_DB=${DB_NAME}

- POSTGRES_USER=${DB_USER}

- POSTGRES_PASSWORD=${DB_PASS}

- POSTGRES_ROOT_PASSWORD=${DB_ROOT_PASS}

- TZ=${TZ}

ports:

- "5432:5432"

volumes:

db-store:

③kadaiのディレクトリに移動して、下記のビルドコマンドを入力します。
$ sudo docker-compose up -d –build

④web、app（ｐｈｐ）、ｄｂの３つのコンテナが起動されていることを確認します。
$ sudo docker ps

⑤app（ｐｈｐ）のコンテナに入り、Laravelプロジェクトを作成する
下記のコマンドでappコンテナに入ります。
$ sudo docker-compose exec app bash

# composer create-project –prefer-dist laravel/laravel sample-app
※ここでLaravelプロジェクトのフォルダ名（sample-app）は任意、但し、webの”default.conf”のファイルの「root /var/www/html/sample-app/public;」の名前と一致させる必要があります。

Laravelプロジェクトの作成に成功したときは、⑥へ進む

Laravelプロジェクト作成に失敗したとき
Laravelプロジェクト作成中に下記のスワップメモリ不足のエラーが出て、Laravelプロジェクトの作成に失敗した場合は、スワップメモリ領域を拡張する必要があります。

# exit
でコンテナから抜ける
SWAP領域用のファイルを作成
$ sudo /bin/dd if=/dev/zero of=/var/swap.1 bs=1M count=1024
SWAP領域作成
$ sudo /sbin/mkswap /var/swap.1
SWAP領域を有効化
$ sudo /sbin/swapon /var/swap.1

コンテナを再起動します。

$ sudo docker-compose up -d
再度、appのコンテナに入り、Laraveプロジェクトを作成します。
※途中まで作成されたフォルダが残っていると失敗するため、フォルダ（sample-app）毎削除します。

appコンテナに入ります。
$ sudo docker-compose exec app bash
Laravelプロジェクトの作成
# composer create-project –prefer-dist laravel/laravel sample-app

（途中、省略）

⑥”storage”フォルダのアクセス権限を変更する
下記のフォルダの権限を変える（chmod 777)
/var/www/html/sample-app/storage/logs
/var/www/html/sample-app/storage/framework
/var/www/html/sample-app/storage/framework/sessions
/var/www/html/sample-app/storage/framework/views