Nginx on Yison's Blog

Docker从零构建php-nginx-alpine镜像

Fri, 09 Nov 2018 00:00:00 +0000

虽然之前用 Docker 环境运行了一些项目，但对于镜像这块还不是很理解，且网上现成的镜像都包含太多用不到的库，所以决定从零开始构建一个自己的镜像。

选择 Alpine Linux 作为基础镜像

# 拉取 Alpine 镜像
docker pull alpine:latest

# 查看镜像
docker images alpine

Alpine Linux 是一个面向安全的轻量级 Linux 发行版，镜像只有 5MB 左右。

运行并进入容器

# 交互式运行
docker run -it alpine /bin/sh

# 或后台运行
docker run -d --name my-alpine alpine:latest
docker exec -it my-alpine /bin/sh

安装 PHP 和 Nginx

# 更新包索引
apk update

# 安装 PHP 和 Nginx
apk add php7 php7-fpm php7-cli nginx

# 如果使用 PHP 8.x
apk add php81 php81-fpm php81-cli nginx

⚠️ 提示：Alpine 3.18+ 使用 php81、php82 等命名

安装 PHP 扩展

# 安装常用扩展
apk add php7-mysqli \
 php7-pdo_mysql \
 php7-mbstring \
 php7-json \
 php7-zlib \
 php7-gd \
 php7-intl \
 php7-session \
 php7-curl \
 php7-posix \
 php7-fileinfo \
 php7-simplexml \
 php7-xml \
 php7-openssl \
 php7-dom \
 php7-phar

# PHP 8.x 扩展
apk add php81-mysqli php81-pdo_mysql php81-mbstring php81-xml php81-curl

目录结构

软件	路径
PHP 配置	`/etc/php7`
Nginx 配置	`/etc/nginx`
网站目录	`/var/www/localhost/htdocs`
日志目录	`/var/log/nginx`

配置 PHP-FPM

修改 www.conf

vi /etc/php7/php-fpm.d/www.conf

[www]
user = nobody
group = nobody
listen = 127.0.0.1:9000

配置 Nginx

nginx.conf

vi /etc/nginx/nginx.conf

worker_processes auto;
error_log /var/log/nginx/error.log warn;
pid /run/nginx.pid;

events {
 worker_connections 1024;
}

