nginx と php-fpm の構成で docker コンテナの PHP アプリケーション実行環境を構築します。nginx と php-fpm の通信方式は「TCP」と「UNIX ドメインソケット」の 2 通りがあり、それぞれで設定ファイルや Dockerfile への記述が異なります。

docker で nginx ＆ php-fpm の PHP 実行環境を構築する（TCP/UNIX domain socket）

nginx と php-fpm の構成で docker コンテナの PHP アプリケーション実行環境を構築してみます。
（開発環境構築の話ではないので docker-compose は使いません）
nginx と php-fpm の通信（How）が今回の話のメインです。
<h2 id="contents">Contents</h2>
<ol>
<li><a href="#%E3%83%87%E3%82%A3%E3%83%AC%E3%82%AF%E3%83%88%E3%83%AA%E6%A7%8B%E6%88%90%E3%81%AA%E3%81%A9">ディレクトリ構成など</a></li>
<li><a href="#php-fpm-%E3%81%AE-dockerfile-%E3%82%92%E4%BD%9C%E6%88%90">php-fpm の Dockerfile を作成</a>
<ol>
<li><a href="#php-%E3%81%AE%E8%A8%AD%E5%AE%9A%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB-phpini-%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6">PHP の設定ファイル php.ini について</a></li>
</ol>
</li>
<li><a href="#nginx-%E3%81%AE-dockerfile-%E3%82%92%E4%BD%9C%E6%88%90">nginx の Dockerfile を作成</a></li>
<li><a href="#nginx-%E3%81%A8-php-fpm-%E3%81%AE%E9%80%9A%E4%BF%A1%E3%82%92%E5%AE%9A%E7%BE%A9%E3%81%99%E3%82%8B">nginx と php-fpm の通信を定義する</a></li>
<li><a href="#tcp-%E3%81%A7%E9%80%9A%E4%BF%A1%E3%82%92%E8%A1%8C%E3%81%86">TCP で通信を行う</a>
<ol>
<li><a href="#%E5%8B%95%E4%BD%9C%E7%A2%BA%E8%AA%8D">動作確認</a></li>
</ol>
</li>
<li><a href="#docker-%E3%82%B3%E3%83%B3%E3%83%86%E3%83%8A%E3%83%8D%E3%83%83%E3%83%88%E3%83%AF%E3%83%BC%E3%82%AF%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6">Docker コンテナ・ネットワークについて</a></li>
<li><a href="#unix-%E3%83%89%E3%83%A1%E3%82%A4%E3%83%B3%E3%82%BD%E3%82%B1%E3%83%83%E3%83%88-%E3%81%A7%E9%80%9A%E4%BF%A1%E3%82%92%E8%A1%8C%E3%81%86">UNIX ドメインソケット で通信を行う</a>
<ol>
<li><a href="#php-fpm">php-fpm</a></li>
<li><a href="#nginx">nginx</a></li>
<li><a href="#%E5%8B%95%E4%BD%9C%E7%A2%BA%E8%AA%8D-1">動作確認</a></li>
</ol>
</li>
</ol>
<h2 id="ディレクトリ構成など">ディレクトリ構成など</h2>
docker イメージとコンテナの作成に入る前に、今回は php-fpm と nginx のコンテナを作成するため、それぞれ php-fpm 用に php というディレクトリを作成し、nginx 用に web というディレクトリを切って進めます。
そして、アプリケーション（の代わり）として index.php を php-fpm 側に配置しておきます。
<pre><code class="hljs language-shell">docker/
├─ php/
│   └ src/
│   └─ index.php
└─ web/

</code></pre>
なお、index.php は phpinfo を表示させるだけの簡単なものになっています。
<dl class="description_setting">
<dt>php/src/index.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php phpinfo(); ?>
</code></pre>
</dd>
</dl>
<h2 id="php-fpm-の-dockerfile-を作成">php-fpm の Dockerfile を作成</h2>
Dockerfile を作成して、まずは最もベースとなる部分の定義を行います。
php/ 配下に Dockerfile を作成し以下を記述します。
<dl class="description_setting">
<dt>php/Dockerfile</dt>
<dd>
<pre><code class="hljs language-dockerfile">FROM php:8.0-fpm-alpine

# install configure file
RUN cp /usr/local/etc/php/php.ini-production /usr/local/etc/php/php.ini

# settings
COPY settings/php.ini /usr/local/etc/php/conf.d/php.ini

