配置和使用 Xdebug (Laravel + Homestead + Xdebug)

Xdebug deepens debugging PHP apps and websites to a level you can’t receive from the manual process of using code level var_dump().

Setup

To install Xdebug for PHP7 on Ubuntu you will need to do so manually. Ubuntu 15 and lower will not come with a package for PHP7 or its xDebug counterpart.

First, be sure you are using PHP 7 already by checking your version.

vagrant@homestead:~/www/caijing/cms_caijing$ php -v
Should give you something like:

PHP 7.0.1-1+deb.sury.org~trusty+2 (cli) ( NTS )
Copyright (c) 1997-2015 The PHP Group
Zend Engine v3.0.0, Copyright (c) 1998-2015 Zend Technologies
    with Xdebug v2.5.0, Copyright (c) 2002-2016, by Derick Rethans
    with Zend OPcache v7.0.6-dev, Copyright (c) 1999-2015, by Zend Technologies

In my case I’m using the Larval Homestead PHP 7 branch with Vagrant and the VirtualBox provider. So, I have PHP 7 already installed and working with Nginx.

Get your php.ini

Next output your php.ini information into a file or place you can get to the information from. I like to save mine to a file called php-info.txt.

vagrant@homestead:~/www/caijing/cms_caijing$ sudo php -i > ~/php-info.txt(一個(gè)你可以打開該文件的地方即可)

Use the Xdebug Wizard

打開 php-info 文件,全選,復(fù)制,粘貼到 https://xdebug.org/wizard.php,然后點(diǎn)擊 analyse,等待結(jié)果。

按照結(jié)果提示一步步來即可。

Send the text file information into the wizard at Xdebug Wizard. Then follow the instructions the wizard supplies.

Also, if you are using OSX you may need to run brew install autoconf.

