DNMP PLUS
dnmp = Docker
+ Nginx
+ MySQL
+ PHP
+ Redis
+ MongDB
plus = xhgui
+ xhprof
+ tideways
dnmp-plus = PHPer 的一键安装开发环境
+ PHP 非侵入式监控平台(优化系统性能、定位 Bug 的神器)
简体中文 | English
dnmp-plus 在 yeszao 的 DNMP 基础上新增:
- PHP xhprof 扩展 - Facebook 开发的 PHP 性能追踪及分析工具
- PHP tideways 扩展 - xhprof 的分支,支持 PHP7
- PHP mongodb 扩展
- MongoDB 服务
- Mongo Express - MongoDB 服务管理系统
- xhgui - xhprof 分析数据数据的 GUI 系统
目录结构
├── .github Github 配置目录
├── conf 配置文件目录
│ ├── conf.d Nginx 用户站点配置目录
│ ├── mysql.cnf MySQL 用户配置文件
│ ├── nginx.conf Nginx 默认配置文件
│ ├── php-fpm.conf PHP-FPM 配置文件
│ ├── php.ini PHP 配置文件
│ ├── redis.conf Redis 配置文件
├── docs 文档目录
├── extensions PHP 扩展源码包
├── log 日志目录
├── mongo MongoDB 数据目录
├── mysql MySQL 数据目录
├── www PHP 代码目录
├── Dockerfile PHP 镜像构建文件
├── docker-compose-sample.yml Docker 服务配置示例文件
├── env.smaple 环境配置示例文件
└── travis-build.sh Travis CI 构建脚本
环境要求
- Docker
- Docker-compose
- Git
快速使用
$ git clone https://github.com/guanguans/dnmp-plus.git --recursive
$ cd dnmp-plus
$ cp env.sample .env
$ cp docker-compose-sample.yml docker-compose.yml
# 服务选项:nginx、php72、php56、mysql、mongo、redis、phpmyadmin、phpredisadmin、mongo-express
$ docker-compose up -d php72 nginx mysql mongo
OK,你现在已经拥有了一个 dnmp-plus 开发环境,默认 web 根目录 www/localhost/
,浏览器访问 http://localhost
基本使用
# 服务选项:nginx、php72、php56、mysql、mongo、redis、phpmyadmin、phpredisadmin、mongo-express
# 创建并且启动容器
$ docker-compose up 服务1 服务2 ...
# 创建并且启动所有容器
$ docker-compose up
# 创建并且已后台运行的方式启动容器
$ docker-compose up -d 服务1 服务2 ...
# 启动服务
$ docker-compose start 服务1 服务2 ...
# 停止服务
$ docker-compose stop 服务1 服务2 ...
# 重启服务
$ docker-compose restart 服务1 服务2 ...
# 构建或者重新构建服务
$ docker-compose build 服务1 服务2 ...
# 进入命令行容器
$ docker-compose exec 服务 bash
# 删除并且停止容器
$ docker-compose rm 服务1 服务2 ...
# 停止并删除容器,网络,图像和挂载卷
$ docker-compose down 服务1 服务2 ...
guanguans/guanguans.github.io#9
xhgui 使用,可以参考安装
$ cd www/xhgui-branch
# 注意如果宿主机 php 没有安 mogodb 扩展会报错
$ composer install
www/xhgui-branch/config/config.default.php
修改 xhgui-branch 配置文件 <?php
return array(
...
'debug' => true, // 改为true,便于调试
'mode' => 'development',
...
'extension' => 'tideways', // 改为支持 PHP7 的 tideways
...
'save.handler' => 'mongodb',
'db.host' => 'mongodb://mongo:27017', // 127.0.0.1 改为 mongo
...
);
hosts 文件中增加
127.0.0.1 xhgui.test
http://xhgui.test
浏览器访问conf/conf.d/localhost.conf
为例
在要分析项目 nginx 配置文件中修改,以默认的 localhost 配置 ...
location ~ \.php$ {
fastcgi_pass php72:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param PATH_INFO $fastcgi_path_info;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
# 在执行主程序之前运行我们指定的PHP脚本
fastcgi_param PHP_VALUE "auto_prepend_file=/var/www/html/xhgui-branch/external/header.php";
}
...
重启 nginx
$ docker-compose restart nginx
http://localhost,再访问 http://xhgui.test,此时已经有了内容,愉快的查看项目的性能追踪及分析吧
浏览器访问PHP 和扩展
切换 Nginx 使用的 PHP 版本
默认同时创建 PHP5.6
和 PHP7.2
2 个 PHP 版本的容器,切换 PHP 仅需修改相应站点 Nginx 配置的 fastcgi_pass
选项,例如,示例的 http://localhost 用的是 PHP7.2,Nginx 配置:
fastcgi_pass php72:9000;
要改用 PHP5.6,修改为:
fastcgi_pass php56:9000;
重启 Nginx 生效
$ docker-compose restart nginx
安装 PHP 扩展
PHP 的很多功能都是通过扩展实现,而安装扩展是一个略费时间的过程,
所以,除 PHP 内置扩展外,在 env.sample
文件中我们仅默认安装少量扩展,
如果要安装更多扩展,请打开你的 .env
文件修改如下的 PHP 配置,
增加需要的 PHP 扩展:
PHP72_EXTENSIONS=pdo_mysql,opcache,redis,xdebug,mongodb,tideways
PHP56_EXTENSIONS=opcache,redis,xdebug,mongodb,xhprof
然后重新构建 PHP 镜像
docker-compose build php72
docker-compose up -d
使用 Log
Log 文件生成的位置依赖于 conf 下各 log 配置的值。
Nginx 日志
Nginx 日志是我们用得最多的日志,所以我们单独放在根目录 log
下。log
会目录映射 Nginx 容器的 /var/log/nginx
目录,所以在 Nginx 配置文件中,需要输出 log 的位置,我们需要配置到 /var/log/nginx
目录,如:
error_log /var/log/nginx/nginx.localhost.error.log warn;
MySQL 日志
因为 MySQL 容器中的 MySQL 使用的是 mysql
用户启动,它无法自行在 /var/log
下的增加日志文件。所以,我们把 MySQL 的日志放在与 data 一样的目录,即项目的mysql
目录下,对应容器中的 /var/lib/mysql/
目录。
mysql.conf 中的日志文件的配置:
slow-query-log-file = /var/lib/mysql/mysql.slow.log
log-error = /var/lib/mysql/mysql.error.log
数据库管理
- 默认 phpMyAdmin 地址:http://localhost:8080
- 默认 phpRedisAdmin 地址:http://localhost:8081
- 默认 Mongo Express 地址:http://localhost:8082