# app sources
COPY src /usr/share/nginx/html
</code></pre>
</dd>
</dl>
<ol>
<li>ベースイメージには PHP の公式イメージを指定しています。</li>
<li>PHP の設定ファイルである php.ini を作成します。</li>
<li>追加で設定するための PHP 設定ファイルを設置しています。</li>
<li>アプリケーションをドキュメントルートにコピーしています。</li>
</ol>
php - Docker Official Images 
<a href="https://hub.docker.com/_/php" rel="noopener noreferrer" target="_blank">https://hub.docker.com/_/php</a>
<h3 id="php-の設定ファイル-phpini-について">PHP の設定ファイル php.ini について</h3>
工程 2 では、PHP に予め用意されているテンプレートからそのまま php.ini を作成し設置しています。
設定値をデフォルトから変更したいものについては、予め用意した php.ini にその設定を記述し、工程 3 で conf.d/ 配下に設置する事で設定値を上書きしています。
<dl class="description_setting">
<dt>php/settings/php.ini</dt>
<dd>
<pre><code class="hljs language-shell">[PHP]
date.timezone = "Asia/Tokyo"
</code></pre>
</dd>
</dl>
なので、変更が不要なら工程 3 の記述は不要です。
<h2 id="nginx-の-dockerfile-を作成">nginx の Dockerfile を作成</h2>
次に、nginx 側の Dockerfile を作成します。
web/ 配下に Dockerfile を作成し以下を記述します。
<dl class="description_setting">
<dt>web/Dockerfile</dt>
<dd>
<pre><code class="hljs language-dockerfile">FROM nginx:1.19-alpine

# settings
COPY settings/default.conf /etc/nginx/conf.d/default.conf
</code></pre>
</dd>
</dl>
<ol>
<li>ベースイメージには nginx の公式イメージを指定しています。</li>
<li>nginx の設定ファイルを設置します。</li>
</ol>
nginx - Docker Official Images 
<a href="https://hub.docker.com/_/nginx" rel="noopener noreferrer" target="_blank">https://hub.docker.com/_/nginx</a>
工程 3 で設置している default.conf は、この時点ではまだ空っぽの状態です。
<h2 id="nginx-と-php-fpm-の通信を定義する">nginx と php-fpm の通信を定義する</h2>
nginx と php-fpm の通信方式は 2 通りあって、それぞれで設定ファイルや Dockerfile への記述が異なります。
<ul>
<li>TCP</li>
<li>UNIX ドメインソケット</li>
</ul>
どちらを採用すべきか？については検証と結論に至れていないので、今回は両方で構築してみます。
<h2 id="tcp-で通信を行う">TCP で通信を行う</h2>
TCP で通信する場合は、nginx の設定ファイルを以下のように定義します。
<dl class="description_setting">
<dt>web/settings/default.conf</dt>
<dd>
<pre><code class="hljs language-shell">server {
 listen 80;
 root /usr/share/nginx/html;

 location / {
 index index.php index.html index.htm;
 fastcgi_pass php-sample:9000;
 fastcgi_index index.php;
 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
 include fastcgi_params;
 }
}
</code></pre>
</dd>
</dl>
設定のもろもろは条件によって書き方が異なるためここの記述自体はかなり簡略化してますが、ポイントは fastcgi_pass の値です。
fastcgi_pass php-sample:9000;
<ul>
<li>php-sample というのは、今回作成する php-fpm のコンテナ名です。この後、php-fpm のコンテナを立ち上げる際にこの名前で起動させるので、それをここに指定します。</li>
<li>:9000 はポート番号です。php-fpm のデフォルトの待受ポートは 9000 なのでこれを指定しています。</li>
</ul>
前項で php-fpm と nginx の、ベースの定義を行いましたが、TCP で通信する場合は nginx の設定ファイルの定義のみで実現できます。
<h3 id="動作確認">動作確認</h3>
ではイメージの作成とコンテナの起動を行いアプリケーションを動作させてみます。
以下のコマンドを実行して環境を構築します。
<pre><code class="hljs language-shell"># 1. PHP のイメージを作成
docker build --no-cache -t php/sample:20210109 .

# 2. nginx のイメージを作成
docker build --no-cache -t nginx/sample:20210109 .

# 3. ネットワークを作成
docker network create --driver bridge sample_nw

# 4. PHP のコンテナを起動
docker run --net=sample_nw --name php-sample php/sample:20210109

