Docker ベースの PHP 開発環境のセットアップに関する詳細なチュートリアル

Docker ベースの PHP 開発環境の構築に関する詳細なチュートリアル

この記事では、Docker をベースにした PHP 開発環境の構築に関する詳細なチュートリアルを主に紹介します。Docker が必要な友人は参照してください。それに

現在、多くの開発者が仮想マシン開発環境の管理に Vagrant を使用していますが、Vagrant には多くの欠点もあります (主な欠点は、リソースを大量に消費することです)。コンテナーテクノロジー、Docker、およびその他の Docker に似たテクノロジーの登場により、この問題の解決は簡単になりました。

免責事項

boot2docker の動作方法により、この記事で説明されている方法は、お使いの環境では正しく動作しない可能性があります。 Linux 以外の環境でフォルダーを Docker コンテナーと共有する必要がある場合は、さらに詳細な点に注意する必要があります。実際に発生した問題を紹介するために、特にフォローアップ記事を書きます。

良い開発環境とは何か

まず第一に、良い開発環境とは何かを知る必要があります。私にとって、良い開発環境には次の特性が必要です。

自由に使えます。自由に環境を削除したり、新しい環境を作成したりできなければなりません。

早速スタート。使いたいときにすぐに使えます。

更新が簡単。私たちの業界では物事が非常に早く移り変わり、開発環境を新しいソフトウェアバージョンに更新するのは簡単でなければなりません。

Docker は上記のすべての機能とそれ以上の機能をサポートしています。コンテナーの破棄と再構築はほぼ瞬時に行うことができ、環境を更新するには、現在使用しているイメージを再構築するだけで済みます。

PHP開発環境とは

現在、Web アプリケーションは複雑であり、PHP 開発環境では環境のシンプルさを確保するためにさまざまな制限を設ける必要があります。

今回はNginx、PHP5-FPM、MySQLを使用してSynmfonyプロジェクトを実行します。

ペットと牛

議論したいもう 1 つの重要な点は、開発環境を複数のコンテナーにデプロイするべきか、それとも単一のコンテナーにデプロイするべきかということです。どちらの方法にも独自の利点があります:

単一のコンテナは配布とメンテナンスが簡単です。これらは独立しているため、すべてが同じコンテナー内で実行され、仮想マシンのようなものになります。ただし、これは、コンテナ内の何か (PHP の新しいバージョンなど) をアップグレードする場合、コンテナ全体を再構築する必要があることも意味します。

複数のコンテナーを使用すると、コンポーネントを追加する際のモジュール性が向上します。各コンテナにはスタックの一部 (Web、PHP、MySQL など) が含まれているため、すべてを再構築することなく、各サービスを個別にスケールしたり追加したりできます。

私はめんどくさいし、ノートに何か他のものを載せる必要があるので、ここでは単一のコンテナの方法のみを紹介します。

初期化プロジェクト

最初に行うことは、新しい Symfony プロジェクトを初期化することです。推奨される方法は、composer の create-project コマンドを使用することです。 Composer をワークステーションにインストールすることもできましたが、それは単純すぎます。今回はDocker経由で利用します。

以前、Docker コマンドに関する記事「make docker コマンド」を投稿しました (嘘です。もともとこの記事に書いたもので、その後、分けたほうがよいと考えました)。

とにかく読めます。次に、コンポーザーコマンドがまだない場合は、独自のコンポーザーエイリアスを作成できます。

1	$ エイリアスコンポーザー = "docker run -i -t -v $PWD:/srv ubermuda/composer"

これで、Symfony プロジェクトを初期化できます:

すごいですね、それでは実際にやってみましょう。

コンテナ

標準的な Symfony プロジェクトを実行する自立したコンテナを構築するのは非常に簡単です。一般的に使用される Nginx、PHP5-FPM、MySQL-Server をインストールし、事前に用意された Nginx 仮想ホスト設定ファイルを投入するだけです。それをコピーしますいくつかの設定ファイルを入力するだけです。

このコンテナのソースコードは、GitHub の ubermuda/docker-symfony リポジトリにあります。 Dockerfile は、Docker がイメージを構築するために使用する構成ファイルです。

