本项目是一套用于 PHP 的 Docker 开发环境。
为什么会有这个项目：
- 开箱即用，首次启动不需要进行构建，启动时间短
- 所有镜像
TZ环境变量都会生效 - 限制
docker logs日志大小 - 等等...
大部分场景下，我们希望开箱即用。当然，凡事都有两面性，不需要构建的代价，就是对镜像的定制化能力变低，看个人取舍。
重要的事情说三遍：
该项目仅适用于本地开发，不能直接用于生产环境
该项目仅适用于本地开发，不能直接用于生产环境
该项目仅适用于本地开发，不能直接用于生产环境
目前支持开箱即用的服务有：
- Mysql5.7（使用官方镜像）
- Mysql8.3（使用官方镜像）
- phpMyAdmin（使用官方镜像）
- Redis7.2（使用官方镜像）
- phpRedisAdmin（使用官方镜像）
- Memcached（使用官方镜像）
- PHP8.3/PHP8.2/PHP8.1/PHP8.0/PHP7.4/PHP7.3（使用基于官方的集成镜像 suyar/php:x.x-integration）
- Nginx（使用官方镜像）
- RabbitMQ（使用官方镜像）
- MongoDB（使用官方镜像）
- Mongo-Express（使用官方镜像）
- Elasticsearch（使用官方镜像）
- Kibana（使用官方镜像）
目录
1. 目录结构
/
├── data
│ ├── composer Composer 缓存
│ ├── elasticsearch Elasticsearch 持久化数据
│ ├── mongodb MongoDB 持久化数据
│ ├── mysql5 Mysql5.7 持久化数据
│ ├── mysql8 Mysql8.2 持久化数据
│ ├── rabbitmq Rabbitmq 持久化数据
│ └── redis Redis 持久化数据
├── logs
│ ├── mongodb MongoDB 日志
│ ├── mysql
│ │ ├── 5 Mysql5.7 日志
│ │ └── 8 Mysql8.2 日志
│ ├── nginx Nginx 日志
│ ├── php
│ │ ├── 73
│ │ │ ├── log PHP7.3 错误日志与慢日志
│ │ │ └── supervisor PHP7.3 里 supervisor 日志
│ │ ├── 74
│ │ │ ├── log PHP7.4 错误日志与慢日志
│ │ │ └── supervisor PHP7.4 里 supervisor 日志
│ │ ├── 80
│ │ │ ├── log PHP8.0 错误日志与慢日志
│ │ │ └── supervisor PHP8.0 里 supervisor 日志
│ │ ├── 81
│ │ │ ├── log PHP8.1 错误日志与慢日志
│ │ │ └── supervisor PHP8.1 里 supervisor 日志
│ │ ├── 82
│ │ │ ├── log PHP8.2 错误日志与慢日志
│ │ │ └── supervisor PHP8.2 里 supervisor 日志
│ │ └── 83
│ │ ├── log PHP8.3 错误日志与慢日志
│ │ └── supervisor PHP8.3 里 supervisor 日志
│ └── rabbitmq Rabbitmq 日志
├── services
│ ├── elasticsearch Elasticsearch 配置目录
│ ├── mongodb MongoDB 配置目录
│ ├── mysql Mysql5.7/Mysql8.2 配置目录
│ ├── nginx Nginx 配置目录
│ │ ├── conf.d Nginx Vhost 配置目录
│ │ └── ssl Nginx 证书目录
│ ├── php
│ │ ├── 73 PHP7.3 配置目录
│ │ ├── 74 PHP7.4 配置目录
│ │ ├── 80 PHP8.0 配置目录
│ │ ├── 81 PHP8.1 配置目录
│ │ ├── 82 PHP8.2 配置目录
│ │ └── 83 PHP8.3 配置目录
│ ├── phpmyadmin phpMyAdmin 配置目录
│ ├── rabbitmq Rabbitmq 配置目录
│ └── redis Redis 配置目录
├── .bash_aliases.example .bash_aliases 示例配置
├── .env.example .env 变量示例配置
├── docker-compose.yml.example docker-compose 示例
├── dpe.sh 初始化脚本
└── www 默认项目代码存放目录
2. 快速使用
-
环境要求
-
Windows
- 安装 Docker Desktop
- 安装
wsl2，建议安装 Ubuntu：wsl --install -d Ubuntu - 在
Docker Desktop启用Use the WSL 2 base engine - 在
Docker Desktop启用WSL Integration - 因为
wsl2文件有挂载性能问题，该项目必须放在wsl2系统内，而不能放在/mnt/c或/mnt/d这种挂载目录下 - 项目代码也建议放在
wsl2系统内，使用vscode或phpstorm进行编辑开发
-
Linux
- 安装 Docker
- 安装 Docker Compose
-
MacOS
- 未尝试
-
-
clone项目建议 fork 本项目，方便针对自己的开发需求做定制。
# git clone git@github.com:suyar/docker-php-env.git -
初始化项目
该操作会初始化目录权限和相关文件：
# cd docker-php-env # git config core.filemode false # sudo chmod +x dpe.sh # sudo ./dpe.sh init执行完成后，根据自己的需求，对
.env文件和docker-compose.yml进行定制。 -
启动项目
# sudo docker-compose up -d -
在浏览器中访问：
http://localhost或http://127.0.0.1，初始页面会显示404。
3. PHP 扩展
3.1 PHP 预置扩展
PHP 镜像默认安装了下列扩展，暂不支持重新安装指定版本扩展，可以 fork 本项目后，参照 docker-php 自己构建。
[PHP Modules]
amqp
apcu
bcmath
bz2
calendar
Core
ctype
curl
date
decimal
dom
enchant
event
exif
fileinfo
filter
ftp
gd
gettext
gmp
hash
iconv
igbinary
imagick
intl
json
libxml
lzf
mbstring
memcached
mongodb
msgpack
mysqli
mysqlnd
openssl
pcntl
pcre
PDO
pdo_mysql
pdo_pgsql
pdo_sqlite
pgsql
Phar
posix
readline
redis
Reflection
session
SimpleXML
sockets
sodium
SPL
sqlite3
standard
swoole
tidy
timezonedb
tokenizer
uuid
xlswriter
xml
xmlreader
xmlwriter
xsl
yac
yaml
Zend OPcache
zip
zlib
[Zend Modules]
Zend OPcache
3.2 安装 PHP 扩展
除了预置的扩展，如果你还想安装其他扩展，可以直接执行：
# sudo docker-compose exec php83 install-php-extensions xxx
支持的扩展在这边可以在这边查看：docker-php-extension-installer。
通过这种方式安装的扩展，在容器销毁后重新创建，不会保留，需要重新安装。
3.3 在 PHP 容器中执行命令
# sudo docker-compose exec php83 bash
root@php83:/www# php -v
3.4 使用 composer
# sudo docker-compose exec php83 bash
root@php83:/www# composer install
3.5 快捷操作
-
把 .bash_aliases.example 的内容拷贝到
~/.bash_aliases或~/.bashrc -
修改
~/.bash_aliases的变量DPE_COMPOSE和DPE_SOURCE# docker-php-env docker-compose.yml 绝对路径 DPE_COMPOSE=/home/suyar/repo/docker-php-env/docker-compose.yml # docker-php-env 挂载的 DIR_SOURCE 绝对路径 DPE_SOURCE=/home/suyar/repo ... -
开始使用快捷命令
# 进入宿主机 docker-php-env 目录 $ todpe # 进入宿主机 DIR_SOURCE 目录 $ tosource # 进入 php83 容器，自动识别挂载目录中的相对路径 $ tophp # 进入 php83 容器，自动识别挂载目录中的相对路径 $ tophp83 # 进入 php82 容器，自动识别挂载目录中的相对路径 $ tophp82 # 进入 php81 容器，自动识别挂载目录中的相对路径 $ tophp81 # 进入 php80 容器，自动识别挂载目录中的相对路径 $ tophp80 # 进入 php74 容器，自动识别挂载目录中的相对路径 $ tophp74 # 进入 php73 容器，自动识别挂载目录中的相对路径 $ tophp73 # 进入 nginx 容器，自动识别挂载目录中的相对路径 $ tonginx # 进入 mysql8 容器 $ tomysql # 进入 mysql8 容器 $ tomysql8 # 进入 mysql5 容器 $ tomysql5 # 在宿主机执行 php 命令，自动识别挂载目录中的相对路径 $ php $ php83 $ php82 $ php81 $ php80 $ php74 $ php73 # 在宿主机执行 composer 命令，自动识别挂载目录中的相对路径 $ composer $ composer83 $ composer82 $ composer81 $ composer80 $ composer74 $ composer73关于
自动识别挂载目录中的相对路径的效果如下：① 假设我的
.env配置如下：... # 挂载到容器的目录 DIR_SOURCE=/home/repo ...② 假设我的
~/.bash_aliases变量配置如下：# docker-php-env 挂载的 DIR_SOURCE 绝对路径 DPE_SOURCE=/home/repo③ 假设我宿主机中，当前目录为
/home/repo/laravel那么我在宿主机执行
tophp命令后：$ tophp root@php83:/www/laravel#可以看到，这时候默认进入到
laravel目录。如果我在宿主机执行命令：
$ php artisan list那么实际上，会在容器中的
/www/laravel去执行php artisan list命令。
4 常见问题
4.1 如何在其他容器中请求 nginx 配置的域名
在 docker-compose.yml 文件中，修改 nginx 服务的 aliases 配置，把 nginx 相关的域名配置成别名：
nginx:
image: nginx:${NGINX_VERSION}
environment:
TZ: ${TZ}
volumes:
- ${DIR_SERVICES}/nginx/nginx.conf:/etc/nginx/nginx.conf
- ${DIR_SERVICES}/nginx/conf.d:/etc/nginx/conf.d
- ${DIR_SERVICES}/nginx/ssl:/etc/nginx/ssl
- ${DIR_LOGS}/nginx:/var/log/nginx
- ${DIR_SOURCE}:/www
working_dir: /www
ports:
- "${NGINX_HTTP_HOST_PORT}:80"
- "${NGINX_HTTPS_HOST_PORT}:443"
networks:
default:
aliases:
- example.laravel.me
- test.biz.me
restart: unless-stopped
logging:
driver: "json-file"
options:
max-size: "10m"
max-file: "1"
4.2 在 PHP 容器中使用 cron 定时任务
这里以 php83 容器举例：
- 在
DIR_SOURCE所在的目录或项目中，增加一个文件，例如创建www/laravel/schedule文件，并把定时任务写在里面：
* * * * * cd /www/laravel && php artisan schedule:run >> /dev/null 2>&1
- 进入 PHP 容器，添加定时任务：
# sudo docker compose exec php83 bash
# crontab /www/laravel/schedule
4.3 在 PHP 容器中使用 supervisor
这里以 php83 容器举例：
- 修改
services/php/83/supervisor.conf的内容 - 重启
php83容器
4.4 清空服务数据
在某些情况下，你可能需要清空各种生成的数据，重新初始化开发环境，
该操作是风险操作，会清空所有持久化数据！！！
# sudo docker-compose down
# sudo ./dpe.sh clean
# sudo ./dpe.sh init
License
MIT