# 5. nginx のコンテナを起動
docker run -p 80:80 --net=sample_nw --name nginx-sample nginx/sample:20210109
</code></pre>
ブラウザから http://localhost へアクセスします。
<div class="img_wrap"><amp-img layout="responsive" src="/images/posts/220/gxsYV30mzn7T94sm7iIZ.png" width="800" height="295" alt="TCP通信でアプリケーションを実行"></div>
nginx と php-fpm を TCP で通信させてアプリケーションが実行できました。
最終的なファイル構成
<pre><code class="hljs language-shell">docker/
├── php/
│   ├ Dockerfile
│   ├ settings/
│   │   └─ php.ini
│   └ src/
│   └─ index.php
└── web/
 ├ Dockerfile
 └ settings/
 └─ default.conf
</code></pre>
<h2 id="docker-コンテナネットワークについて">Docker コンテナ・ネットワークについて</h2>
先程の環境立ち上げの際に、イメージとコンテナ以外に「ネットワーク」を作成しました。
１つのネットワークを作成しそのネットワークに各コンテナを接続する事で、コンテナ間が互いを識別できるようにしています。
作成したネットワークの詳細を確認すると、コンテナが２つ接続されている事がわかります。
<pre><code class="hljs language-shell"># ネットワークを作成
docker network create --driver bridge sample_nw

# ネットワーク一覧
% docker network ls
NETWORK ID NAME DRIVER SCOPE
9326dc6f3546 sample_nw bridge local

# 作成したネットワークを確認
% docker network inspect sample_nw
[
 {
 "Name": "sample_nw",
 "Id": "9da5326d1311ac663041ec0426bd8704f757da7559511fbaa8f3541a42fd51ef",
 "Created": "2021-01-09T04:31:03.73817688Z",
 "Scope": "local",
 "Driver": "bridge",
 "EnableIPv6": false,
 "IPAM": {
 "Driver": "default",
 "Options": {},
 "Config": [
 {
 "Subnet": "123.45.0.0/16",
 "Gateway": "123.45.0.1"
 }
 ]
 },
 "Internal": false,
 "Attachable": false,
 "Ingress": false,
 "ConfigFrom": {
 "Network": ""
 },
 "ConfigOnly": false,
 "Containers": {
 "658ef76ea2e64cbd70a3b36c0fc05aa5b8af19372da3d314995111d2d15f2431": {
 "Name": "nginx-sample",
 "EndpointID": "27a847dc70353c9411e6bf21a4a3353b60926d4e2a8fcd08c68cecb899151ef9",
 "MacAddress": "12:34:ac:56:78:09",
 "IPv4Address": "123.45.0.3/16",
 "IPv6Address": ""
 },
 "eb1fad3265148727daaabede2818d03ac0e5a40957ad889a2b642ef88cab0bcd": {
 "Name": "php-sample",
 "EndpointID": "1b6e026ccebcf3107a82577a1e02e9ec4b476e930941fe75c5ad1c2e6d9516ae",
 "MacAddress": "12:34:ac:56:78:09",
 "IPv4Address": "123.45.0.2/16",
 "IPv6Address": ""
 }
 },
 "Options": {},
 "Labels": {}
 }
]
</code></pre>
Docker コンテナ・ネットワークの理解 
<a href="http://docs.docker.jp/v17.06/engine/userguide/networking/dockernetworks.html" rel="noopener noreferrer" target="_blank">http://docs.docker.jp/v17.06/engine/userguide/networking/dockernetworks.html</a>
ちなみに、ネットワークを作成せずに、 nginx 側のコンテナ起動時に --link オプションを使って php-fpm 側のコンテナを識別させる方法もありますが、現在では非推奨となっています。
コンテナ・リンク機能（古い機能） 
<a href="http://docs.docker.jp/v17.06/engine/userguide/networking/default_network/dockerlinks.html" rel="noopener noreferrer" target="_blank">http://docs.docker.jp/v17.06/engine/userguide/networking/default_network/dockerlinks.html</a>
<h2 id="unix-ドメインソケット-で通信を行う">UNIX ドメインソケット で通信を行う</h2>
UNIX ドメインソケットで通信する場合に TCP の時と違うのは、通信の為にソケットを指定する事と、nginx 側からソケットを参照できるようにする事です。
<h3 id="php-fpm">php-fpm</h3>
<dl class="description_setting">
<dt>php/Dockerfile</dt>
<dd>
<pre><code class="hljs language-dockerfile">FROM php:8.0-fpm-alpine

# add user
RUN addgroup -S nginx &#x26;&#x26; adduser -S nginx -G nginx

# install setting
RUN cp /usr/local/etc/php/php.ini-production /usr/local/etc/php/php.ini

# settings
COPY settings/zzz-docker.conf /usr/local/etc/php-fpm.d/zzz-docker.conf
COPY settings/php.ini /usr/local/etc/php/conf.d/app-php.ini

# unix socket
RUN mkdir /var/run/php-fpm
VOLUME ["/var/run/php-fpm"]

# app sources
COPY src /usr/share/nginx/html
</code></pre>
</dd>
</dl>
<ol>
<li>ベースイメージには PHP の公式イメージを指定しています。</li>
<li>nginx ユーザを作成します。</li>
<li>PHP の設定ファイルである php.ini を作成します。</li>
<li>php-fpm の設定ファイル（更新分）を設置します。</li>
<li>PHP の設定ファイル（更新分）を設置します。</li>
<li>ソケットを設置するディレクトリを作成し、ボリュームマウントします。</li>
<li>アプリケーションをドキュメントルートにコピーします。</li>
</ol>
php-fpm の設定ファイルはデフォルトで設置されていますが、UNIX ドメインソケットを利用するために値を変更したい（工程 5 のところ）ので、設定値を上書きするための設定ファイルを作成します。
<dl class="description_setting">
<dt>php/settings/zzz-docker.conf</dt>
<dd>
<pre><code class="hljs language-shell">[www]
listen = /var/run/php-fpm/php-fpm.sock
listen.owner = nginx
listen.group = nginx
listen.mode = 0660
</code></pre>
</dd>
</dl>
unix ドメインソケットを使うように指定したのと、ソケットを使用するユーザ（パーミッション）を設定しています。
owner/group は、nginx 側からソケットを参照するユーザを指定しています。
<h3 id="nginx">nginx</h3>
<dl class="description_setting">
<dt>web/Dockerfile</dt>
<dd>
<pre><code class="hljs language-dockerfile">FROM nginx:1.19-alpine

# settings
COPY settings/default.conf /etc/nginx/conf.d/default.conf
</code></pre>
</dd>
</dl>
<ol>
<li>ベースイメージには nginx の公式イメージを指定しています。</li>
<li>nginx の設定ファイルを設置します。</li>
</ol>
Dockerfile は TCP の時と変わりません。
nginx の設定ファイルを以下に定義します。
<dl class="description_setting">
<dt>web/settings/default.conf</dt>
<dd>
<pre><code class="hljs language-shell">server {
 listen 80;
 server_name localhost;
 root /usr/share/nginx/html;

 location / {
 index index.php index.html index.htm;
 fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock;
 fastcgi_index index.php;
 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
 include fastcgi_params;
 }
}
</code></pre>
</dd>
</dl>
TCP の時との違いは、fastcgi_pass に unix ドメインソケットを指定している点です。
<h3 id="動作確認-1">動作確認</h3>
ではイメージの作成とコンテナの起動を行いアプリケーションを動作させてみます。
以下のコマンドを実行して環境を構築します。
<pre><code class="hljs language-shell"># 1. PHP のイメージを作成
docker build --no-cache -t php/sample:20210109 .

# 2. nginx のイメージを作成
docker build --no-cache -t nginx/sample:20210109 .

# 3. PHP のコンテナを起動
docker run --name php-sample php/sample:20210109

# 4. nginx のコンテナを起動
docker run -p 80:80 --volumes-from php-sample --name nginx-sample nginx/sample:20210109
</code></pre>
ブラウザから http://localhost へアクセスします。
<div class="img_wrap"><amp-img layout="responsive" src="/images/posts/220/JL8UQQQu5TglPc7etWPJ.png" width="800" height="295" alt="UNIX ドメインソケット通信でアプリケーションを実行"></div>
nginx と php-fpm を UNIX ドメインソケット で通信させてアプリケーションが実行できました。
最終的なファイル構成
<pre><code class="hljs language-shell">docker/
├ php/
│   ├ Dockerfile
│   ├ settings/
│   │   ├─ php.ini
│   │   └─ zzz-docker.conf
│   └ src/
│   └─ index.php
└ web/
 ├ Dockerfile
 └ settings/
 └── default.conf
</code></pre>
<h2 id="まとめ">まとめ</h2>
Laravel や CakePHP 等の PHP フレームワークを動かす際も基本的には同じ要領で、nginx の設定ファイル側を調整したり、必要なパッケージを PHP 側に入れたりなどすれば動作させる事ができます。
実行環境なのでアプリケーションごとイメージに固めていますが、これらの dockerfile と docker-compose を併せて役割を分ければ開発環境の構築も可能です。