1	$composer create-project symfony/framwork-standard-edition SomeProject

debian:wheezy から

ENV DEBIAN_FRONTEND 非対話型

apt-get update -y を実行

apt-get install -y nginx php5-fpm php5-mysqlnd php5-cli mysql-server スーパーバイザを実行します

RUN sed -e 's/;daemonize = yes/daemonize = no/' -i /etc/php5/fpm/php-fpm.conf

RUN sed -e 's/;listen.owner/listen.owner/' -i /etc/php5/fpm/pool.d/www.conf

sed -e 's/;listen.group/listen.group/' -i /etc/php5/fpm/pool.d/www.conf を実行します

echo "ndaemon off;" /etc/nginx/nginx.conf

vhost.conf /etc/nginx/sites-available/default を追加します

supervisor.conf /etc/supervisor/conf.d/supervisor.conf を追加します

init.sh /init.sh を追加

80 3306を公開

ボリューム["/srv"]

WORKDIR/srv

CMD ["/usr/bin/supervisord"]

まず debian:wheezy ベースイメージを拡張し、次に一連の sed コマンドを通じて Nginx と PHP5-FPM を設定します。

コードをコピーします。コードは次のとおりです:

RUN sed -e 's/;daemonize = yes/daemonize = no/' -i /etc/php5/fpm/php-fpm.conf

RUN sed -e 's/;listen.owner/listen.owner/' -i /etc/php5/fpm/pool.d/www.conf

RUN sed -e 's/;listen.group/listen.group/' -i /etc/php5/fpm/pool.d/www.conf

RUN echo "ndaemon off;" /etc/nginx/nginx.conf

ここでやるべきことは２つあります。まず、PHP5-FPM と Nginx をフォアグラウンドで実行するように設定し、supervisord がそれらを追跡できるようにします。

次に、指定されたユーザーとして Web サーバーを実行し、ファイルのアクセス許可を処理するように PHP5-FPM を設定します。

次に、一連の構成ファイルをインストールする必要があります。最初は、Nginx 仮想ホスト構成ファイル vhost.conf:

です。

ドメイン名は必要ないので、server_name を _ (perl の $_ プレースホルダー変数に似ています) に設定し、ドキュメントルートを /svr/web に設定します。次に、アプリケーションを /srv にデプロイします。残りは標準の Mginx + PHP5-FPM 構成です。

コンテナは一度に 1 つのプログラムしか実行できないため、supervisord (または他のプロセスマネージャーですが、私は supervisord の方が好きです) が必要です。幸いなことに、このプロセスマネージャーは必要なすべてのプロセスを生成します。ここに、supervisord の設定の一部を示します。

