在VS Code 中调试远程服务器的PHP代码详解

 更新时间:2023年07月13日 08:48:04   作者:hotaigc.cn  
这篇文章主要介绍了在VSCode中调试远程服务器的PHP代码,这里通过xdebug配合vscode的php debug插件来实现,本文结合实例代码介绍的非常详细,需要的朋友可以参考下

背景

对于PHP的调试,一般来说我们用 echo 和 var_dump 就够用了。

有时会碰到要解决复杂的逻辑或需要确认代码的运行顺序,这里用var_dump效率就比较低了,这时建议用断点的方式进行代码调试。

这里通过 xdebug 配合vscode 的 php debug插件来实现。

配置步骤

1. 安装 php debug 插件

在VS Code中安装php debug插件

这时会在你的项目的 .vscode 目录下生成 launch.json 文件:

文件内容如下:

{
    // Use IntelliSense to learn about possible attributes.
    // Hover to view descriptions of existing attributes.
    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Launch built-in server and debug",
            "type": "php",
            "request": "launch",
            "runtimeArgs": [
                "-S",
                "localhost:8000",
                "-t",
                "."
            ],
            "port": 9003,
            "serverReadyAction": {
                "action": "openExternally"
            }
        },
        {
            "name": "Debug current script in console",
            "type": "php",
            "request": "launch",
            "program": "${file}",
            "cwd": "${fileDirname}",
            "externalConsole": false,
            "port": 9003
        },
        {
            "name": "Listen for Xdebug",
            "type": "php",
            "request": "launch",
            "port": 9003
        }
    ]
}

这里定义了三种调度模式:

  • Launch built-in server and debug:适合没有web server的环境,这种模式会用内置的 PHP 调试器启动一个简单的 PHP Web 服务器,然后在浏览器中访问 http://localhost:端口号 来访问您的 PHP 网站。

  • Debug current script in console:这种是控制台模式。

  • Listen for Xdebug:这种是监听xdebug,本文采用的就是这种模式。

这里我们可以先看看控制台模式效果:

我们准备一个简单的PHP代码:

<?php
    $url = "https://hotaigc.cn";
    if ($url == "https://hotaigc.cn") {
        echo "success";
    } else {
        echo "error";
    }

我们在if这里打个断点,运行效果如图:

然后打开调试面板(图中1),选择 Debug current script in console(图中2),然后点运行(图中3),就可以看到调试的效果

2. 安装 xdebug

在远程服务器上安装 xdebug,我的是 ubuntu 20.4 环境,用 apt-get 安装就可以了:

sudo apt-get install php8.1-xdebug

其他系统参考这里:https://xdebug.org/docs/install

这里需要注意的是xdebug需要跟php的版本保持一致,你可以通过 phpinfo()来确认你的PHP版本。