nginx と php-fpm の構成で docker コンテナの PHP アプリケーション実行環境を構築してみます。
（開発環境構築の話ではないので docker-compose は使いません）
nginx と php-fpm の通信（How）が今回の話のメインです。
<h2 id="contents">Contents</h2>
<ol>
<li><a href="#%E3%83%87%E3%82%A3%E3%83%AC%E3%82%AF%E3%83%88%E3%83%AA%E6%A7%8B%E6%88%90%E3%81%AA%E3%81%A9">ディレクトリ構成など</a></li>
<li><a href="#php-fpm-%E3%81%AE-dockerfile-%E3%82%92%E4%BD%9C%E6%88%90">php-fpm の Dockerfile を作成</a>
<ol>
<li><a href="#php-%E3%81%AE%E8%A8%AD%E5%AE%9A%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB-phpini-%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6">PHP の設定ファイル php.ini について</a></li>
</ol>
</li>
<li><a href="#nginx-%E3%81%AE-dockerfile-%E3%82%92%E4%BD%9C%E6%88%90">nginx の Dockerfile を作成</a></li>
<li><a href="#nginx-%E3%81%A8-php-fpm-%E3%81%AE%E9%80%9A%E4%BF%A1%E3%82%92%E5%AE%9A%E7%BE%A9%E3%81%99%E3%82%8B">nginx と php-fpm の通信を定義する</a></li>
<li><a href="#tcp-%E3%81%A7%E9%80%9A%E4%BF%A1%E3%82%92%E8%A1%8C%E3%81%86">TCP で通信を行う</a>
<ol>
<li><a href="#%E5%8B%95%E4%BD%9C%E7%A2%BA%E8%AA%8D">動作確認</a></li>
</ol>
</li>
<li><a href="#docker-%E3%82%B3%E3%83%B3%E3%83%86%E3%83%8A%E3%83%8D%E3%83%83%E3%83%88%E3%83%AF%E3%83%BC%E3%82%AF%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6">Docker コンテナ・ネットワークについて</a></li>
<li><a href="#unix-%E3%83%89%E3%83%A1%E3%82%A4%E3%83%B3%E3%82%BD%E3%82%B1%E3%83%83%E3%83%88-%E3%81%A7%E9%80%9A%E4%BF%A1%E3%82%92%E8%A1%8C%E3%81%86">UNIX ドメインソケット で通信を行う</a>
<ol>
<li><a href="#php-fpm">php-fpm</a></li>
<li><a href="#nginx">nginx</a></li>
<li><a href="#%E5%8B%95%E4%BD%9C%E7%A2%BA%E8%AA%8D-1">動作確認</a></li>
</ol>
</li>
</ol>
<h2 id="ディレクトリ構成など">ディレクトリ構成など</h2>
docker イメージとコンテナの作成に入る前に、今回は php-fpm と nginx のコンテナを作成するため、それぞれ php-fpm 用に php というディレクトリを作成し、nginx 用に web というディレクトリを切って進めます。
そして、アプリケーション（の代わり）として index.php を php-fpm 側に配置しておきます。
<pre><code class="hljs language-shell">docker/
├─ php/
│   └ src/
│   └─ index.php
└─ web/

</code></pre>
なお、index.php は phpinfo を表示させるだけの簡単なものになっています。
<dl class="description_setting">
<dt>php/src/index.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php phpinfo(); ?>
</code></pre>
</dd>
</dl>
<h2 id="php-fpm-の-dockerfile-を作成">php-fpm の Dockerfile を作成</h2>
Dockerfile を作成して、まずは最もベースとなる部分の定義を行います。
php/ 配下に Dockerfile を作成し以下を記述します。
<dl class="description_setting">
<dt>php/Dockerfile</dt>
<dd>
<pre><code class="hljs language-dockerfile">FROM php:8.0-fpm-alpine

# install configure file
RUN cp /usr/local/etc/php/php.ini-production /usr/local/etc/php/php.ini

# settings
COPY settings/php.ini /usr/local/etc/php/conf.d/php.ini