サーバー{

80を聞いてください;

サーバー名_;

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

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

ルート/srv/web;

index app_dev.php;

場所 / {

try_files $uri $uri/ /app_dev.php?$query_string;

}

場所 ~ [^/].php(/|$) {

fastcgi_pass unix:/var/run/php5-fpm.sock;

fastcgi_params を含める;

}

[監修]

ノデーモン=true

[プログラム:nginx]

コマンド=/usr/sbin/nginx

[プログラム:php5-fpm]

コマンド=/usr/sbin/php5-fpm

[プログラム:mysql]

コマンド=/usr/bin/mysqld_safe

[プログラム:初期化]

コマンド=/init.sh

自動再起動=false

redirect_stderr=true

redirect_stdout=/srv/app/logs/init.log

ここで行う必要があるのは、すべてのサービスを定義し、特別なプログラムである init プロセスを追加することです。これは実際のサービスではなく、起動スクリプトを実行する独自の方法です。

この起動スクリプトの問題は、通常、最初にいくつかのサービスを起動する必要があることです。たとえば、最初に MySQL を実行する場合に限り、いくつかのデータベーステーブルを初期化したい場合があります。解決策としては、起動スクリプトで MySQL を起動してからテーブルを初期化し、supervisord のプロセス管理に影響を与えないようにします。 MySQL を停止して、最後に Supervisord を開始する必要があります。

このようなスクリプトは次のようになります:

/etc/init.d/mysql start

アプリ/コンソールのドクトリン:スキーマ:更新 --force

/etc/init.d/mysql stop

exec /usr/bin/supervisord

見苦しいので、別の方法を試して、スーパーバイザーに実行させ、再起動しないようにしましょう。

実際の init.sh スクリプトは次のとおりです:

#!/bin/bash

RET=1

[[ RET -ne 0 ]] をしながら

睡眠 1;

mysql -e '終了' >/dev/null 2>RET=$?

;

完了

DB_NAME=${DB_NAME:-symfony}

mysqladmin -u root create $DB_NAME

if [ -n "$INIT" ] then

/srv/$INIT

フィ

スクリプトはまず MySQL が起動するのを待ち、次に環境変数 DB_NAME (デフォルトは symfony) に従って DB を作成し、次に INIT 環境変数で実行するスクリプトを見つけて実行を試みます。この記事の最後では、これらの環境変数の使用方法について説明します。

イメージをビルドして実行します

準備は万端です、必要なのは東風だけです。また、 docker build コマンドを使用して、Symfony Docker イメージをビルドする必要があります:

これで、これを使用して Symfony プロジェクトを実行できます:

1 2	$ cd docker-symfony $ docker build -t symfony .

1 2	$ cd SomeProject $ docker run -i -t -P -v $PWD:/srv symfony

この一連のオプションの機能を見てみましょう:

-i は対話モードを開始します。つまり、STDIO (標準入出力) が現在の端末に接続されます。これは、ログを受信したり、プロセスにシグナルを送信したりする場合に便利です。

-t はコンテナの仮想 TTY を作成します。これは -i の良い友達で、通常は一緒に使用されます。

-P は、指定されたすべてのポート (この場合はポート 80) を公開するように Docker デーモンに指示します。

-v $PWD:/srv 現在のディレクトリをコンテナの /srv ディレクトリにマウントします。ディレクトリをマウントすると、ディレクトリの内容がターゲットマウントポイントで利用できるようになります。

前に述べた DB_NAME および INIT 環境変数をまだ覚えていますが、それらが使用される理由は、環境をカスタマイズするためです。基本的に、docker run の -e オプションを使用してコンテナーに環境変数を設定でき、起動スクリプトが環境変数を取得します。したがって、DB の名前が some_project_dev の場合は、次のようにコンテナーを実行できます。

1	$ docker run -i -t -P -v $PWD:/srv -e DB_NAME=some_project_dev symfony

INIT 環境変数はさらに強力で、起動時に指定されたスクリプトを実行できるようになります。たとえば、composer install コマンドを実行してデータベーススキーマを設定する bin/setup スクリプトがあるとします。

#!/bin/bash

作曲家のインストール

アプリ/コンソールのドクトリン:スキーマ:更新 --force

-e を指定して実行します:

$ docker run -i -t -P

-v $PWD:/srv

-e DB_NAME=some_project_dev

-e INIT=bin/setup

-e オプションは docer の実行で複数回使用できることに注意してください。これは非常に優れています。さらに、起動スクリプトには実行権限 (chmod +x) が必要です。

ここで、curl 経由でコンテナにリクエストを送信し、すべてが期待どおりに動作しているかどうかを確認します。まず、Docker によってコンテナーにマッピングされたパブリックポート 80 を取得し、docker port コマンドを使用する必要があります:

1 2	$ docker ポート $(docker ps -aql 1) 80 0.0.0.0:49153

Docker ps -aql 1 は、最後のコンテナーの ID を簡単に取得できる便利なコマンドです。この例では、Docker はコンテナーのポート 80 をポート 49153 にマップします。カールさせて見てみましょう。

1	$カール http://localhost:49153

ローカルホスト（翻訳者注：コンテナのローカルホスト）からではなく開発コントローラにアクセスすると、Symfony のデフォルトのエラーメッセージが表示されますが、これは正常です。これは、コンテナ内からカールリクエストを送信していないためです。これらの行をフロントコントローラー web/app_dev.php から削除します。