當(dāng)前位置：首頁(yè) > 编程语言 > php >内容正文

php

phpstorm 调试_PhpStorm中的多用户调试

發(fā)布時(shí)間：2023/11/29 php 46 豆豆

生活随笔收集整理的這篇文章主要介紹了 phpstorm 调试_PhpStorm中的多用户调试小編覺(jué)得挺不錯(cuò)的,現(xiàn)在分享給大家,幫大家做個(gè)參考.

phpstorm 調(diào)試

by Ray Naldo

雷·納爾多(Ray Naldo)

PhpStorm中的多用戶(hù)調(diào)試 (Multi-User Debugging in PhpStorm)

使用Xdebug和DBGp代理 (Using Xdebug and DBGp Proxy)

“Er, wait a minute… Don’t you just use xdebug.remote_connect_back which has been introduced since Xdebug 2.1?"

“嗯，請(qǐng)稍等...您不只是使用Xdebug 2.1之后引入的xdebug.remote_connect_back嗎？”

Sure if the web server is only accessible by the developers (e.g. private development server), and if it’s not running behind a NATted firewall, and if you want this guide to end here. See those IFs? Personally, I don’t like IF in programming or in life. So this guide will take the longer way which doesn’t need an IF to start (or at least fewer IFs), that is by using Xdebug’s DBGp proxy.

確保Web服務(wù)器僅可由開(kāi)發(fā)人員訪(fǎng)問(wèn)(例如，私有開(kāi)發(fā)服務(wù)器)，并且它不在NATted防火墻后面運(yùn)行，以及是否希望本指南在此處結(jié)束。看到那些IF嗎？就個(gè)人而言，我在編程或生活中都不喜歡IF。因此，本指南將采用更長(zhǎng)的方式，即不需要使用IF(或者至少需要更少的IF)來(lái)啟動(dòng)，即使用Xdebug的DBGp代理。

When a proxy is used, the PHP Xdebug extension no longer connects to PhpStorm directly, but instead connects to the DBGp proxy server. All developers in the team, in turn, then connect to that proxy. Each developer has a separate debugging session running over this proxy, which makes it possible to do multi-user debugging of the same code on the same server.

使用代理時(shí)，PHP Xdebug擴(kuò)展不再直接連接到PhpStorm，而是連接到DBGp代理服務(wù)器。然后，團(tuán)隊(duì)中的所有開(kāi)發(fā)人員都將連接到該代理。每個(gè)開(kāi)發(fā)人員都在此代理上運(yùn)行單獨(dú)的調(diào)試會(huì)話(huà)，這使得可以對(duì)同一服務(wù)器上的相同代碼進(jìn)行多用戶(hù)調(diào)試。

So, with DBGp proxy you can limit who can connect to the proxy, and you may have multiple developers debugging the same web server running behind a NATted firewall.

因此，使用DBGp代理，您可以限制誰(shuí)可以連接到代理，并且可能有多個(gè)開(kāi)發(fā)人員調(diào)試在NATted防火墻后運(yùn)行的同一Web服務(wù)器。

Running a DBGp proxy also allows you to avoid NAT issues where (as seen from PHP+Xdebug on the server) all connections seem to come from the same IP (because your internal network is NATted). In this case, you can simply run the dbgp proxy on your NAT machine, configure xdebug.remote_host setting to the IP address of your NAT machine, and configure the IDEs to connect to the proxy running at <NAT-machine>;:9001.

運(yùn)行DBGp代理還可以避免NAT問(wèn)題(如從服務(wù)器上PHP + Xdebug看到的)，所有連接似乎都來(lái)自同一IP(因?yàn)槟膬?nèi)部網(wǎng)絡(luò)已被NAT)。在這種情況下，您只需在NAT計(jì)算機(jī)上運(yùn)行dbgp代理，將xdebug.remote_host設(shè)置配置為NAT計(jì)算機(jī)的IP地址，然后將IDE配置為連接到運(yùn)行在<NAT-machine>上的代理；：9001。

— https://derickrethans.nl/debugging-with-multiple-users.html

建立 (Setup)

Mappings between the project folders and the folders on the server should be done correctly in PhpStorm first for debugging to work.

應(yīng)該首先在PhpStorm中正確完成項(xiàng)目文件夾和服務(wù)器上的文件夾之間的映射，然后才能進(jìn)行調(diào)試。

設(shè)置Web服務(wù)器 (Setup Web Server)

Although this guide assumes the web server is running on Linux, the guide could also be used on non-Linux web servers with slight modifications.

盡管本指南假定Web服務(wù)器在Linux上運(yùn)行，但該指南也可以在非Linux Web服務(wù)器上使用，并稍加修改。

1. Install Xdebug.

1.安裝Xdebug。

# PHP 7+pecl install xdebug # PHP 5.6.xpecl install xdebug-2.5.5

2. Enable Xdebug extension, then add the following Xdebug configuration to php.ini:

2.啟用Xdebug擴(kuò)展，然后將以下Xdebug配置添加到php.ini：

