镜像概述和主要用途

本镜像为基于Nginx（带SSL支持）和PHP7的Phalcon应用服务器镜像，主要用于部署Phalcon框架开发的Web应用。它集成了Nginx作为Web服务器和PHP7运行环境，支持SSL加密、日志持久化、自定义配置等功能，适用于开发和生产环境的Phalcon应用部署。

核心功能和特性

• 集成环境：Nginx Web服务器与PHP7运行环境，预装Phalcon框架及多种PHP扩展
• SSL支持：可通过挂载证书目录启用SSL加密，支持自定义域名证书
• 灵活配置：通过环境变量自定义Nginx、PHP-FPM配置及应用根目录
• 卷挂载：支持应用代码、日志文件、SSL证书等目录的持久化存储
• 多PHP扩展：包含redis、mongodb、apcu、swoole等常用PHP扩展，满足多样化应用需求

使用场景和适用范围

• 开发和生产环境下的Phalcon Web应用部署
• 需要自定义Nginx配置或PHP参数的Web服务场景
• 需启用SSL加密的HTTPS服务部署
• 需要持久化存储应用日志的场景
• 需集成多种PHP扩展的Web应用需求

详细使用方法和配置说明

卷挂载（Volumes）

/var/www

• 用途：存放应用代码
• 示例：-v /home/project/:/var/www/（将本地项目目录挂载至容器内应用目录）
• 说明：应用文档根目录需为该目录下的public/子目录

/var/log/nginx

• 用途：Nginx日志存储
• 可选挂载：如需在容器外查看日志，可挂载此目录
• 示例：-v /home/logs/nginx:/var/log/nginx

/var/certs

• 用途：存放SSL证书文件
• 可选挂载：启用SSL时需挂载此目录，存放域名对应的证书和密钥文件
• 说明：证书文件命名格式为${DOMAIN}.crt，密钥文件为${DOMAIN}.key

/usr/local/share/ca-certificates/local

• 用途：添加可信本地证书
• 可选挂载：如需添加自定义可信证书，可挂载此目录

环境变量（Env variables）

DOMAIN

• 可选
• 用途：域名名称
• 默认值：null

USE_SSL

• 可选
• 用途：启用SSL（需配合/var/certs目录挂载）
• 取值：yes（同时启用HTTP和HTTPS）、only（仅启用HTTPS）、null（禁用SSL）
• 说明：启用时需确保/var/certs/${DOMAIN}.crt和/var/certs/${DOMAIN}.key存在

DEBUG

• 可选
• 用途：是否显示PHP错误信息
• 取值：yes（显示错误）、null（不显示）

WEBROOT

• 可选，默认值：/var/www/public
• 用途：应用文档根目录
• 说明：需与/var/www挂载的应用代码目录结构匹配，默认指向/var/www/public

SHOW_VERSION

• 可选
• 用途：是否显示PHP和Nginx版本信息
• 取值：yes（显示版本）、null（不显示）

TZ

• 默认值：Asia/Seoul
• 用途：设置容器时区

FPM_LISTEN

• 可选，默认值：/dev/shm/php-fpm.sock
• 用途：PHP-FPM监听地址
• 取值：/dev/shm/php-fpm.sock（Unix套接字）或localhost:9000（TCP端口）

FASTCGI_PASS

• 可选，默认值：unix:/dev/shm/php-fpm.sock
• 用途：Nginx FastCGI代理目标地址
• 取值：需与FPM_LISTEN对应，如unix:/dev/shm/php-fpm.sock或localhost:9000

PHP_POST_MAX_SIZE

• 可选
• 用途：设置PHP最大POST请求大小

PHP_UPLOAD_MAX_FILESIZE

• 可选
• 用途：设置PHP最大上传文件大小

NGINX_CORS

• 可选
• 用途：启用CORS（跨域资源共享）
• 取值：yes（启用）、null（禁用）

NGINX_CORS_ORIGIN

• 可选，默认值：*
• 用途：设置Access-Control-Allow-Origin响应头值

NGINX_CORS_METHODS

• 可选
• 用途：设置Access-Control-Allow-Methods响应头值

NGINX_CORS_HEADERS

• 可选
• 用途：设置Access-Control-Allow-Headers响应头值

PROXY_VARIABLES_FIXED

• 可选
• 用途：修改转发前的REMOTE_ADDR、REQUEST_SCHEME、SERVER_PROTOCOL、SERVER_PORT变量值
• 取值：yes（启用修改）、null（禁用）

版本信息

• 基础系统：UBUNTU 16.04
• Dockerize：0.6.1
• Nginx：1.14.0
• Libv8：6.6
• Librrabbitmq：0.8.0
• PHP：7.2.5（包含以下扩展）
  • phalcon 3.3.2
  • redis 4.0.2
  • yaml 2.0.2
  • memcached 3.0.4
  • mongodb 1.4.3
  • couchbase 2.4.6
  • cassandra 1.3.2
  • apcu 5.1.11
  • uuid 1.0.4
  • amqp 1.9.3
  • v8js 2.1.0
  • v8 0.2.2
  • sodium 2.0.10
  • ev 1.0.4
  • uv 0.2.2
  • ssh2 1.1.2
  • gearman 2.0.3
  • imagick 3.4.3
  • igbinary 2.0.5
  • msgpack 2.0.2
  • swoole 2.1.3
  • pdo_mysql
  • pdo_sqlite
  • pdo_pgsql
  • pdo_sqlsrv 5.2.0

构建选项（Build Options）

• REPOGITORY_URL：代码仓库URL
• NGINX_VERSION：Nginx版本
• NJS_VERSION：NJS版本
• NGINX_GPGKEY：Nginx GPG密钥
• PHP_VERSION：PHP版本
• PHP_GPGKEYS：PHP GPG密钥
• PHP_SHA256：PHP源码包SHA256校验值（文件类型为php-*.tar.xz）
• BUILD_EXTENSIONS：
  • 可选，默认值：null（构建所有扩展）
  • 用途：指定需构建的PHP扩展，多个扩展用空格分隔
  • 可选扩展列表：bcmath calendar ctype gettext gmp hash iconv intl pcntl shmop posix pdo pdo_mysql session sockets apcu opcache uuid json igbinary msgpack yaml dom xml xmlreader xmlwriter simplexml xsl soap xmlrpc wddx memcached mongodb redis amqp gearman zip bz2 phar tidy tokenizer screwim sodium ev uv phalcon swoole snmp exif fileinfo gd imagick ssh2 dba enchant pspell recode sqlite3 pdo_pgsql pdo_sqlite pdo_sqlsrv v8js v8 sysvsem sysvshm sysvmsg

使用示例

构建镜像

bash
docker build .

基本运行（默认80端口）

bash
docker run -p 80:80 -d yejune/webserver

仅启用SSL（需挂载证书）

bash
docker run -p 80:80 -p 443:443 -e USE_SSL=only -v `pwd`/var/certs:/var/certs -v `pwd`/var/certs:/usr/local/share/ca-certificates/local -v `pwd`:/var/www/ -d yejune/webserver

不启用SSL运行

bash
docker run -p 80:80 -v `pwd`:/var/www/ -d yejune/webserver

使用非标准端口

bash
docker run -p 8080:80 -p 8443:443 -e USE_SSL=on -v `pwd`/var/certs:/var/certs -v `pwd`:/var/www/ -d yejune/webserver

持久化存储日志

bash
docker run -p 80:80 -v `pwd`/var/log/nginx:/var/log/nginx -v `pwd`:/var/www/ -d yejune/webserver