本文主要介紹瞭如何使用Docker構建PHP的開發環境,文中作者也探討了構建基於Docker的開發環境應該使用單容器還是多容器,各有什麼利弊。推薦PHP開發者閱讀。希望對大家有所幫助。 環境部署一直是一個很大的問題,無論是開發環境還是生產環境,但是 Docker 將開發環境和生產環境以輕量級方式打包 ...
本文主要介紹瞭如何使用Docker構建PHP的開發環境,文中作者也探討了構建基於Docker的開發環境應該使用單容器還是多容器,各有什麼利弊。推薦PHP開發者閱讀。希望對大家有所幫助。
環境部署一直是一個很大的問題,無論是開發環境還是生產環境,但是 Docker 將開發環境和生產環境以輕量級方式打包,提供了一致的環境。極大的提升了開發部署一致性。當然,實際情況並沒有這麼簡單,因為生產環境和開發環境的配置是完全不同的,比如日誌等的問題都需要單獨配置,但是至少比以前更加簡單方便了,這裡以 PHP 開發作為例子講解 Docker 如何佈置開發環境。
一般來說,一個 PHP 項目會需要以下工具:
- Web 伺服器: Nginx/Tengine
- Web 程式: PHP-FPM
- 資料庫: MySQL/PostgreSQL
- 緩存服務: Redis/Memcache
這是最簡單的架構方式,在 Docker 發展早期,Docker 被大量的濫用,比如,一個鏡像內啟動多服務,日誌收集依舊是按照 Syslog 或者別的老方式,鏡像容量非常龐大,基礎鏡像就能達到 80M,這和 Docker 當初提出的思想完全南轅北轍了,而 Alpine Linux 發行版作為一個輕量級 Linux 環境,就非常適合作為 Docker 基礎鏡像,Docker 官方也推薦使用 Alpine 而不是 Debian 作為基礎鏡像,未來大量的現有官方鏡像也將會遷移到 Alpine 上。本文所有鏡像都將以 Alpine 作為基礎鏡像。
Nginx/Tengine
這部分筆者已經在另一篇文章 Docker 容器的 Nginx 實踐中講解了 Tengine 的 Docker 實踐,並且給出了 Dockerfile,由於比較偏好 Tengine,而且官方已經給出了 Nginx 的 alpine 鏡像,所以這裡就用 Tengine。筆者已經將鏡像上傳到官方 DockerHub,可以通過
<code>docker pull chasontang/tengine:2.1.2_f</code>
獲取鏡像,具體請看 Dockerfile。
PHP-FPM
Docker 官方已經提供了 PHP 的 7.0.7-fpm-alpine 鏡像,Dockerfile 如下:
FROM alpine:3.4
# persistent / runtime deps
ENV PHPIZE_DEPS \
autoconf \
file \
g++ \
gcc \
libc-dev \
make \
pkgconf \
re2c
RUN apk add --no-cache --virtual .persistent-deps \
ca-certificates \
curl
# ensure www-data user exists
RUN set -x \
&& addgroup -g 82 -S www-data \
&& adduser -u 82 -D -S -G www-data www-data
# 82 is the standard uid/gid for "www-data" in Alpine
# http://git.alpinelinux.org/cgit/aports/tree/main/apache2/apache2.pre-install?h=v3.3.2
# http://git.alpinelinux.org/cgit/aports/tree/main/lighttpd/lighttpd.pre-install?h=v3.3.2
# http://git.alpinelinux.org/cgit/aports/tree/main/nginx-initscripts/nginx-initscripts.pre-install?h=v3.3.2
ENV PHP_INI_DIR /usr/local/etc/php
RUN mkdir -p $PHP_INI_DIR/conf.d
##<autogenerated>##
ENV PHP_EXTRA_CONFIGURE_ARGS --enable-fpm --with-fpm-user=www-data --with-fpm-group=www-data
##</autogenerated>##
ENV GPG_KEYS 1A4E8B7277C42E53DBA9C7B9BCAA30EA9C0D5763
ENV PHP_VERSION 7.0.7
ENV PHP_FILENAME php-7.0.7.tar.xz
ENV PHP_SHA256 9cc64a7459242c79c10e79d74feaf5bae3541f604966ceb600c3d2e8f5fe4794
RUN set -xe \
&& apk add --no-cache --virtual .build-deps \
$PHPIZE_DEPS \
curl-dev \
gnupg \
libedit-dev \
libxml2-dev \
openssl-dev \
sqlite-dev \
&& curl -fSL "http://php.net/get/$PHP_FILENAME/from/this/mirror" -o "$PHP_FILENAME" \
&& echo "$PHP_SHA256 *$PHP_FILENAME" | sha256sum -c - \
&& curl -fSL "http://php.net/get/$PHP_FILENAME.asc/from/this/mirror" -o "$PHP_FILENAME.asc" \
&& export GNUPGHOME="$(mktemp -d)" \
&& for key in $GPG_KEYS; do \
gpg --keyserver ha.pool.sks-keyservers.net --recv-keys "$key"; \
done \
&& gpg --batch --verify "$PHP_FILENAME.asc" "$PHP_FILENAME" \
&& rm -r "$GNUPGHOME" "$PHP_FILENAME.asc" \
&& mkdir -p /usr/src \
&& tar -Jxf "$PHP_FILENAME" -C /usr/src \
&& mv "/usr/src/php-$PHP_VERSION" /usr/src/php \
&& rm "$PHP_FILENAME" \
&& cd /usr/src/php \
&& ./configure \
--with-config-file-path="$PHP_INI_DIR" \
--with-config-file-scan-dir="$PHP_INI_DIR/conf.d" \
$PHP_EXTRA_CONFIGURE_ARGS \
--disable-cgi \
# --enable-mysqlnd is included here because it's harder to compile after the fact than extensions are (since it's a plugin for several extensions, not an extension in itself)
--enable-mysqlnd \
# --enable-mbstring is included here because otherwise there's no way to get pecl to use it properly (see https://github.com/docker-library/php/issues/195)
--enable-mbstring \
--with-curl \
--with-libedit \
--with-openssl \
--with-zlib \
&& make -j"$(getconf _NPROCESSORS_ONLN)" \
&& make install \
&& { find /usr/local/bin /usr/local/sbin -type f -perm +0111 -exec strip --strip-all '{}' + || true; } \
&& make clean \
&& runDeps="$( \
scanelf --needed --nobanner --recursive /usr/local \
| awk '{ gsub(/,/, "\nso:", $2); print "so:" $2 }' \
| sort -u \
| xargs -r apk info --installed \
| sort -u \
)" \
&& apk add --no-cache --virtual .php-rundeps $runDeps \
&& apk del .build-deps
COPY docker-php-ext-* /usr/local/bin/
##<autogenerated>##
WORKDIR /var/www/html
RUN set -ex \
&& cd /usr/local/etc \
&& if [ -d php-fpm.d ]; then \
# for some reason, upstream's php-fpm.conf.default has "include=NONE/etc/php-fpm.d/*.conf"
sed 's!=NONE/!=!g' php-fpm.conf.default | tee php-fpm.conf > /dev/null; \
cp php-fpm.d/www.conf.default php-fpm.d/www.conf; \
else \
# PHP 5.x don't use "include=" by default, so we'll create our own simple config that mimics PHP 7+ for consistency
mkdir php-fpm.d; \
cp php-fpm.conf.default php-fpm.d/www.conf; \
{ \
echo '[global]'; \
echo 'include=etc/php-fpm.d/*.conf'; \
} | tee php-fpm.conf; \
fi \
&& { \
echo '[global]'; \
echo 'error_log = /proc/self/fd/2'; \
echo; \
echo '[www]'; \
echo '; if we send this to /proc/self/fd/1, it never appears'; \
echo 'access.log = /proc/self/fd/2'; \
echo; \
echo 'clear_env = no'; \
echo; \
echo '; Ensure worker stdout and stderr are sent to the main error log.'; \
echo 'catch_workers_output = yes'; \
} | tee php-fpm.d/docker.conf \
&& { \
echo '[global]'; \
echo 'daemonize = no'; \
echo; \
echo '[www]'; \
echo 'listen = [::]:9000'; \
} | tee php-fpm.d/zz-docker.conf
EXPOSE 9000
CMD ["php-fpm"]
##</autogenerated>##
首先,鏡像繼承自 alpine:3.4 鏡像,使用 apk 命令安裝 php 最小依賴,同時添加 www-data 作為 php-fpm 的運行用戶,將 php 的配置文件指定到 /usr/local/etc/php,然後就是下載 php-src,編譯安裝,這裡可以參考筆者之前寫的 php 編譯安裝文章。參數都中規中矩。安裝目錄被指定到 /usr/local,然後使用 scanelf 獲得所依賴的運行庫列表,並且將其他安裝包刪除。將 docker-php-ext-configure、docker-php-ext-enable、docker-php-ext-install 複製到容器中,這三個文件用於後續安裝擴展。然後將 php-fpm.conf 複製到配置目錄,將 error_log 和 access_log 指定到終端標準輸出,daemonize = no 表示不以服務進程運行。EXPOSE 9000 埠用於和其他容器通信,然後就是 CMD ["php-fpm"] 運行 php-fpm。而且工作目錄被指定到 /var/www/html。
docker-compose
已經搞定了基礎鏡像,我們就可以使用基礎鏡像來配置容器,但是通過手工 docker 命令啟動容器會非常麻煩。但是萬幸的是官方已經提供了 docker-compose 命令來編排容器,只需要寫一個 docker-compose.yaml 文件就行,具體可以參考官方文檔。
version: '2'
services:
php-fpm:
image: php:7.0.7-fpm-alpine
volumes:
- "./src:/var/www/html"
restart: always
tengine:
depends_on:
- php-fpm
links:
- php-fpm
image: chasontang/tengine:2.1.2_f
volumes:
- "./nginx.vh.default.conf:/etc/nginx/conf.d/default.conf"
ports:
- "80:80"
restart: always
非常容易理解,這裡定義了兩個服務,php-fpm 依賴 php:7.0.7-fpm-alpine 鏡像,並且將 src 文件夾映射為 /var/www/html 文件夾,tengine 服務依賴 php-fpm 服務,並且 link php-fpm 服務,這樣就能通過網路與 php-fpm 容器通信,tengine 服務基於 chasontang/tengine:2.1.2_f 鏡像,並將 nginx.vh.default.conf 文件映射為 /etc/nginx/conf.d/default.conf 文件。然後來看 nginx.vh.default.conf
server {
listen 80;
server_name localhost;
#charset koi8-r;
#access_log logs/host.access.log main;
location / {
root html;
index index.html index.htm;
}
#error_page 404 /404.html;
# redirect server error pages to the static page /50x.html
#
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root html;
}
# proxy the PHP scripts to Apache listening on 127.0.0.1:80
#
#location ~ \.php$ {
# proxy_pass http://127.0.0.1;
#}
location ~ [^/]\.php(/|$) {
fastcgi_split_path_info ^(.+?\.php)(/.*)$;
fastcgi_pass php-fpm:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME /var/www/html$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
include fastcgi_params;
}
# deny access to .htaccess files, if Apache's document root
# concurs with nginx's one
#
#location ~ /\.ht {
# deny all;
#}
}
的所有文件,因為 /etc/nginx/nginx.conf 中使用 include /etc/nginx/conf.d/*.conf; 包含了這個目錄,也就是說,可以不需要去管 nginx 其他配置,只需要用自己的 nginx 虛擬主機配置替代預設的虛擬主機配置,或者說增加虛擬主機配置就行了。
從上面可以看到,default.conf 文件定義了一個 location 匹配包含 .php 的 URL,然後將其分割出 PATH_INFO 參數,將這些變數傳遞給 php-fpm:9000 的 php-fpm 服務。
這裡需要註意的是,由於 Nginx 和 PHP-FPM 不在同一臺主機上,所以 Nginx 只做靜態文件處理和路由轉發,實際的 PHP 文件執行時在 PHP-FPM 容器中發生的。所以 SCRIPT_FILENAME 變數必須要使用 PHP-FPM 容器中的目錄,所以這裡使用硬編碼指定。當然,也可以讓兩個容器共用同一個數據捲,但是筆者認為,這隻是為了方便容器編排,其他完全沒有好處。
很容易吧! 現在我們可以快速的啟動、更新環境了。
以上就是如何使用Docker部署PHP開發環境的詳細內容
以上內容希望幫助到大家,很多PHPer在進階的時候總會遇到一些問題和瓶頸,業務代碼寫多了沒有方向感,不知道該從那裡入手去提升,對此我整理了一些資料,包括但不限於:分散式架構、高可擴展、高性能、高併發、伺服器性能調優、TP6,laravel,YII2,Redis,Swoole、Swoft、Kafka、Mysql優化、shell腳本、Docker、微服務、Nginx等多個知識點高級進階乾貨需要的可以免費分享給大家,需要的可以加入我的官方群點擊此處。