ホーム最近公開の記事

中の人

【ECCUBE4.2】ECCUBE4.2の開発環境をdockerでphp-fpm環境で構築する

公開: 2022-09-27 23:39
更新: 2023-04-05 23:20

3190

ECCUBE4.2 php php-fpm docker symfony5.x

ECCUBE4.2.0-rcがリリースされて、早速このバージョンを使っての開発が始まるということで、環境構築したのでそのメモです。

【広告】

タオルブランド OSTD plus【公式】- グッドデザイン賞受賞のタオルショップ

日本最大級のまなびのマーケット

未経験からITエンジニアに！IT専門転職エージェント＠PRO人【アットプロジン】

こんにちは！

中の人です。

ECCUBE4.2-rcが9月21日?にリリースしました。Release EC-CUBE 4.2.0-rc · EC-CUBE/ec-cube

で、正式版がなんと明日の9月28日にリリース予定らしいです。...明日!?

まぁ、rc版は上記のリンク先のReadme?に書いてあるように正式版のリリースまでコードの変更はしないと言ってますので、多分正式版と99.9999%は一緒でしょう。

ということで、紹介文にも書いてあるように、ECCUBE4.2.x系をdocker環境で、php-fpmで動かす環境を作ったので、忘れないようにメモとして紹介しますよ！

ちなみにですが、ECCUBE4.2-rcには、apacheベースのdockerファイルが同梱されています。

なぜわざわざphp-fpmで環境構築するのかというと、

【ECCUBE4系 symfony4系】terminateイベントにはphp-fpmが必要です。あと、commitされません。

以前紹介した内容ですが、symfonyのterminateイベントという機能は、php-fpmの環境が前提の機能で、apache環境だとちゃんとした動きにならないのですねーこれ。

参考: The HttpKernel Component (Symfony 5.4 Docs)

ということでphp-fpmで環境構築してみたんですねー前置き長いねーわかってますよーさーせん！

OS: mac-intel

2022-10-21追記

mac-m1でも動いたの確認しました。

編集履歴

2022-12-26

root/docker/docker-nginx/Dockerfileの不要な記述を削除しました(apt-get updateでエラーが発生するようになってたため)

root/docker/docker-php/Dockerfileのxdebugをインストールする記述にバージョン指定を追加しました(xdebugのlatestがphp7.xに対応していないため)

ファイル構成

root
├── .env
├── docker
│   ├── docker-nginx
│   │   ├── Dockerfile
│   │   └── default.conf
│   └── docker-php
│       ├── Dockerfile
│       ├── entrypoint-dev.sh
│       └── php.ini
├── docker-compose.yml
└── ec-cube <- ECCUBE4.2.x
    ├── .env <- インストール後に勝手に作成されるので一旦スルーしてください。後半で紹介します。
    ├── ...

root/docker-compose.yml

version: "3"

networks:
  backend:
    driver: bridge

volumes:
  mysql-database:
    driver: local
  mailcatcher-data:
    driver: local

  ### ignore folder volume #####
  var:
    driver: local
  vendor:
    driver: local

services:
  ### ECCube4 ##################################
  ec-cube:
    build:
      context: .
      dockerfile: ./docker/docker-php/Dockerfile
      args:
        XDEBUG_INSTALL: "${XDEBUG_INSTALL:-false}"
    ports:
      - "9000:9000"
      - "4430:443"
    volumes:
      - "./ec-cube:/var/www/html:cached"
      ### 同期対象からコストの重いフォルダを除外 #####################
      - "./ec-cube/var:/var/www/html/var"
      - "./ec-cube/vendor:/var/www/html/vendor"
    environment:
      - HOST_UID
      - XDEBUG_CLIENT_HOST
      - "XDEBUG_CLIENT_PORT=${XDEBUG_CLIENT_PORT:-9000}"
      - "XDEBUG_INSTALL=${XDEBUG_INSTALL:-false}"
    depends_on:
      - mysql
    networks:
      - backend
  web:
    build: ./docker/docker-nginx
    ports:
      - "${APP_PORT}:80"
    depends_on:
      - ec-cube
      - mysql
    volumes:
      - ./ec-cube:/var/www/html
      - ./docker/docker-nginx/default.conf:/etc/nginx/conf.d/default.conf
    networks:
      - backend
  ### MySQL ##################################
  mysql:
    image: mysql:5.7
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: eccubedb
      MYSQL_USER: dbuser
      MYSQL_PASSWORD: secret
    volumes:
      - mysql-database:/var/lib/mysql
    ports:
      - 13306:3306
    networks:
      - backend

  ### Mailcatcher ##################################
  mailcatcher:
    image: schickling/mailcatcher
    ports:
      - "1080:1080"
      - "1025:1025"
    networks:
      - backend

  ### phpMyAdmin
  phpmyadmin:
    image: phpmyadmin/phpmyadmin
    environment:
      - PMA_ARBITRARY=1
      - PMA_HOST=mysql
      - PMA_USER=root
      - PMA_PASSWORD=root
    links:
      - mysql
    ports:
      - 4040:80
    networks:
      - backend

