KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #codex #claude-code #mcp #rust #deepseek-harness #typescript #ai-agent #cli

dnmp-plus

★ 298 Open GitHub ↗

🐳 Docker 的 LNMP 一键安装开发环境 + PHP 非侵入式监控平台 xhgui。

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# DNMP PLUS

**dnmp** = `Docker` + `Nginx` + `MySQL` + `PHP` + `Redis` + `MongDB`

**plus** = `xhgui` + `xhprof` + `tideways`

**dnmp-plus** = `PHPer 的一键安装开发环境` + `PHP 非侵入式监控平台（优化系统性能、定位 Bug 的神器）`

---

[![Build Status](https://app.travis-ci.com/guanguans/dnmp-plus.svg?branch=master)](https://app.travis-ci.com/guanguans/dnmp-plus)

简体中文 | [English](README-EN.md)

**[dnmp-plus](https://github.com/guanguans/dnmp-plus)** 在 [yeszao](https://github.com/yeszao) 的 [DNMP](https://github.com/yeszao/dnmp) 基础上新增：

* [PHP xhprof 扩展](https://github.com/phacility/xhprof) - Facebook 开发的 PHP 性能追踪及分析工具
* [PHP tideways 扩展](https://github.com/tideways/php-xhprof-extension) - xhprof 的分支，支持 PHP7
* PHP mongodb 扩展
* MongoDB 服务
* Mongo Express - MongoDB 服务管理系统
* [xhgui](https://github.com/laynefyc/xhgui-branch) - xhprof 分析数据数据的 GUI 系统

![](https://raw.githubusercontent.com/guanguans/dnmp-plus/master/docs/dnmp-plus.png)

---

## 目录结构

``` bash
├── .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

## 快速使用

``` bash
$ 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](http://localhost)

![](https://raw.githubusercontent.com/guanguans/dnmp-plus/master/docs/localhost.png)

## 基本使用

``` bash
# 服务选项：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 ...
```

## xhgui 使用，可以参考  https://github.com/guanguans/guanguans.github.io/issues/9

### 安装

``` bash
$ cd www/xhgui-branch
# 注意如果宿主机 php 没有安 mogodb 扩展会报错
$ composer install
```

### 修改 xhgui-branch 配置文件 `www/xhgui-branch/config/config.default.php`

``` php
<?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 文件中增加

``` bash
127.0.0.1             xhgui.test
```

### 浏览器访问 http://xhgui.test

![](https://raw.githubusercontent.com/guanguans/dnmp-plus/master/docs/xhgui1.png)

### 在要分析项目 nginx 配置文件中修改，以默认的 localhost 配置 `conf/conf.d/localhost.conf` 为例

``` conf
...
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

``` bash
$ docker-compose restart nginx
```

### 浏览器访问 [http://localhost](http://localhost)，再访问 [http://xhgui.test](http://xhgui.test)，此时已经有了内容，愉快的查看项目的性能追踪及分析吧

![](https://raw.githubusercontent.com/guanguans/dnmp-plus/master/docs/xhgui2.png)

![](https://raw.githubusercontent.com/guanguans/dnmp-plus/master/docs/xhgui3.png)

## PHP 和扩展

### 切换 Nginx 使用的 PHP 版本

默认同时创建 `PHP5.6` 和 `PHP7.2` 2 个 PHP 版本的容器，切换 PHP 仅需修改相应站点 Nginx 配置的 `fastcgi_pass` 选项，例如，示例的 [http://localhost](http://localhost) 用的是 PHP7.2，Nginx 配置：

``` conf
fastcgi_pass   php72:9000;
```

要改用 PHP5.6，修改为：

``` conf
fastcgi_pass   php56:9000;
```

重启 Nginx 生效

``` bash
$ docker-compose restart nginx
```

### 安装 PHP 扩展

PHP 的很多功能都是通过扩展实现，而安装扩展是一个略费时间的过程，
所以，除 PHP 内置扩展外，在 `env.sample` 文件中我们仅默认安装少量扩展，
如果要安装更多扩展，请打开你的 `.env` 文件修改如下的 PHP 配置，
增加需要的 PHP 扩展：

``` bash
PHP72_EXTENSIONS=pdo_mysql,opcache,redis,xdebug,mongodb,tideways
PHP56_EXTENSIONS=opcache,redis,xdebug,mongodb,xhprof
```

然后重新构建 PHP 镜像

``` bash
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` 目录，如：

``` conf
error_log  /var/log/nginx/nginx.localhost.error.log  warn;
```

### MySQL 日志

因为 MySQL 容器中的 MySQL 使用的是 `mysql` 用户启动，它无法自行在 `/var/log` 下的增加日志文件。所以，我们把 MySQL 的日志放在与 data 一样的目录，即项目的`mysql`目录下，对应容器中的 `/var/lib/mysql/` 目录。

mysql.conf 中的日志文件的配置：

``` 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

## 参考链接

* [https://github.com/yeszao/dnmp](https://github.com/yeszao/dnmp)，yeszao

## License

[MIT](LICENSE)

dnmp-plus

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README