[xdebug]zend_extension="<full_path_to_xdebug.so>"; debugger settingsxdebug.remote_enable=1xdebug.remote_host=127.0.0.1xdebug.remote_port=9000

For this guide, DBGp proxy will run on the same machine as the web server and will use Xdebug’s default port, hence 127.0.0.1:9000.

對(duì)于本指南，DBGp代理將與Web服務(wù)器在同一臺(tái)計(jì)算機(jī)上運(yùn)行，??并將使用Xdebug的默認(rèn)端口，即127.0.0.1:9000 。

3. Download and install DBGp proxy for remote debugging from Komodo Remote Debugging Package, specifically for your web server’s operating system. This guide will be using 64-bit Linux and PHP Remote Debugging client v11.1.0. Extract the archive; for simplicity I extract all the contents to my home directory i.e. /home/ray/.

3.從Komodo Remote Debugging Package中下載并安裝DBGp代理，以進(jìn)行遠(yuǎn)程調(diào)試，特別是針對(duì)Web服務(wù)器的操作系統(tǒng)。本指南將使用64位Linux和PHP遠(yuǎn)程調(diào)試客戶(hù)端v11.1.0。提取檔案；為簡(jiǎn)單起見(jiàn)，我將所有內(nèi)容提取到我的主目錄(即/home/ray/ 。

4. Run DBGp proxy by executing pydbgpproxy file with parameters:

4.通過(guò)執(zhí)行帶有參數(shù)的pydbgpproxy文件來(lái)運(yùn)行DBGp代理：

-d <ip_address:port> to set IP address and port of the machine which will be receiving debugger connection from the web server
-d <ip_address:po rt>設(shè)置將要從Web服務(wù)器接收調(diào)試器連接的計(jì)算機(jī)的IP地址和端口
-i <ip_address:port> to set IP address and port of the machine which will be receiving debugging connection from developer computer
-i <ip_address:po rt>設(shè)置將要從開(kāi)發(fā)人員計(jì)算機(jī)接收調(diào)試連接的計(jì)算機(jī)的IP地址和端口

In this guide, web server and DBGp proxy will be run on the same machine. If the IP address is 10.211.1.32 and we want to run the proxy on port 9001 then the command will be:

在本指南中，Web服務(wù)器和DBGp代理將在同一臺(tái)計(jì)算機(jī)上運(yùn)行。如果IP地址為10.211.1.32并且我們想在端口9001上運(yùn)行代理，則命令將為：

pydbgpproxy -d 127.0.0.1:9000 -i 10.211.1.32:9001

For convenience we could use this script, saved as start-dbgp-proxy.sh.I placed it on the same directory as pydbgpproxy i.e. /home/ray/start-dbgp-proxy.sh) :

為方便起見(jiàn)，我們可以使用這個(gè)腳本，保存為start-dbgp-proxy.sh 。我把它放在同一個(gè)目錄中pydbgpproxy即/home/ray/start-dbgp-proxy.sh )：

ip=$(hostname -I | awk '{$1=$1};1')pydbgpproxy -d 127.0.0.1:9000 -i $ip:9001

5. Make sure to allow connection from localhost on port 9000, and from developer machines on port 9001.

5.確保允許從端口9000上的localhost和端口9001上的開(kāi)發(fā)人員機(jī)器進(jìn)行連接。

6. Run start-dbgp-proxy.sh. Add execute file permission if you can't run it.

6.運(yùn)行start-dbgp-proxy.sh 。添加執(zhí)行文件權(quán)限(如果無(wú)法運(yùn)行)。

start-dbgp-proxy.sh

Make sure it can be run without a problem.

確保它可以正常運(yùn)行。

INFO: dbgp.proxy: starting proxy listeners. appid: 30430INFO: dbgp.proxy: dbgp listener on 127.0.0.1:9000INFO: dbgp.proxy: IDE listener on 10.211.1.32:9001

7. (Optional) Auto-start start-dbgp-proxy.sh on each machine startup by using crontab.

7.(可選)使用crontab在每次啟動(dòng)計(jì)算機(jī)時(shí)自動(dòng)啟動(dòng)start-dbgp-proxy.sh 。

Edit crontab:

編輯crontab：

crontab -e

Add cron job to auto-start start-dbgp-proxy.sh on each startup:

在每次啟動(dòng)時(shí)將cron作業(yè)添加到自動(dòng)啟動(dòng)start-dbgp-proxy.sh ：

@reboot /home/ray/start-dbgp-proxy.sh

設(shè)置客戶(hù)端 (Setup Client)

1. Access menu Tools > DBGp Proxy > Register IDE on PhpStorm.

1.在PhpStorm上訪(fǎng)問(wèn)菜單Tools > DBGp Proxy > Regist IDE。

2. Fill IDE key with unique string between developers. FillHost andPort with DBGp proxy's IP address and port (parameter -i on Setup Server #4).

2.用開(kāi)發(fā)人員之間的唯一字符串填充IDE key 。用DBGp代理的IP地址和端口(在Setup Server＃4上的參數(shù)-i )填充Host和Port 。