还有一个易出错的点是部分ubuntu版本会提示找不到xdebug包,这是因为一般都用这个PPA库进行安装( https://launchpad.net/~ondrej/+archive/ubuntu/php ),但这个库已经不支持 ubuntu 20 以下的版本,具体见:
https://wiki.ubuntu.com/Releases

如下图,红框以下的都已经不支持了,只能自己想办法从源码编译了:

3. 在php.ini中进行配置

找到 php.ini 的路径,可以从 phpinfo() 中找:

然后添加如下参数:

[xdebug]
# 根据扩展实际存放路径填写
zend_extension=xdebug
;xdebug3.0中用于代替之前的xdebug.remote_enable=On
xdebug.mode=debug
;xdebug3.0中用于代替之前的xdebug.remote_autostart,trigger对应之前的off,yes对应之前的on
xdebug.start_with_request=trigger
;xdebug3.0中用于代替之前的xdebug.remote_host
xdebug.client_host="127.0.0.1"
;xdebug3.0中用于代替之前的xdebug.remote_connect_back=On,它会自动从$_SERVER['HTTP_X_FORWARDED_FOR']
;或$_SERVER['REMOTE_ADDR']变量中获取ip,当然因为$_SERVER只有服务器模式有所以客户端模式是用不了的(可配置其它变量)
;如果找不到ip它会回退(fallback)到xdebug.client_host指定的ip
xdebug.discover_client_host=true
;xdebug3.0中用于代替之前的xdebug.remote_port
xdebug.client_port=9003
;固定填dbgp(因为目前只支持这个协议,也只有这个协议)
xdebug.remote_handler="dbgp"
;这是一个所有网上的文章都提到要设置但实际上却没啥用的参数(不信你可以注释掉试试,一切都正常)
xdebug.idekey="PHPSTORM"

这里需要注意的是 xdebug 的 3.x 版本和 2.x 版本参数是不一样的。

开始调试

1. 打断点

这次我们写一个简单的 Controller 代码(注,我这里用的是Laravel),还是在if这里加个断点(在VS Code的行号左边点击一下即可):

class CommonController extends Controller
{
    public function test(Request $request) {
        $a = 1;
        if ($a == 1) {
            return phpinfo();
        }
        return 1;
    }
}

2. 启动调试

选择Listen for Xdebug调试模式,然后启动调试(第3张图中有示例)

3. 在浏览器中打开页面

在浏览器中打开会运行该 Controller 方法的页面(这里涉及到一些Laravel细节,不展开讲),正常情况这时浏览器页面会停在加载中状态,等待调试。

4. 进行调试

这时打开 VS Code,会看到代码执行到断点这里停住了,我们可以看到变量,调用堆栈,调试工具栏等信息,如下图所示:

到此这篇关于在VS Code 中调试远程服务器的PHP代码的文章就介绍到这了,更多相关VS Code 调试远程服务器内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • php+ajax实现无刷新文件上传功能(ajaxuploadfile)

    php+ajax实现无刷新文件上传功能(ajaxuploadfile)

    这篇文章主要为大家详细介绍了php结合ajaxuploadfile实现无刷新文件上传功能,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-02-02
  • PHP Streams(流)详细介绍及使用

    PHP Streams(流)详细介绍及使用

    这篇文章主要介绍了PHP Streams(流)详细介绍及使用,PHP Streams是内置核心操作,可能一般的开发者很少用,它用于统一文件、网络、数据压缩等类文件操作方式,并为这些类文件操作提供一组通用的函数接口,需要的朋友可以参考下
    2015-05-05
  • php处理restful请求的路由类分享

    php处理restful请求的路由类分享

    利用路由表与restful url进行匹配,分发到不同的action处理,最基本的实现,只考虑路由分发功能
    2014-02-02
  • php实现信用卡校验位算法THE LUHN MOD-10示例

    php实现信用卡校验位算法THE LUHN MOD-10示例

    这篇文章主要介绍了php实现信用卡校验位算法THE LUHN MOD-10的示例,需要的朋友可以参考下
    2014-05-05
  • php实现水仙花数示例分享

    php实现水仙花数示例分享

    这篇文章主要介绍了php实现水仙花数示例,需要的朋友可以参考下
    2014-04-04
  • Yii中表单用法实例详解

    Yii中表单用法实例详解

    这篇文章主要介绍了Yii中表单用法,结合实例形式较为详细的分析总结了Yii针对表单的各种常用操作技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2016-01-01
  • CI框架实现创建自定义类库的方法

    CI框架实现创建自定义类库的方法

    这篇文章主要介绍了CI框架实现创建自定义类库的方法,结合实例形式分析了CI框架创建自定义类库的相关原理、步骤、实现方法与操作注意事项,需要的朋友可以参考下
    2018-12-12
  • PHP实现登录注册之BootStrap表单功能

    PHP实现登录注册之BootStrap表单功能

    登录与注册是我们在web开发中最常见的模块,也是我们日常生活中经常接触的功能。下面通过本文给大家分享PHP实现登录注册之BootStrap表单功能,需要的朋友参考下吧
    2017-09-09
  • php数组去除空值函数分享

    php数组去除空值函数分享

    本文给大家分享一个使用php制作数组去除空值函数,非常实用,推荐给大家,希望大家能够喜欢。
    2015-02-02
  • 基于Discuz security.inc.php代码的深入分析

    基于Discuz security.inc.php代码的深入分析

    本篇文章是对Discuz security.inc.php的代码进行了详细的分析介绍,需要的朋友参考下
    2013-06-06

最新评论