下面是我本機(jī)(zzp)的 Instructions:

  1. Download xdebug-2.5.0.tgz (到想要保存的目錄中執(zhí)行,或者使用絕對(duì)路徑 sudo wget -O ~/downloads/xdebug-2.5.0.tgz https://xdebug.org/files/xdebug-2.5.0.tgz)
  2. Unpack the downloaded file with tar -xvzf xdebug-2.5.0.tgz
  3. Run: cd xdebug-2.5.0
  4. Run: phpize (See the FAQ if you don't have phpize.)
    As part of its output it should show:
    Configuring for:
Zend Module Api No:      20151012
Zend Extension Api No:   320151012

If it does not, you are using the wrong phpize. Please follow this FAQ entry and skip the next step.

  1. Run: ./configure
  2. Run: make
  3. Run: cp modules/xdebug.so /usr/lib/php/20151012
  4. Edit /etc/php/7.0/cli/php.ini and add the line
    zend_extension = /usr/lib/php/20151012/xdebug.so
    這里,最好不要改動(dòng) php 的主配置文件,在 phpinfo() 輸出內(nèi)容中找到 Additional .ini files parsed,這里是輔助配置文件。本機(jī)為: /etc/php/7.0/fpm/conf.d,軟鏈自:/etc/php/mods-available/
    在目錄下新建一個(gè)文件 xdebug.ini, 添加需要的這行代碼。然后還需要在/etc/php/7.0/fpm/conf.d下創(chuàng)建軟鏈。
  5. 重啟服務(wù)
sudo service php7.0-fpm restart
sudo service nginx restart

在項(xiàng)目的任何地方設(shè)置輸出 phpinfo(), 在網(wǎng)頁上能搜索到 xdebug 的內(nèi)容,表示配置成功。

Snip20161212_10.png

Enable Remote Xdebug

To use Xdebug remote debugging on a host computer you need to enable remote debugging on the guest server. In my case the guest is the Vagrant Homestead VM.

In the guest php.ini file add: (這些直接復(fù)制即可,不用改,同樣添加至 xdebug.ini 即可)

xdebug.remote_enable = 1
xdebug.remote_connect_back=1
xdebug.remote_port = 9000
xdebug.scream=0
xdebug.show_local_vars=1
xdebug.idekey=PHPSTORM

Since I use PhpStorm for Debugging I set my Xdebug key to PHPSTORM.
In the browser, the Xdebug and PhpStorm will look for a cookie called XDEBUG_SESSION with the value PHPSTORM. To set this cookie I use the Chrome Browser extension Xdebug helper. (這里暫時(shí)沒有用到)

Reboot Services

To load the new configurations reload your PHP and HTTP server services. In my case that is nginx and php7.0-fpm.

sudo service php7.0-fpm restart
sudo service nginx restart

Configure PHP Storm

Now that Xdebug is install we are ready to configure a “PHP Remote Debug” for PhpStorm.

  1. Under PhpStorm -> Preferences -> Languages&Frameworks -> PHP -> Debug be sure Xdebug is set to port 9000

  2. Under PhpStorm -> Preferences -> Languages&Frameworks -> PHP -> Servers, add a server using port 80 and set the Absolute path on the server.
    其中,因?yàn)槭翘摂M機(jī)遠(yuǎn)程服務(wù)器的原因,勾選了使用 path mappings,將本地的項(xiàng)目目錄 /Users/ZouZhipeng/www/caijing/cms_caijing 和服務(wù)器上的絕對(duì)路徑 /home/vagrant/www/caijing/cms_caijing 進(jìn)行關(guān)聯(lián)。

    Snip20161212_1.png

  3. 屏幕上方的菜單欄:Under Run -> Edit Configurations 添加一個(gè) PHP Remote Debug, 選擇 Servers 后點(diǎn)擊省略號(hào),即跳轉(zhuǎn)到 Server 配置頁面,即上面第二步操作的。

    Snip20161212_5.png

  4. Set the server and the Ide key(session id) to PHPSTORM

  5. 還是剛才的頁面,左側(cè)?,添加一個(gè) PHP Web Application,我的配置如下
    start URL 為項(xiàng)目開始的地址,即下方藍(lán)色 url,點(diǎn)擊臭蟲會(huì)直接跳轉(zhuǎn)到這里。


    Snip20161212_3.png

Using PhpStorm with Xdebug on a Remote Server (這部分沒用到)

To start receiving requests from the remote server enable “Debug” with Xdebug helper in Google Chrome on the page you want to debug. Then, unlike local testing that uses “Start Listening for PHP Debug Connections” use Run > Debug instead.

Using the “Debug” command will open up the signal manually and open the direct connection to the remote server.

Set breakpoints and you are off.

Out of Network Servers (troubleshooting,暫未用到)

If you are trying to remote debug a website with Xdebug from outside your local network be sure the 9000 port is not blocked on your network. This is typically done at the router level.

As always consult the Xdebug remote documentation.

Next, ask Google “what is my public ip” and it will tell you.

Then be sure your remote server is not blocking your IP address.

使用方法

在需要調(diào)試的行上打上斷點(diǎn)(點(diǎn)擊一下行號(hào)后面的空白處即可,再點(diǎn)一次取消斷點(diǎn)),需要說明的是當(dāng)程序運(yùn)行到該斷點(diǎn)時(shí),程序會(huì)停留在該行,但該行本身不會(huì)執(zhí)行。自此可以查看程序運(yùn)行到此處時(shí)所包含的所有數(shù)據(jù)信息。當(dāng)然,查看信息功能相當(dāng)于使用echo,print或者var_dump。

操作流程

打斷點(diǎn)—>點(diǎn)擊臭蟲—>點(diǎn)擊瀏覽器頁面觸發(fā)斷點(diǎn)—>自動(dòng)跳轉(zhuǎn)回PhpStorm—>查看攜帶的數(shù)據(jù)(調(diào)試的目的)—>可按步執(zhí)行查找問題點(diǎn)—>點(diǎn)擊運(yùn)行(或者F5)—>瀏覽器頁面繼續(xù)執(zhí)行—>調(diào)試完成

20160719101531030.png
20160719101534475.png
20160719101537936.png

參考:

http://blog.csdn.net/knight_quan/article/details/51953269
https://xdebug.org/wizard.php
https://php-built.com/2016/01/20/installing-xdebug-for-php7/

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容