dnmp

DNMP（Docker + Nginx/Openresty + MySQL5,8 + PHP5,7,8 + Redis + ElasticSearch + MongoDB + RabbitMQ）是一個全功能的LNMP一鍵安裝程序，支援Arm CPU 。

有部分海外工作機會推薦，有興趣的朋友可以看看。

項目地址

• GitHub 位址
• Gitee 地址

QQ交流群

• 1群： 572041090 （已滿）
• 2群： 300723526 （已滿）
• 3群： 878913761 （已滿）
• 4群： 850756381 （有位）

DNMP專案特點

1. 100%開源
2. 100%遵循Docker標準
3. 支援多版本PHP共存，可任意切換（PHP5.4、PHP5.6、PHP7.1、PHP7.2、PHP7.3、PHP7.4、PHP8.0)
4. 支援綁定任意多個域名
5. 支援HTTPS和HTTP/2
6. PHP原始碼、MySQL資料、設定檔、日誌檔都可在Host直接修改檢視
7. 內建完整PHP擴充安裝指令
8. 預設支援pdo_mysql 、 mysqli 、 mbstring 、 gd 、 curl 、 opcache等常用熱門擴展，根據環境靈活配置
9. 可一鍵選配常用服務：
   • 多PHP版本：PHP5.4、PHP5.6、PHP7.0-7.4、PHP8.0
   • Web服務：Nginx、Openresty
   • 資料庫：MySQL5、MySQL8、Redis、memcached、MongoDB、ElasticSearch
   • 訊息佇列：RabbitMQ
   • 輔助工具：Kibana、Logstash、phpMyAdmin、phpRedisAdmin、AdminMongo
10. 實際項目中應用，確保100%可用
11. 所有映像源自於Docker官方倉庫，安全可靠
12. 一次配置， Windows、Linux、MacOs皆可使用
13. 支援快速安裝擴充功能命令install-php-extensions apcu
14. 支援安裝certbot取得免費https用的SSL證書

目錄

• 1.目錄結構
• 2.快速使用
• 3.PHP和擴展
  • 3.1 切換Nginx使用的PHP版本
  • 3.2 安裝PHP擴展
  • 3.3 快速安裝php擴展
  • 3.4 Host中使用php命令列（php-cli）
  • 3.5 使用composer
• 4.管理命令
  • 4.1 伺服器啟動與建置命令
  • 4.2 新增快捷指令
• 5.使用Log
  • 5.1 Nginx日誌
  • 5.2 PHP-FPM日誌
  • 5.3 MySQL日誌
• 6.資料庫管理
  • 6.1 phpMyAdmin
  • 6.2 phpRedisAdmin
• 7.在正式環境中安全使用
• 8.常見問題
  • 8.1 如何在PHP程式碼中使用curl？
  • 8.2 Docker使用cron定時任務
  • 8.3 Docker容器時間
  • 8.4 如何連接MySQL和Redis伺服器

1.目錄結構

 /
├── data                        数据库数据目录
│   ├── esdata                  ElasticSearch 数据目录
│   ├── mongo                   MongoDB 数据目录
│   ├── mysql                   MySQL8 数据目录
│   └── mysql5                  MySQL5 数据目录
├── services                    服务构建文件和配置文件目录
│   ├── elasticsearch           ElasticSearch 配置文件目录
│   ├── mysql                   MySQL8 配置文件目录
│   ├── mysql5                  MySQL5 配置文件目录
│   ├── nginx                   Nginx 配置文件目录
│   ├── php                     PHP5.6 - PHP7.4 配置目录
│   ├── php54                   PHP5.4 配置目录
│   └── redis                   Redis 配置目录
├── logs                        日志目录
├── docker-compose.sample.yml   Docker 服务配置示例文件
├── env.smaple                  环境配置示例文件
└── www                         PHP 代码目录

2.快速使用

1. 本地安裝

 - `git`
- `Docker`(系统需为Linux，Windows 10 Build 15063+，或MacOS 10.12+，且必须要`64`位）
- `docker-compose 1.7.0+`

2. clone項目：

 ```
$ git clone https://github.com/yeszao/dnmp.git
```

3. 如果主機是Linux系統，且目前用戶不是root用戶，還需將目前用戶加入docker用戶群組：

 ```
$ sudo gpasswd -a ${USER} docker
```

4. 拷貝並命名設定檔（Windows系統請用copy指令），啟動：

 ```
$ cd dnmp                                           # 进入项目目录
$ cp env.sample .env                                # 复制环境变量文件。note:安装php扩展请查看文档中的3.2小节
$ cp docker-compose.sample.yml docker-compose.yml   # 复制 docker-compose 配置文件。默认启动3个服务：
                                                    # Nginx、PHP7和MySQL8。要开启更多其他服务，如Redis、
                                                    # PHP5.6、PHP5.4、MongoDB，ElasticSearch等，请删
                                                    # 除服务块前的注释
$ docker-compose up                                 # 启动
```

5. 在瀏覽器中造訪： http://localhost或https://localhost (自簽名HTTPS示範)就能看到效果，PHP程式碼在檔案./www/localhost/index.php 。

3.PHP和擴展

3.1 切換Nginx使用的PHP版本

首先，需要啟動其他版本的PHP，例如PHP5.4，那就先在docker-compose.yml檔案中刪除PHP5.4前面的註釋，再啟動PHP5.4容器。

PHP5.4啟動後，開啟Nginx 配置，修改fastcgi_pass的主機位址，由php改為php54 ，如下：

    fastcgi_pass   php:9000;

為：

    fastcgi_pass   php54:9000;

其中php和php54是docker-compose.yml檔案中伺服器的名稱。

最後，重啟Nginx生效。

$ docker exec -it nginx nginx -s reload

這裡兩個nginx ，第一個是容器名，第二個是容器中的nginx程式。

3.2 安裝PHP擴展

PHP的許多功能都是透過擴展實現，而安裝擴展是一個略費時間的過程， 所以，除PHP內置擴展外，在env.sample文件中我們僅默認安裝少量擴展， 如果要安裝更多擴展，請開啟你的.env檔修改如下的PHP配置， 增加需要的PHP擴充：

PHP_EXTENSIONS=pdo_mysql,opcache,redis       # PHP 要安装的扩展列表，英文逗号隔开
PHP54_EXTENSIONS=opcache,redis                 # PHP 5.4要安装的扩展列表，英文逗号隔开

然後重新build PHP鏡像。

docker-compose build php

可用的擴充功能請看同檔案的env.sample註解區塊說明。

3.3 快速安裝php擴展

1.進入容器:

docker exec -it php /bin/sh

install-php-extensions apcu 

2.支援快速安裝擴充功能列表

Supported PHP extensions

Extension	PHP 8.4	PHP 8.3	PHP 8.2	PHP 8.1	PHP 8.0	PHP 7.4	PHP 7.3	PHP 7.2	PHP 7.1	PHP 7.0	PHP 5.6	PHP 5.5
amqp
apcu
apcu_bc
ast
bcmath
bitset
blackfire
bz2
calendar
cassandra*
cmark
csv
dba
ddtrace*
decimal
ds
ecma_intl*
enchant
ev
event
excimer
exif
ffi
ftp
gd
gearman
geoip
geos*
geospatial
gettext
gmagick
gmp
gnupg
grpc
http
igbinary
imagick
imap
inotify
interbase
intl
ion
ioncube_loader
jsmin
json_post
jsonpath
ldap
luasandbox
lz4*
lzf
mailparse
maxminddb
mcrypt
memcache
memcached
memprof*
mongo
mongodb
mosquitto
msgpack
mssql
mysql
mysqli
newrelic
oauth
oci8
odbc
opcache
opencensus
openswoole
opentelemetry
parallel*
parle*
pcntl
pcov
pdo_dblib
pdo_firebird
pdo_mysql
pdo_oci
pdo_odbc
pdo_pgsql
pdo_sqlsrv
pgsql
phalcon
php_trie
phpy*
pkcs11
pq
propro
protobuf
pspell
psr
pthreads*
raphf
rdkafka
recode
redis
relay
saxon*
seasclick
seaslog
shmop
simdjson*
smbclient
snappy
snmp
snuffleupagus
soap
sockets
sodium*
solr
sourceguardian
spx
sqlsrv*
ssh2
stomp
swoole
sybase_ct
sync
sysvmsg
sysvsem
sysvshm
tensor
tideways
tidy
timezonedb
uopz
uploadprogress
uuid
uv
vips*
vld
wddx
wikidiff2*
xdebug
xdiff
xhprof
xlswriter
xmldiff
xmlrpc
xpass*
xsl
yac
yaml
yar
zephir_parser
zip
zmq
zookeeper
zstd

Number of supported extensions: 150

此擴充功能來自https://github.com/mlocati/docker-php-extension-installer 參考範例文件

3.4 Host中使用php命令列（php-cli）

1. 參考bash.alias.sample範例文件，將對應php cli 函數拷貝到主機的~/.bashrc檔案。
2. 讓文件起效：

    source ~ /.bashrc

3. 然後就可以在主機中執行php指令了：

    ~ php -v
   PHP 7.2.13 (cli) (built: Dec 21 2018 02:22:47) ( NTS )
   Copyright (c) 1997-2018 The PHP Group
   Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
       with Zend OPcache v7.2.13, Copyright (c) 1999-2018, by Zend Technologies
       with Xdebug v2.6.1, Copyright (c) 2002-2018, by Derick Rethans

3.5 使用composer

方法1：主機中使用composer指令

1. 確定composer快取的路徑。例如，我的dnmp下載在~/dnmp目錄，那composer的快取路徑就是~/dnmp/data/composer 。
2. 參考bash.alias.sample範例文件，將對應php composer 函數拷貝到主機的~/.bashrc檔案。

   這裡要注意的是，範例檔案中的~/dnmp/data/composer目錄需是第一步驟確定的目錄。

3. 讓文件起效：

    source ~ /.bashrc

4. 在主機的任何目錄下就能用composer了：

    cd ~ /dnmp/www/
   composer create-project yeszao/fastphp project --no-dev

5. （可選）第一次使用composer 會在~/dnmp/data/composer目錄下產生一個config.json文件，可以在這個文件中指定國內倉庫，例如：

   {
       "config" : {},
       "repositories" : {
           "packagist" : {
               "type" : " composer " ,
               "url" : " https://mirrors.aliyun.com/composer/ "
           }
       }
   }
   

方法二：容器內使用composer指令

還有另外一種方式，就是進入容器，再執行composer指令，以PHP7容器為例：

docker exec -it php /bin/sh
cd /www/localhost
composer update

4.管理命令

4.1 伺服器啟動與建置命令

如需管理服務，請在指令後面加上伺服器名稱，例如：

$ docker-compose up                         # 创建并且启动所有容器
$ docker-compose up -d                      # 创建并且后台运行方式启动所有容器
$ docker-compose up nginx php mysql         # 创建并且启动nginx、php、mysql的多个容器
$ docker-compose up -d nginx php  mysql     # 创建并且已后台运行的方式启动nginx、php、mysql容器


$ docker-compose start php                  # 启动服务
$ docker-compose stop php                   # 停止服务
$ docker-compose restart php                # 重启服务
$ docker-compose build php                  # 构建或者重新构建服务

$ docker-compose rm php                     # 删除并且停止php容器
$ docker-compose down                       # 停止并删除容器，网络，图像和挂载卷

4.2 新增快捷指令

在開發的時候，我們可能常常使用docker exec -it進入到容器中，把常用的做成指令別名是個省事的方法。

首先，在主機中查看可用的容器：

$ docker ps           # 查看所有运行中的容器
$ docker ps -a        # 所有容器

輸出的NAMES那一列就是容器的名稱，如果使用預設配置，那麼名稱就是nginx 、 php 、 php56 、 mysql等。

然後，開啟~/.bashrc或~/.zshrc文件，加上：

 alias dnginx= ' docker exec -it nginx /bin/sh '
alias dphp= ' docker exec -it php /bin/sh '
alias dphp56= ' docker exec -it php56 /bin/sh '
alias dphp54= ' docker exec -it php54 /bin/sh '
alias dmysql= ' docker exec -it mysql /bin/bash '
alias dredis= ' docker exec -it redis /bin/sh '

下次進入容器就非常快速了，如進入php容器：

$ dphp

4.3 查看docker網絡

ifconfig docker0

用於填寫extra_hosts容器存取宿主機的hosts位址

5.使用Log

Log檔案產生的位置依賴conf下各log配置的值。

5.1 Nginx日誌

Nginx日誌是我們用得最多的日誌，所以我們單獨放在根目錄log下。

log會目錄映射Nginx容器的/var/log/nginx目錄，所以在Nginx設定檔中，需要輸出log的位置，我們需要設定到/var/log/nginx目錄，如：

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

5.2 PHP-FPM日誌

大部分情況下，PHP-FPM的日誌都會輸出到Nginx的日誌中，所以不需要額外設定。

另外，建議直接在PHP中開啟錯誤日誌：

 error_reporting ( E_ALL );
ini_set ( ' error_reporting ' , ' on ' );
ini_set ( ' display_errors ' , ' on ' );

如果確實需要，可按一下步驟開啟（在容器中）。

1. 進入容器，建立日誌檔案並修改權限：

   $ docker exec -it php /bin/sh
   $ mkdir /var/log/php
   $ cd /var/log/php
   $ touch php-fpm.error.log
   $ chmod a+w php-fpm.error.log

2. 主機上開啟並修改PHP-FPM的設定檔conf/php-fpm.conf ，找到如下一行，刪除註釋，並改值為：

    php_admin_value[error_log] = /var/log/php/php-fpm.error.log
   

3. 重啟PHP-FPM容器。

5.3 MySQL日誌

因為MySQL容器中的MySQL使用的是mysql用戶啟動，它無法自行在/var/log下的增加日誌檔。所以，我們把MySQL的日誌放在與data一樣的目錄，也就是專案的mysql目錄下，對應容器中的/var/log/mysql/目錄。

slow-query-log-file     = /var/log/mysql/mysql.slow.log
log-error               = /var/log/mysql/mysql.error.log

以上是mysql.conf中的日誌檔案的配置。

6.資料庫管理

本專案預設在docker-compose.yml中不開啟了用於MySQL線上管理的phpMyAdmin ，以及用於redis線上管理的phpRedisAdmin ，可以根據需要修改或刪除。

6.1 phpMyAdmin

phpMyAdmin容器對應到主機的連接埠位址是： 8080 ，所以在主機上存取phpMyAdmin的位址是：

 http://localhost:8080

MySQL連線資訊：

• host：(本專案的MySQL容器網路)
• port： 3306
• username：（手動在phpmyadmin介面輸入）
• password：（手動在phpmyadmin介面輸入）

6.2 phpRedisAdmin

phpRedisAdmin容器對應到主機的連接埠位址是： 8081 ，所以在主機上存取phpMyAdmin的位址是：

 http://localhost:8081

Redis連接資訊如下：

• host: (本專案的Redis容器網路)
• port: 6379

7.在正式環境中安全使用

要在正式環境中使用，請：

1. 在php.ini中關閉XDebug調試
2. 增強MySQL資料庫存取的安全性策略
3. 增強redis存取的安全策略

8 常見問題

8.1 如何在PHP程式碼中使用curl？

參考這個issue：#91

8.2 Docker使用cron定時任務

Docker使用cron定時任務

8.3 Docker容器時間

容器時間在.env檔中配置TZ變量，所有支援的時區請看時區列表·維基百科或PHP所支援的時區列表·PHP官網。

8.4 如何連接MySQL和Redis伺服器

這要分兩種情況，

第一種情況，在PHP程式碼中。

 // 连接MySQL
$ dbh = new PDO ( ' mysql:host=mysql;dbname=mysql ' , ' root ' , ' 123456 ' );

// 连接Redis
$ redis = new Redis ();
$ redis -> connect ( ' redis ' , 6379 );

因為容器與容器是expose連接埠聯通的，而且在同一個networks下，所以連接的host參數直接用容器名稱， port參數就是容器內部的連接埠。更多請參考《docker-compose ports和expose的差別》。

第二種情況，在主機中透過命令列或Navicat等工具連接。主機要連接mysql和redis的話，要求容器必須經過ports把連接埠對應到主機了。以mysql 為例， docker-compose.yml檔案中有這樣的ports配置： 3306:3306 ，就是主機的3306和容器的3306埠形成了映射，所以我們可以這樣連接：

$ mysql -h127.0.0.1 -uroot -p123456 -P3306
$ redis-cli -h127.0.0.1

這裡host參數不能用localhost是因為它預設是透過sock檔案與mysql通信，而容器與主機檔案系統已經隔離，所以需要透過TCP方式連接，所以需要指定IP。

8.5 容器內的php如何連接宿主機MySQL

1.宿主機執行ifconfig docker0得到inet就是要連接的ip位址

$ ifconfig docker0
docker0: flags= 4099< UP,BROADCAST,MULTICAST >  mtu 1500
        inet 172.17.0.1  netmask 255.255.0.0  broadcast 172.17.255.255
        ...

2.運行宿主機Mysql命令列

 mysql > GRANT ALL PRIVILEGES ON * . * TO ' root ' @ ' % ' IDENTIFIED BY ' 123456 ' WITH GRANT OPTION;
 mysql > flush privileges;
// 其中各字符的含义：
// * . * 对任意数据库任意表有效
// " root " " 123456 " 是数据库用户名和密码
// ' % ' 允许访问数据库的IP地址，%意思是任意IP，也可以指定IP
// flush privileges 刷新权限信息

3.接著直接php容器使用172.0.17.1:3306連接即可

8.6 SQLSTATE[HY000] [1130] Host '172.19.0.2' is not allowed to connect to this MySQL server

1. 目前使用mysql-server 8.0.28以上的版本,php版本需要7.4.7以上才能連接

8.7 Docker是如何產生容器名

在不指定容器名稱時,是如何產生容器名

感謝Navicat 對開源專案的贊助

License

MIT