Laravelをセットアップする

Laravel

簡単に言うとPHP職人のためのフレームワークとのこと。

Dockerと組み合わせて使えば便利なはずなんですが、とにかくいろんな記事が乱立しててわかりにくくて困ったのでまとめてみました。

Docker

$ sudo curl -L "https://github.com/docker/compose/releases/download/1.24.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
$ sudo chmod +x /usr/local/bin/docker-compose
$ sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

要らないかもしれないけど、もし動かなかったら下のパッケージもインストールしましょう。

$ sudo apt install py-pip python-dev libffi-dev openssl-dev gcc libc-dev make

インストールできたら動作確認をしましょう。

$ docker-compose -v
$ docker-compose version 1.21.2, build a133471

Tutorial

基本は以下のサイトでできるんですが、英語でわかりにくい人がいそうなので大丈夫かなーっと。

Step 1 – Downloading Laravel

プロジェクト名が必要なので決めてしまいましょう。

今回は仮にlaravel-appとして進めていきます。

$ cd ~
$ git clone https://github.com/laravel/laravel.git laravel-app
$ cd ~/laravel-app

ソースコードをcloneできたらここからコマンドを打っていきます。

$ docker run --rm -v $(pwd):/app composer install
$ sudo chown -R $USER:$USER ~/laravel-app

Step 2 – Docker Compose File

次はdocker-composeのためのファイルを書いていきます。

というわけでdocker-compose.ymlファイルを作成します。

$ vi docker-compose.yml

書く内容は以下の通り。

~/laravel-app/docker-compose.yml

version: '3'
services:

  #PHP Service
  app:
    build:
      context: .
      dockerfile: Dockerfile
    image: digitalocean.com/php
    container_name: app
    restart: unless-stopped
    tty: true
    environment:
      SERVICE_NAME: app
      SERVICE_TAGS: dev
    working_dir: /var/www
    volumes:
      - ./:/var/www
      - ./php/local.ini:/usr/local/etc/php/conf.d/local.ini
    networks:
      - app-network

  #Nginx Service
  webserver:
    image: nginx:alpine
    container_name: webserver
    restart: unless-stopped
    tty: true
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./:/var/www
      - ./nginx/conf.d/:/etc/nginx/conf.d/
    networks:
      - app-network

  #MySQL Service
  db:
    image: mysql:5.7.22
    container_name: db
    restart: unless-stopped
    tty: true
    ports:
      - "3306:3306"
    environment:
      MYSQL_DATABASE: laravel
      MYSQL_ROOT_PASSWORD: secret
      SERVICE_TAGS: dev
      SERVICE_NAME: mysql
    volumes:
      - dbdata:/var/lib/mysql/
      - ./mysql/my.cnf:/etc/mysql/my.cnf
    networks:
      - app-network

#Docker Networks
networks:
  app-network:
    driver: bridge
#Volumes
volumes:
  dbdata:
    driver: local

Step 3 – Dockerfile

次にDockerfileをつくります。

ここが結構注意が必要で、元ページではmysql-clientを利用しているのですが、これが最新のdebianだと使えないので変わりにmariadb-clientを使う必要があります。

~/laravel-app/Dockerfile

FROM php:7.2-fpm

# Copy composer.lock and composer.json
COPY composer.lock composer.json /var/www/

# Set working directory
WORKDIR /var/www

# Install dependencies
RUN apt-get update && apt-get install -y \
    build-essential \
    mariadb-client \
    libpng-dev \
    libjpeg62-turbo-dev \
    libfreetype6-dev \
    locales \
    zip \
    jpegoptim optipng pngquant gifsicle \
    vim \
    unzip \
    git \
    curl

# Clear cache
RUN apt-get clean && rm -rf /var/lib/apt/lists/*

# Install extensions
RUN docker-php-ext-install pdo_mysql mbstring zip exif pcntl
RUN docker-php-ext-configure gd --with-gd --with-freetype-dir=/usr/include/ --with-jpeg-dir=/usr/include/ --with-png-dir=/usr/include/
RUN docker-php-ext-install gd

# Install composer
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

# Add user for laravel application
RUN groupadd -g 1000 www
RUN useradd -u 1000 -ms /bin/bash -g www www

# Copy existing application directory contents
COPY . /var/www

# Copy existing application directory permissions
COPY --chown=www:www . /var/www

# Change current user to www
USER www

# Expose port 9000 and start php-fpm server
EXPOSE 9000
CMD ["php-fpm"]

Step 4 – Configuring PHP

PHPの設定ファイルを作成します。

~/laravel-app/php/local.ini

upload_max_filesize=40M
post_max_size=40M

Step 5 – Configuring Nginx

nginx用の設定ファイルを作成します。

~/laravel-app/nginx/conf.d/app.conf

server {
    listen 80;
    index index.php index.html;
    error_log  /var/log/nginx/error.log;
    access_log /var/log/nginx/access.log;
    root /var/www/public;
    location ~ \.php$ {
        try_files $uri =404;
        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;
    }
    location / {
        try_files $uri $uri/ /index.php?$query_string;
        gzip_static on;
    }
}

Step 6 – Configuring MySQL

最後にMySQL用の設定ファイルを作成します。

~/laravel-app/mysql/my.cnf

[mysqld]
general_log = 1
general_log_file = /var/lib/mysql/general.log

Step 7 – Configuring .env

$ cp .env.example .env
$ php artisan key:generate

キーを設定しておかないとLaravelに怒られるのでセットアップしておきましょう。

自動でやってくれるのでコマンドを打つだけで大丈夫です。

Step 8 – Run

$ docker-compose up -d

アクセスできることを確認したら完了です。

まとめ

セットアップするのに苦戦続きでまるまる一日かかってしまいました。

とりあえずこれでコンテナを落としてもちゃんとLaravelが消えないようになったので大丈夫かと。

日本語サイトで情報が錯綜していたのでまとめてみました。