# app sources
COPY src /usr/share/nginx/html
</code></pre>
</dd>
</dl>
<ol>
<li>ベースイメージには PHP の公式イメージを指定しています。</li>
<li>PHP の設定ファイルである php.ini を作成します。</li>
<li>追加で設定するための PHP 設定ファイルを設置しています。</li>
<li>アプリケーションをドキュメントルートにコピーしています。</li>
</ol>
php - Docker Official Images 
<a href="https://hub.docker.com/_/php" rel="noopener noreferrer" target="_blank">https://hub.docker.com/_/php</a>
<h3 id="php-の設定ファイル-phpini-について">PHP の設定ファイル php.ini について</h3>
工程 2 では、PHP に予め用意されているテンプレートからそのまま php.ini を作成し設置しています。
設定値をデフォルトから変更したいものについては、予め用意した php.ini にその設定を記述し、工程 3 で conf.d/ 配下に設置する事で設定値を上書きしています。
<dl class="description_setting">
<dt>php/settings/php.ini</dt>
<dd>
<pre><code class="hljs language-shell">[PHP]
date.timezone = "Asia/Tokyo"
</code></pre>
</dd>
</dl>
なので、変更が不要なら工程 3 の記述は不要です。
<h2 id="nginx-の-dockerfile-を作成">nginx の Dockerfile を作成</h2>
次に、nginx 側の Dockerfile を作成します。
web/ 配下に Dockerfile を作成し以下を記述します。
<dl class="description_setting">
<dt>web/Dockerfile</dt>
<dd>
<pre><code class="hljs language-dockerfile">FROM nginx:1.19-alpine

# settings
COPY settings/default.conf /etc/nginx/conf.d/default.conf
</code></pre>
</dd>
</dl>
<ol>
<li>ベースイメージには nginx の公式イメージを指定しています。</li>
<li>nginx の設定ファイルを設置します。</li>
</ol>
nginx - Docker Official Images 
<a href="https://hub.docker.com/_/nginx" rel="noopener noreferrer" target="_blank">https://hub.docker.com/_/nginx</a>
工程 3 で設置している default.conf は、この時点ではまだ空っぽの状態です。
<h2 id="nginx-と-php-fpm-の通信を定義する">nginx と php-fpm の通信を定義する</h2>
nginx と php-fpm の通信方式は 2 通りあって、それぞれで設定ファイルや Dockerfile への記述が異なります。
<ul>
<li>TCP</li>
<li>UNIX ドメインソケット</li>
</ul>
どちらを採用すべきか？については検証と結論に至れていないので、今回は両方で構築してみます。
<h2 id="tcp-で通信を行う">TCP で通信を行う</h2>
TCP で通信する場合は、nginx の設定ファイルを以下のように定義します。
<dl class="description_setting">
<dt>web/settings/default.conf</dt>
<dd>
<pre><code class="hljs language-shell">server {
 listen 80;
 root /usr/share/nginx/html;

 location / {
 index index.php index.html index.htm;
 fastcgi_pass php-sample:9000;
 fastcgi_index index.php;
 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
 include fastcgi_params;
 }
}
</code></pre>
</dd>
</dl>
設定のもろもろは条件によって書き方が異なるためここの記述自体はかなり簡略化してますが、ポイントは fastcgi_pass の値です。
fastcgi_pass php-sample:9000;
<ul>
<li>php-sample というのは、今回作成する php-fpm のコンテナ名です。この後、php-fpm のコンテナを立ち上げる際にこの名前で起動させるので、それをここに指定します。</li>
<li>:9000 はポート番号です。php-fpm のデフォルトの待受ポートは 9000 なのでこれを指定しています。</li>
</ul>
前項で php-fpm と nginx の、ベースの定義を行いましたが、TCP で通信する場合は nginx の設定ファイルの定義のみで実現できます。
<h3 id="動作確認">動作確認</h3>
ではイメージの作成とコンテナの起動を行いアプリケーションを動作させてみます。
以下のコマンドを実行して環境を構築します。
<pre><code class="hljs language-shell"># 1. PHP のイメージを作成
docker build --no-cache -t php/sample:20210109 .

# 2. nginx のイメージを作成
docker build --no-cache -t nginx/sample:20210109 .

# 3. ネットワークを作成
docker network create --driver bridge sample_nw

# 4. PHP のコンテナを起動
docker run --net=sample_nw --name php-sample php/sample:20210109