3. Click OK. You should see a success notification popup. If you don’t see it, re-register IDE via Tools > DBGp Proxy > Register IDE. If it's failed or you want to change the configuration, do it via Tools > DBGp Proxy > Configuration...

3.單擊確定。您應(yīng)該看到一個(gè)成功通知彈出窗口。如果看不到，請(qǐng)通過(guò)Tools > DBGp Proxy > Regist IDE重新注冊(cè)IDE。如果失敗或要更改配置，請(qǐng)不要t via Tools > DBGp Proxy > Conf配置” ...

4. (Optional) If you want to initiate debugging connection from the web browser, it’s recommended to install a debugging extension on your browser: Xdebug Helper Firefox or Xdebug Helper Chrome. Then configure your Xdebug Helper.

4.(可選)如果要通過(guò)Web瀏覽器啟動(dòng)調(diào)試連接，建議在瀏覽器上安裝調(diào)試擴(kuò)展程序： Xdebug Helper Firefox或Xdebug Helper Chrome 。然后配置您的Xdebug助手。

On Firefox, right click Xdebug Helper icon > Manage Extension… > Options On Chrome, right click Xdebug Helper icon > Options

在Firefox上，右鍵單擊Xdebug Helper圖標(biāo)>管理擴(kuò)展…>選項(xiàng)在Chrome上，右鍵單擊Xdebug Helper圖標(biāo)>選項(xiàng)

Fill and save IDE key with the same unique string as when you're registering the IDE (Step #2).

使用與注冊(cè)IDE時(shí)相同的唯一字符串填充并保存IDE key ( 第2步 )。

開(kāi)始調(diào)試 (Start Debugging)

1. Set breakpoint(s) on PhpStorm.

1.在PhpStorm上設(shè)置斷點(diǎn)。

2. Start listening to debug connection in PhpStorm by clicking the ‘phone’ button on the upper right toolbar or from menu Run > Start Listening for PHP Debug Connections. This will enable PhpStorm to react and opens the Debug window automatically when a debugging session is started.

2.單擊右上方工具欄上的“電話(huà)”按鈕，或從菜單中的Run > Start Listening for PHP Debug Connecti PhpStorm中的Run > Start Listening for PHP Debug Connecti 。啟動(dòng)調(diào)試會(huì)話(huà)時(shí)，這將使PhpStorm作出React并自動(dòng)打開(kāi)“調(diào)試”窗口。

3. Activate Xdebug’s debugger when doing a request. According to Xdebug Documentation there’re 3 ways to do this. But IMHO, the best way which works for all kinds of HTTP methods is by setting a cookie named XDEBUG_SESSION with value <IDE_key> which is the same unique string when we register our IDE to DBGp proxy (Setup Client #2).

3.在執(zhí)行請(qǐng)求時(shí)激活Xdebug的調(diào)試器。根據(jù)Xdebug文檔，有3種方法可以做到這一點(diǎn)。但是恕我直言，適用于所有HTTP方法的最佳方法是設(shè)置一個(gè)名為XDEBUG_SESSION的cookie，其值為<IDE_k ey>，當(dāng)我們將IDE注冊(cè)到DBGp poxy (安裝程序＃2)時(shí)，該cookie是相同的唯一字符串。

In the web browser, the cookie will be set automatically by Xdebug Helper extension
在Web瀏覽器中，將通過(guò)Xdebug Helper擴(kuò)展自動(dòng)設(shè)置cookie。

In Postman, the cookie can be set in Request Headers
在郵遞員中，可以在“請(qǐng)求標(biāo)題”中設(shè)置Cookie

4. Run the script with the cookie already set.

4.在已設(shè)置cookie的情況下運(yùn)行腳本。

5. On success, PhpStorm will show the Debug window automatically.

5.成功后，PhpStorm將自動(dòng)顯示“調(diào)試”窗口。

6. Make sure to unset/don’t send the cookie to disable debug and stop listening debug connection in PhpStorm if you’re not doing any debugging. If you fail to do so, it will make the DBGp proxy hang when there’s too many hanging connections.

6.如果您不進(jìn)行任何調(diào)試，請(qǐng)確保取消設(shè)置/不發(fā)送cookie來(lái)禁用調(diào)試并停止監(jiān)聽(tīng)PhpStorm中的調(diào)試連接。如果您這樣做失敗，則當(dāng)掛起的連接過(guò)多時(shí)，它將使DBGp代理掛起。

Hope this guide works for you.

希望本指南對(duì)您有用。

Thank you for reading!

感謝您的閱讀！

參考文獻(xiàn) (References)

https://www.jetbrains.com/help/phpstorm/multiuser-debugging-via-xdebug-proxies.html
https://www.jetbrains.com/help/phpstorm/multiuser-debugging-via-xdebug-proxies.html
https://www.jetbrains.com/help/phpstorm/browser-debugging-extensions.html
https://www.jetbrains.com/help/phpstorm/browser-debugging-extensions.html
https://xdebug.org/docs/remote#starting
https://xdebug.org/docs/remote#starting

翻譯自: https://www.freecodecamp.org/news/multi-user-debugging-in-phpstorm-75ef628ed50f/