root/.env

APP_PORT=8080
XDEBUG_INSTALL=true
HOST_UID=501
XDEBUG_CLIENT_HOST=host.docker.internal
XDEBUG_CLIENT_PORT=9003

root/docker/docker-nginx/Dockerfile

FROM nginx:1.11

root/docker/docker-nginx/default.conf

server {
    listen 80;
    index index.php index.html;
    server_name php-docker.local;
    error_log  /var/log/nginx/error.log;
    access_log /var/log/nginx/access.log;
    root /var/www/html/;


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


    location ~ \.php$ {
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass ec-cube:9000;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param PATH_INFO $fastcgi_path_info;
        internal;
    }


    location ~ \\.php$ {
        return 404;
    }
}

root/docker/docker-php/Dockerfile

FROM php:7-fpm

ENV APACHE_DOCUMENT_ROOT /var/www/html

RUN apt-get update \
  && apt-get install --no-install-recommends -y \
    apt-transport-https \
    apt-utils \
    build-essential \
    curl \
    debconf-utils \
    gcc \
    git \
    vim \
    zip \
    gnupg2 \
    libfreetype6-dev \
    libicu-dev \
    libjpeg62-turbo-dev \
    libpng-dev \
    libpq-dev \
    libzip-dev \
    locales \
    ssl-cert \
    unzip \
    zlib1g-dev \
    iputils-ping \
  && apt-get clean \
  && rm -rf /var/lib/apt/lists/* \
  && echo "en_US.UTF-8 UTF-8" >/etc/locale.gen \
  && locale-gen \
  ;

RUN docker-php-ext-configure pgsql -with-pgsql=/usr/local/pgsql \
  && docker-php-ext-install -j$(nproc) zip gd mysqli pdo_mysql opcache intl pgsql pdo_pgsql \
  ;

RUN pecl install apcu && echo "extension=apcu.so" > /usr/local/etc/php/conf.d/apc.ini
COPY ./docker/docker-php/php.ini /usr/local/etc/php/conf.d/php.ini

RUN curl -sS https://getcomposer.org/installer \
  | php \
  && mv composer.phar /usr/bin/composer

RUN composer config -g repos.packagist composer https://packagist.jp

ARG XDEBUG_INSTALL
ARG BOOL=true

RUN if [ ${XDEBUG_INSTALL} = ${BOOL} ]; then \
      pecl install xdebug-3.1.5 && docker-php-ext-enable xdebug; \
    fi

COPY ./docker/docker-php/entrypoint-dev.sh /entrypoint-dev.sh
ENTRYPOINT ["/entrypoint-dev.sh"]

CMD ["php-fpm"]

root/docker/docker-php/entrypoint-dev.sh

#!/bin/sh


if [ -n "${HOST_UID}" -a "${HOST_UID}" != "$(id -u www-data)" ]; then
    usermod -u "${HOST_UID}" www-data
fi

if [ -n "${HOST_GID}" -a "${HOST_GID}" != "$(id -g www-data)" ]; then
    groupmod -g "${HOST_GID}" www-data
fi

if [ ${XDEBUG_INSTALL} = true ]; then
ini=$(cat << EOS
xdebug.client_host=${XDEBUG_CLIENT_HOST:-$(ip route | awk 'NR==1 {print $3}')}
xdebug.client_port=${XDEBUG_CLIENT_PORT}
xdebug.start_with_request=yes
xdebug.remote_cookie_expire_time=3600
xdebug.mode=debug
EOS
)
echo "${ini}" >> /usr/local/etc/php/conf.d/php.ini
fi

exec docker-php-entrypoint "$@"

このままだとdocker立ち上げた時に

ERROR: for ec-cube  Cannot start service ec-cube: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: exec: "/entrypoint-dev.sh": permission denied: unknown

のようなエラーが発生する(と思う)のでpermissionをいい感じに変更

 $ chmod 755 root/docker/docker-php/entrypoint-dev.sh

root/docker/docker-php/php.ini

opcache.max_accelerated_files = 20000
opcache.memory_consumption=256
realpath_cache_size = 4096K
realpath_cache_ttl = 600
memory_limit = 786M
// 一行改行入れといてください

これは正直なんかのプロジェクトにあったphp.iniをコピペしただけでECCUBE4.2の環境には特に関係ないです。

また、最後に一行以上改行入れとかないと、xdebugを入れる際の処理でいい感じに設定が追加されないので確実に改行は入れといてください。

環境を立ち上げる

そしたらターミナル開いて、rootで

$ docker-compose build
$ docker-compose up

で環境を立ち上げましょう

で、おそらくRelease EC-CUBE 4.2.0-rc · EC-CUBE/ec-cubeこちらからダウンロードした方は

http://localhost:8080/

にアクセスすると、インストーラ画面が開くと思います。

(もしかしたらロード長くてnginxがタイムアウトするかもしれませんが、その時はリロードしてれば開くと思います。)

おー

後半でインストール手順も紹介します。

ここからは、vendorなどがgitignoreされたチームの方向けの手順です。

gitからcloneした方の追加手順

$ docker-compose exec ec-cube bash
$ composer install --no-scripts --no-autoloader --no-plugins -d /var/www/html
$ composer dumpautoload

http://localhost:8080/

これで上記のインストーラ画面が開くはずです。

ちなみに

$ composer install --no-scripts --no-autoloader --no-plugins -d /var/www/html

こちらですが、eccubeをダウンロードすると、デフォルトで使えるプラグインが同梱?されてるっぽいのですが、色々とgitignoreされた環境をcloneした方が

$ composer install

のみのコマンドを実行すると、対象のプラグインが見つからない的なエラーになってcomposer installができません。

よくわからなかったのでプラグイン系はスルーすると上手くcomposer installができました。

この辺はもっと知見の多い方の情報発信を探すことにしましょう！

インストール

そしたら、先ほどのインストーラ画面からの手順を紹介します。

次へ進む

こんな感じで適当に入力して次に進む

(管理画面ログインIDと管理画面パスワードは管理画面ログイン時に必要になるので、メモっとくのがいいと思います。)

こんな感じで入力して次へ進む

次へ進む

インストールが完了したっぽいので管理画面を表示する

サイトの設定画面で入力したidとpasswordを入力してログイン

管理画面にログインできましたね！

mailcatcherの設定

そしたら開発環境でメール送信を確認できるツールの設定をします。

root/ec-cube/.env

# This file is a "template" of which env vars needs to be defined in your configuration or in an .env file
# Set variables here that may be different on each deployment target of the app, e.g. development, staging, production.
# https://symfony.com/doc/current/best_practices/configuration.html#infrastructure-related-configuration

###> symfony/framework-bundle ###
# For production servers, use: "APP_ENV=prod" and "APP_DEBUG=0"
# For local development, use: "APP_ENV=dev" and "APP_DEBUG=1"
APP_ENV=prod
APP_DEBUG=0

~~

###> symfony/mailer ###
MAILER_DSN=smtp://localhost:25
# 👇 以下のように書き換え
MAILER_DSN=smtp://mailcatcher:1025
###< symfony/mailer ###

~~

そしたらメールをキャッチできるか確認してみます。