# 5. nginx のコンテナを起動
docker run -p 80:80 --net=sample_nw --name nginx-sample nginx/sample:20210109
</code></pre>
ブラウザから http://localhost へアクセスします。
<div class="img_wrap"><img src="/images/posts/220/gxsYV30mzn7T94sm7iIZ.png" width="800" height="295" alt="TCP通信でアプリケーションを実行"></div>
nginx と php-fpm を TCP で通信させてアプリケーションが実行できました。
最終的なファイル構成
<pre><code class="hljs language-shell">docker/
├── php/
│   ├ Dockerfile
│   ├ settings/
│   │   └─ php.ini
│   └ src/
│   └─ index.php
└── web/
 ├ Dockerfile
 └ settings/
 └─ default.conf
</code></pre>
<h2 id="docker-コンテナネットワークについて">Docker コンテナ・ネットワークについて</h2>
先程の環境立ち上げの際に、イメージとコンテナ以外に「ネットワーク」を作成しました。
１つのネットワークを作成しそのネットワークに各コンテナを接続する事で、コンテナ間が互いを識別できるようにしています。
作成したネットワークの詳細を確認すると、コンテナが２つ接続されている事がわかります。
<pre><code class="hljs language-shell"># ネットワークを作成
docker network create --driver bridge sample_nw

# ネットワーク一覧
% docker network ls
NETWORK ID NAME DRIVER SCOPE
9326dc6f3546 sample_nw bridge local

# 作成したネットワークを確認
% docker network inspect sample_nw
[
 {
 "Name": "sample_nw",
 "Id": "9da5326d1311ac663041ec0426bd8704f757da7559511fbaa8f3541a42fd51ef",
 "Created": "2021-01-09T04:31:03.73817688Z",
 "Scope": "local",
 "Driver": "bridge",
 "EnableIPv6": false,
 "IPAM": {
 "Driver": "default",
 "Options": {},
 "Config": [
 {
 "Subnet": "123.45.0.0/16",
 "Gateway": "123.45.0.1"
 }
 ]
 },
 "Internal": false,
 "Attachable": false,
 "Ingress": false,
 "ConfigFrom": {
 "Network": ""
 },
 "ConfigOnly": false,
 "Containers": {
 "658ef76ea2e64cbd70a3b36c0fc05aa5b8af19372da3d314995111d2d15f2431": {
 "Name": "nginx-sample",
 "EndpointID": "27a847dc70353c9411e6bf21a4a3353b60926d4e2a8fcd08c68cecb899151ef9",
 "MacAddress": "12:34:ac:56:78:09",
 "IPv4Address": "123.45.0.3/16",
 "IPv6Address": ""
 },
 "eb1fad3265148727daaabede2818d03ac0e5a40957ad889a2b642ef88cab0bcd": {
 "Name": "php-sample",
 "EndpointID": "1b6e026ccebcf3107a82577a1e02e9ec4b476e930941fe75c5ad1c2e6d9516ae",
 "MacAddress": "12:34:ac:56:78:09",
 "IPv4Address": "123.45.0.2/16",
 "IPv6Address": ""
 }
 },
 "Options": {},
 "Labels": {}
 }
]
</code></pre>
Docker コンテナ・ネットワークの理解 
<a href="http://docs.docker.jp/v17.06/engine/userguide/networking/dockernetworks.html" rel="noopener noreferrer" target="_blank">http://docs.docker.jp/v17.06/engine/userguide/networking/dockernetworks.html</a>
ちなみに、ネットワークを作成せずに、 nginx 側のコンテナ起動時に --link オプションを使って php-fpm 側のコンテナを識別させる方法もありますが、現在では非推奨となっています。
コンテナ・リンク機能（古い機能） 
<a href="http://docs.docker.jp/v17.06/engine/userguide/networking/default_network/dockerlinks.html" rel="noopener noreferrer" target="_blank">http://docs.docker.jp/v17.06/engine/userguide/networking/default_network/dockerlinks.html</a>
<h2 id="unix-ドメインソケット-で通信を行う">UNIX ドメインソケット で通信を行う</h2>
UNIX ドメインソケットで通信する場合に TCP の時と違うのは、通信の為にソケットを指定する事と、nginx 側からソケットを参照できるようにする事です。
<h3 id="php-fpm">php-fpm</h3>
<dl class="description_setting">
<dt>php/Dockerfile</dt>
<dd>
<pre><code class="hljs language-dockerfile">FROM php:8.0-fpm-alpine

# add user
RUN addgroup -S nginx &#x26;&#x26; adduser -S nginx -G nginx

# install setting
RUN cp /usr/local/etc/php/php.ini-production /usr/local/etc/php/php.ini

