Skip to content

ydtg1993/server

Repository files navigation

docker 灵活的构建php环境

        使用docker搭建灵活的线上php环境 有时候你可能不太需要一些别人已经集成了的包或者镜像 
        我们就可以使用以下方式自己动手逐一构建自己所需要的环境结构 并在最后实现一键自动化部署 
        一步一步点亮docker技能树
                                            ##         .
                                      ## ## ##        ==
                                   ## ## ## ## ##    ===
                               /"""""""""""""""""\___/ ===
                          ~~~ {~~ ~~~~ ~~~ ~~~~ ~~~ ~ /  ===- ~~~
                               \______ o           __/
                                 \    \         __/
                                  \____\_______/

最新版本(2026-04)

  • MySQL: 8.4
  • Redis: 7.2
  • PHP: 8.4-fpm
  • Nginx: latest (≥1.25)

升级说明

从旧版 (MySQL 5.7 / Redis 3.2 / PHP 7.2) 升级到最新版需注意:

  1. MySQL 8.4

    • 默认认证插件改为 caching_sha2_password,老客户端需在 my.cnf 设置 default_authentication_plugin=mysql_native_password 或升级客户端。
    • 移除了 query_cache 等选项,检查 /etc/mysql/my.cnf 中是否有废弃指令。
    • 建议使用 mysql_upgrade 工具升级数据(容器首次运行会自动升级)。
  2. Redis 7.2

    • 配置文件与 3.2 不兼容,务必使用新版本默认 redis.conf 然后并排修改。
    • 默认开启保护模式,确保 bindprotected-mode 设置正确,或设置密码。
  3. PHP 8.4

    • 代码需要适配 PHP 7.x → 8.x 的不兼容变更(删除 create_functioneach 等)。
    • 扩展 sodium 已内置,不再需要单独安装;xdebug 等 PECL 扩展需安装兼容版本。
    • www.conf 中的 security.limit_extensions 需包含 .php(或留空允许所有)。
    • 配置文件应基于 8.4 默认模板重新生成。

阶段一 使用docker逐一构建

☆ 首先拉取项目 放到服务器任意目录(到后面你也可以构建自己风格的环境结构)

docker已弃用 --link,改用自定义网络以保证容器间通过名称互访

创建自定义网络(所有容器加入该网络即可通过容器名互访)

        docker network create mynet

启动mysql容器

        docker run --name mydb -p 3306:3306 -e MYSQL_ROOT_PASSWORD=123456 --network mynet -d mysql:8.4

冒号后选择mysql版本 不写版本号默认最新版

注:-MYSQL_ROOT_PASSWORD=123456 给mysql设置初始密码

如果不需要搭建本地数据库直接下一步

启动redis容器

        docker run --name myredis -p 6379:6379 --network mynet -d redis:7.2

注: 如果不需要搭建本地redis直接下一步

启动php容器

        docker run -d -p 9000:9000 --name myphp --network mynet \
                      -v /server/www:/var/www/html \
                      -v /server/php:/usr/local/etc/php \
                      php:8.4-fpm

注: 如果不需要搭建本地数据库或者redis可以省去 --network mynet 及对应的网络连接

注意-v 挂载一个空文件夹是会覆盖容器中的内容,所以配置文件要事先准备好

启动nginx容器

        docker run --name mynginx -d --network mynet -p 80:80 \
                      -v /server/www:/usr/share/nginx/html \
                      -v /server/nginx:/etc/nginx \
                      -v /server/logs/nginx.logs:/var/log/nginx \
                      nginx:latest

-v语句冒号后是容器内的路径,将 nginx 的网页目录、配置目录、日志目录分别挂载到本地的 /server 目录下

使用 --network mynet 后,可以直接通过容器名 myphp 访问 PHP 容器,无需指定 IP(旧版 --link 已废弃)

查看所有容器运行成功 这里环境也就基本搭建完成了
        docker ps -a
容器启动常用相关参数

-i 表示允许我们对容器进行操作

-t 表示在新容器内指定一个为终端

-d 表示容器在后台执行

/bin/bash 这将在容器内启动bash shell

-p 为容器和宿主机创建端口映射

--name 为容器指定一个名字

-v 将容器内路径挂载到宿主机路径

--privileged=true 给容器特权,在挂载目录后容器可以访问目录以下的文件或者目录

--link可以用来链接2个容器,使得源容器(被链接的容器)和接收容器(主动去链接的容器)之间可以通过别名通信,解除了容器之间通信对容器IP的依赖

挂载目录后就可以不用进入容器中修改配置,直接在对应挂载目录下改配置文件 修改nginx配置到 /server/nginx/conf.d/Default.conf

default.conf

PHP扩展库安装(更新至 PHP 8.4-fpm)

首先进入容器

        docker exec -ti myphp /bin/bash

PHP 8.4 镜像已内置常用扩展 pdo、pdo_mysql、mysqli、opcache、sodium 等扩展已默认安装并启用,无需再手动执行 docker-php-ext-install pdo pdo_mysql

安装额外扩展(以 Redis 为例)

方法一:

官方推荐使用 PECL

pecl安装redis

        pecl install redis && docker-php-ext-enable redis

装完扩展 exit退出容器 重启容器

        docker restart myphp
方法二(备选):手动编译安装:

解压并复制到容器中

        tar zxvf /server/php_lib/redis-4.1.0.tgz
        docker cp /server/php_lib/redis-4.1.0 myphp:/usr/src/php/ext/redis

进入容器后编译安装

        docker exec -ti myphp /bin/bash
        cd /usr/src/php/ext/redis
        phpize
        ./configure
        make && make install
        docker-php-ext-enable redis
其它常用命令

停止所有容器

        docker stop $(docker ps -q)

删除所有容器

        docker rm $(docker ps -aq)

删除所有镜像

        docker rmi $(docker images -q)

查看容器配置信息

        docker inspect myphp
构筑自己的目录结构
你也可以构建自己所要的server目录结构 首先要知道挂载一个空文件夹会清空容器中文件夹下所有内容 所以应该先拷贝再挂载
例如: 创建一个临时容器 sudo docker run --name mynginx -p 80:80 -it -d nginx
进入到容器中查自己所要的配置文件目录地址 例如: /etc/nginx 退出容器 
拷贝容器中所要的目录结构到宿主机 例如: docker cp mydb:/etc/nginx /server/nginx
删除容器 创建新容器时就可以挂载该目录了 此后对nginx的配置文件的修改就可以直接在宿主机上快捷操作
docker run --name mynginx -d -p 80:80 -v /server/nginx:/etc/nginx --link myphp:myphp --privileged=true  nginx

阶段二 docker-compose自动化构建

完成以上步骤你就已经初步了解了docker的基本容器操作
docker-compose是编排容器的。例如,你有一个php镜像,一个mysql镜像,一个nginx镜像。如果没有docker-compose,
那么每次启动的时候,你需要敲各个容器的启动参数,环境变量,容器命名,指定不同容器的链接参数等等一系列的操作,
相当繁琐。而用了docker-compose之后,你就可以把这些命令一次性写在docker-compose.yml文件中,以后每次启动
这一整个环境(含3个容器)的时候,你只要敲一个docker-compose up命令就ok了

1. 安装docker-compose

        curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
        
        chmod +x /usr/local/bin/docker-compose  

查看版本信息

        docker-compose --version

2. 一键部署环境

        cd /server/compose
        
        docker-compose up -d

/server/compose/docker-compose.yml已经配置好了可自行调整修改 compose启动即可

docker_yml

对比上面运行容器命令来看docker_yml的配置结构和语义就一目了然了

阶段三 dokcer-compose和dockerfile 完整构建

用了docker-compose实现一键式操作 但问题是PHP的扩展库还是得自己单独装 所以这里需要用到Dockerfile来构建自定义容器镜像
实现真正的一键完成

目录:
   server -|                     
          -| compose.dockerfiles  -| docker-compose.yml
                                  -| mysql -| Dockerfile 这里设置我们自定的dockerfile来构建mysql镜像          
                                   |           
                                  -| nginx -| Dockerfile 这里设置我们自定的dockerfile来构建nginx镜像
                                   |          
                                  -| php -| Dockerfile 这里设置我们自定的dockerfile来构建php镜像
                                   |       
                                  -| redis -| Dockerfile 这里设置我们自定的dockerfile来构建redis镜像

dockerfile

自定义php的dockerfile构建自定义镜像同时安装扩展 完成了所有dockerfile配置后 docker-compose.yml文件就不需要

再用官方镜像image:php-fpm:8.2 而是直接build:./php 直接引用目录配置好的Dockerfile

最后提示: 镜像一旦创建了下次docker-compose会直接取已有镜像而不会build创建 若你修改了Dockerfile配置请记得删除之前镜像

        cd /server/compose.dockerfiles  
        docker-compose up -d

以上就是docker所有的环境配置方式


其他补充

问题1

当你用docker-compose自动化部署后想要更换其中一个容器 假设场景 在自动部署环境后发现nginx容器没有开启443端口

1. 查询自动化部署的容器组环境所在网段

查询所有网段命令

        docker network ls

查询nginx所在网段 找到HostConfig.NetworkMode下所对应值 例如:composedockerfiles_default

        docker inspect mynginx

2. 先删除nginx容器

        docker stop mynginx && docker rm mynginx

3. 重启一个新的nginx容器 并且桥接相同网段

        docker run --name mynginx -d -p 80:80 -p 443:443 -v /server/www:/usr/share/nginx/html -v /server/nginx:/etc/nginx -v /server/logs/nginx.logs:/var/log/nginx --link myphp:myphp --net=composedockerfiles_default --privileged=true nginx

在原来的基础上-p加上新端口443 并且使用网段桥接 --net=composedockerfiles_default

问题2

当你在宿主机上需要用cli模式运行php

        docker exec -i myphp /bin/bash -c '/usr/local/bin/php /var/www/html/blog/public/index.php'

About

docker从入门到自动化构建php环境

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors