PhpStorm連線Docker容器配置xdebug斷點除錯

阿新 • • 發佈：2019-01-13

本教程主要演示xdebug在PhpStorm中配置方法。

一、環境說明

1.Mac筆記本（本教程演示過程使用的是Mac OS作業系統，和windows環境是有區別的，這一點需要特別注意）；

2.在Mac筆記本上安裝Docker，筆者安裝的Docker版本資訊如下：

B000000075547S:Downloads v_shiyanjun$ docker version
Client:
 Version:           18.06.1-ce
 API version:       1.38
 Go version:        go1.10.3
 Git commit:        e68fc7a
 Built:             Tue Aug  
21 17:21:31 2018
 OS/Arch:           darwin/amd64
 Experimental:      false

Server:
 Engine:
  Version:          18.06.1-ce
  API version:      1.38 (minimum version 1.12)
  Go version:       go1.10.3
  Git commit:       e68fc7a
  Built:            Tue Aug 21 17:29:02 2018
  OS/Arch:          linux/amd64
  Experimental:      
true

3.Docker容器安裝Centos，版本資訊：

[[email protected] /]# uname -a
Linux 37815a453e3e 4.9.93-linuxkit-aufs #1 SMP Wed Jun 6 16:55:56 UTC 2018 x86_64 x86_64 x86_64 GNU/Linux
[[email protected] /]# cat /etc/redhat-release
CentOS Linux release 7.5.1804 (Core)

4.安裝lnmp環境(nmp1.5.tar.gz)，lnmp一鍵安裝包下載地址:

https:// 
lnmp.org/install.html

5.安裝xdebug(xdebug-2.6.1.tgz)，下載連結：

https://xdebug.org/files/xdebug-2.6.1.tgz

6.PhpStorm開發軟體(PhpStorm 2018.2.3)，下載連結：

https://download.jetbrains.com/webide/PhpStorm-2018.2.4.dmg

7.準備一個php專案，並匯入到PhpStorm開發工具中，使用者debug程式碼除錯演示；

二、nginx的配置

[[email protected] vhost]# pwd
/usr/local/nginx/conf/vhost
[[email protected] vhost]# ls
xbs.com.conf
[[email protected] vhost]# cat xbs.com.conf 
server
    {
        listen 8888;
        server_name xbs.com n;
        index index.php;
        root  /home/work/xbs;

        include rewrite/none.conf;
        #error_page   404   /404.html;

        # Deny access to PHP files in specific directory
        #location ~ /(wp-content|uploads|wp-includes|images)/.*\.php$ { deny all; }

        include enable-php.conf;

        location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$
        {
            expires      30d;
        }

        location ~ .*\.(js|css)?$
        {
            expires      12h;
        }

        location ~ /.well-known {
            allow all;
        }

        location ~ /\.
        {
            deny all;
        }

        access_log  /home/work/logs/xbs.com.log;
    }
[[email protected] vhost]#

三、xdebug在PhpStorm中的配置

1.安裝好xdebug之後，在php.ini檔案尾部新增如下內容，注意：xdebug.remote_host配置的是mac筆記本的IP地址，xdebug.idekey要和PhpStorm中配置的一致：

[xdebug]
zend_extension=xdebug.so
xdebug.profiler_enable=on
xdebug.trace_output_dir="/usr/local/php/xdebug_trace"
xdebug.profiler_output_dir="/usr/local/php/xdebug_profiler"
xdebug.default_enable=0
xdebug.remote_enable=1
xdebug.remote_handler=dbgp
xdebug.remote_host=192.168.0.104
xdebug.remote_port=9000
xdebug.remote_connect_back=0
xdebug.remote_autostart=1
xdebug.idekey=PHPSTORM
xdebug.remote_log=/usr/local/php/xdebug/remote.log

2.在PhpStorm中配置php debug，注意埠為9000，要和上面php.ini檔案中的xdebug.remote_port一致：

3.在PhpStorm中配置php server，注意host和埠要和lnmp中配置的一致，Debugger下拉框選擇Xdebug，下面的File/Directory配置的是Mac筆記本磁碟上的php專案所在目錄，而absolute path on the server配置的是Docker容器中的lnmp伺服器上的php專案目錄，這兩個目錄是可以在啟動Docker容器的時候通過-v引數進行指定的。