# settings
COPY settings/zzz-docker.conf /usr/local/etc/php-fpm.d/zzz-docker.conf
COPY settings/php.ini /usr/local/etc/php/conf.d/app-php.ini

# unix socket
RUN mkdir /var/run/php-fpm
VOLUME ["/var/run/php-fpm"]

# app sources
COPY src /usr/share/nginx/html
</code></pre>
</dd>
</dl>
<ol>
<li>ベースイメージには PHP の公式イメージを指定しています。</li>
<li>nginx ユーザを作成します。</li>
<li>PHP の設定ファイルである php.ini を作成します。</li>
<li>php-fpm の設定ファイル（更新分）を設置します。</li>
<li>PHP の設定ファイル（更新分）を設置します。</li>
<li>ソケットを設置するディレクトリを作成し、ボリュームマウントします。</li>
<li>アプリケーションをドキュメントルートにコピーします。</li>
</ol>
php-fpm の設定ファイルはデフォルトで設置されていますが、UNIX ドメインソケットを利用するために値を変更したい（工程 5 のところ）ので、設定値を上書きするための設定ファイルを作成します。
<dl class="description_setting">
<dt>php/settings/zzz-docker.conf</dt>
<dd>
<pre><code class="hljs language-shell">[www]
listen = /var/run/php-fpm/php-fpm.sock
listen.owner = nginx
listen.group = nginx
listen.mode = 0660
</code></pre>
</dd>
</dl>
unix ドメインソケットを使うように指定したのと、ソケットを使用するユーザ（パーミッション）を設定しています。
owner/group は、nginx 側からソケットを参照するユーザを指定しています。
<h3 id="nginx">nginx</h3>
<dl class="description_setting">
<dt>web/Dockerfile</dt>
<dd>
<pre><code class="hljs language-dockerfile">FROM nginx:1.19-alpine

# settings
COPY settings/default.conf /etc/nginx/conf.d/default.conf
</code></pre>
</dd>
</dl>
<ol>
<li>ベースイメージには nginx の公式イメージを指定しています。</li>
<li>nginx の設定ファイルを設置します。</li>
</ol>
Dockerfile は TCP の時と変わりません。
nginx の設定ファイルを以下に定義します。
<dl class="description_setting">
<dt>web/settings/default.conf</dt>
<dd>
<pre><code class="hljs language-shell">server {
 listen 80;
 server_name localhost;
 root /usr/share/nginx/html;

 location / {
 index index.php index.html index.htm;
 fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock;
 fastcgi_index index.php;
 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
 include fastcgi_params;
 }
}
</code></pre>
</dd>
</dl>
TCP の時との違いは、fastcgi_pass に unix ドメインソケットを指定している点です。
<h3 id="動作確認-1">動作確認</h3>
ではイメージの作成とコンテナの起動を行いアプリケーションを動作させてみます。
以下のコマンドを実行して環境を構築します。
<pre><code class="hljs language-shell"># 1. PHP のイメージを作成
docker build --no-cache -t php/sample:20210109 .

# 2. nginx のイメージを作成
docker build --no-cache -t nginx/sample:20210109 .

# 3. PHP のコンテナを起動
docker run --name php-sample php/sample:20210109

# 4. nginx のコンテナを起動
docker run -p 80:80 --volumes-from php-sample --name nginx-sample nginx/sample:20210109
</code></pre>
ブラウザから http://localhost へアクセスします。
<div class="img_wrap"><img src="/images/posts/220/JL8UQQQu5TglPc7etWPJ.png" width="800" height="295" alt="UNIX ドメインソケット通信でアプリケーションを実行"></div>
nginx と php-fpm を UNIX ドメインソケット で通信させてアプリケーションが実行できました。
最終的なファイル構成
<pre><code class="hljs language-shell">docker/
├ php/
│   ├ Dockerfile
│   ├ settings/
│   │   ├─ php.ini
│   │   └─ zzz-docker.conf
│   └ src/
│   └─ index.php
└ web/
 ├ Dockerfile
 └ settings/
 └── default.conf
</code></pre>
<h2 id="まとめ">まとめ</h2>
Laravel や CakePHP 等の PHP フレームワークを動かす際も基本的には同じ要領で、nginx の設定ファイル側を調整したり、必要なパッケージを PHP 側に入れたりなどすれば動作させる事ができます。
実行環境なのでアプリケーションごとイメージに固めていますが、これらの dockerfile と docker-compose を併せて役割を分ければ開発環境の構築も可能です。

Author