http {
 include /etc/nginx/mime.types;
 default_type application/octet-stream;
 
 log_format main '$remote_addr - $remote_user [$time_local] "$request" '
 '$status $body_bytes_sent "$http_referer" '
 '"$http_user_agent" "$http_x_forwarded_for"';
 
 access_log /var/log/nginx/access.log main;
 
 sendfile on;
 keepalive_timeout 65;
 
 include /etc/nginx/conf.d/*.conf;
}

default.conf

vi /etc/nginx/conf.d/default.conf

server {
 listen 80 default_server;
 root /var/www/localhost/htdocs;
 index index.php index.html;
 
 server_name localhost;
 
 location / {
 try_files $uri $uri/ =404;
 }
 
 location ~ \.php$ {
 fastcgi_pass 127.0.0.1:9000;
 fastcgi_index index.php;
 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
 include fastcgi_params;
 }
 
 location ~ /\.ht {
 deny all;
 }
}

启动服务

# 创建必要的目录
mkdir -p /run/nginx

# 启动 PHP-FPM
/usr/sbin/php-fpm7

# 启动 Nginx
/usr/sbin/nginx

# 测试
curl http://localhost

创建 Dockerfile

基础版本

# Dockerfile
FROM alpine:latest

LABEL maintainer="yisonli <email@example.com>"
LABEL version="1.0"
LABEL description="PHP7 + Nginx on Alpine Linux"

# 安装系统工具
RUN apk add --no-cache \
 openssl \
 curl \
 ca-certificates \
 bash

# 安装 PHP 和扩展
RUN apk add --no-cache \
 php7 \
 php7-fpm \
 php7-mysqli \
 php7-pdo_mysql \
 php7-mbstring \
 php7-json \
 php7-gd \
 php7-curl

# 安装 Nginx
RUN apk add --no-cache nginx

# 配置 PHP-FPM
RUN mkdir -p /run/nginx \
 && chown -R nobody:nobody /var/www/localhost

# 复制配置文件
COPY nginx.conf /etc/nginx/nginx.conf
COPY default.conf /etc/nginx/conf.d/
COPY php.ini /etc/php7/php.ini
COPY php-fpm.conf /etc/php7/php-fpm.conf

# 复制应用代码
COPY ./app /var/www/localhost/htdocs

# 暴露端口
EXPOSE 80 443

# 启动脚本
COPY start.sh /start.sh
RUN chmod +x /start.sh

CMD ["/start.sh"]

启动脚本

#!/bin/sh
# start.sh

# 创建必要目录
mkdir -p /run/nginx /var/log/nginx /var/tmp/php-fpm

# 设置权限
chown -R nobody:nobody /var/www/localhost

# 启动 PHP-FPM
/usr/sbin/php-fpm7 &

# 启动 Nginx
/usr/sbin/nginx -g 'daemon off;'

PHP 配置文件

; php.ini
upload_max_filesize = 50M
post_max_size = 50M
memory_limit = 128M
max_execution_time = 300

docker-compose.yml

version: '3.8'

services:
 web:
 build: .
 ports:
 - "8080:80"
 volumes:
 - ./app:/var/www/localhost/htdocs
 environment:
 - PHP_MEMORY_LIMIT=256M
 restart: unless-stopped

 mysql:
 image: mysql:8.0
 environment:
 MYSQL_ROOT_PASSWORD: secret
 MYSQL_DATABASE: app
 volumes:
 - mysql_data:/var/lib/mysql

volumes:
 mysql_data:

构建并运行

# 构建镜像
docker build -t my-php-app:1.0 .

# 运行容器
docker run -d -p 8080:80 --name my-app my-php-app:1.0

# 使用 docker-compose
docker-compose up -d

# 查看日志
docker logs -f my-app

# 进入容器
docker exec -it my-app /bin/sh

常用 Docker 命令

# 查看运行中的容器
docker ps

# 查看所有容器
docker ps -a

# 删除未运行的容器
docker rm $(docker ps -a -q)

# 提交镜像
docker commit -a "yisonli" -m "my php7-nginx" CONTAINER_ID my-php-app:0.1

# 添加标签
docker tag IMAGE_ID my-repo/my-image:tag

# 推送镜像
docker push my-repo/my-image:tag

共享文件夹

# 挂载本地目录
docker run -v $(pwd)/www:/var/www/localhost/htdocs \
 -p 8080:80 \
 my-php-app:1.0

优化建议

使用多阶段构建减小镜像体积
合并 RUN 指令减少层数
使用 .dockerignore排除不需要的文件
使用国内镜像源加速构建

多阶段构建示例

# 构建阶段
FROM composer:2 as builder
WORKDIR /app
COPY composer.* ./
RUN composer install --no-dev
COPY . .
RUN composer dump-autoload --optimize

# 运行阶段
FROM alpine:latest
COPY --from=builder /app /var/www/localhost/htdocs
# ...

参考链接

PHP7和Nginx安装记录

Thu, 02 Jun 2016 00:00:00 +0000

本文主要记录 PHP7 + Nginx 的编译安装以及环境搭建的操作步骤

1. 获取 PHP 源码

# 下载 PHP 7.0.7（注意：PHP 7.0 已停止维护，建议使用更高版本）
sudo wget http://cn2.php.net/distributions/php-7.0.7.tar.xz

# 解压
tar -xvf php-7.0.7.tar.xz
cd php-7.0.7

⚠️ 提示：PHP 7.0 已停止维护，建议使用 PHP 7.4 或 PHP 8.x

2. 安装依赖

sudo apt-get update

sudo apt-get install -y \
 nginx \
 mysql-client \
 git \
 build-essential \
 libxml2-dev \
 libssl-dev \
 libcurl4-openssl-dev \
 libjpeg-dev \
 libpng-dev \
 libmcrypt-dev \
 libreadline-dev \
 libgmp-dev \
 libzip-dev \
 libonig-dev \
 libicu-dev

现代推荐：如果安装 PHP 8.x，mcrypt 已被移除，gd 扩展改为 libgd-dev

3. 编译 PHP

cd php-7.0.7

sudo ./configure \
 --prefix=/usr/local/php7 \
 --enable-fpm \
 --enable-inline-optimization \
 --disable-debug \
 --disable-rpath \
 --enable-shared \
 --enable-opcache \
 --with-mysqli \
 --with-mysql-sock \
 --enable-pdo \
 --with-pdo-mysql \
 --with-gettext \
 --enable-mbstring \
 --with-iconv \
 --enable-bcmath \
 --enable-soap \
 --with-libxml-dir \
 --enable-pcntl \
 --enable-shmop \
 --enable-sysvmsg \
 --enable-sysvsem \
 --enable-sysvshm \
 --enable-sockets \
 --with-curl \
 --with-zlib \
 --enable-zip \
 --with-readline \
 --with-pear \
 --with-gd \
 --with-jpeg-dir=/usr/lib \
 --enable-gd-native-ttf \
 --enable-xml

# 编译安装
sudo make -j$(nproc)
sudo make install

# 创建软链接
sudo ln -s /usr/local/php7 /usr/local/php

# 复制配置文件
sudo cp php.ini-production /usr/local/php/lib/php.ini

⚠️ 警告：--with-mysql 在 PHP 7.0 中已被移除，请使用 --with-mysqli

4. 配置 PHP-FPM

cd /usr/local/php/etc

# 复制默认配置
sudo cp php-fpm.conf.default php-fpm.conf
cd /usr/local/php/etc/php-fpm.d
sudo cp www.conf.default www.conf

# 编辑 www.conf
sudo vim www.conf

修改用户和组：

[www]
user = www-data
group = www-data

; 如果使用 socket 连接
listen = /run/php/php-fpm.sock
listen.owner = www-data
listen.group = www-data
listen.mode = 0660

如果 www-data 用户不存在，需要先创建：

sudo groupadd -g 33 www-data
sudo useradd -g www-data -u 33 -s /usr/sbin/nologin www-data

5. 启动 PHP-FPM

# 启动 php-fpm
sudo /usr/local/php/sbin/php-fpm

# 添加到系统 PATH
sudo tee -a /etc/profile << 'EOF'
export PATH=$PATH:/usr/local/php/bin:/usr/local/php/sbin
EOF
source /etc/profile

# 验证安装
php -v
php-fpm -v

6. Nginx 配置

cd /etc/nginx/sites-enabled
sudo vim default

修改 PHP 配置文件块：

server {
 listen 80 default_server;
 root /var/www/html;
 
 index index.php index.html index.htm;

 server_name _;

 location / {
 try_files $uri $uri/ =404;
 }

 # PHP 配置
 location ~ \.php$ {
 fastcgi_split_path_info ^(.+\.php)(/.+)$;
 fastcgi_pass unix:/run/php/php-fpm.sock;
 # 或者使用 IP:9000
 # fastcgi_pass 127.0.0.1:9000;
 fastcgi_index index.php;
 include fastcgi_params;
 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
 }

 # 禁止访问隐藏文件
 location ~ /\. {
 deny all;
 }
}

# 重载 Nginx 配置
sudo nginx -t
sudo service nginx reload

7. 测试

创建测试文件：

<?php
// /var/www/html/info.php
phpinfo();

访问 http://your_server_ip/info.php

⚠️ 安全提醒：测试完成后记得删除 info.php

8. 腾讯云/阿里云安全组

重要：记得在云控制台开放 80 端口的安全组规则！

现代安装方式推荐

使用 Ondrej PPA（Ubuntu/Debian）

sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install php8.1-fpm php8.1-mysql php8.1-curl php8.1-gd php8.1-mbstring php8.1-xml php8.1-zip

使用 Remi（CentOS/RHEL）

sudo dnf install epel-release
sudo dnf install dnf-utils
sudo dnf module reset php
sudo dnf module enable php:8.1
sudo dnf install php php-fpm php-mysqlnd

常见问题

问题	解决方案
make 报错	检查依赖是否安装完整
php-fpm 无法启动	检查用户权限和 socket 路径
502 Bad Gateway	检查 php-fpm 是否运行，socket 权限
访问不到 PHP	检查 Nginx fastcgi_pass 配置