如何在基于 Docker 的 PHP 环境使用 VScode 进行断点调试
发布时间：2024-11-10 点击：86
本文关键点
visual studio code docker 下的 php 环境 xdebug 1. visual studio code 1.1. 安装、设置
官方下载
macos linux windows
推荐配置
请参考这里，只是一些初始设置、美化等，与 php 调试无关。
1.2. php debug
安装
快捷键 cmd p 或 ctrl p，输入 ext install php debug
注意：安装完成后必须重启 vscode。
配置
打开一个 php 项目，点击菜单 debug > add configuration，或按照下图操作
详细配置如下：
{ // 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": "listen for xdebug", "type": "php", "request": "launch", "port": 9001, // 对应 xdebug 的配置 "stoponentry": true, "pathmappings": { // "容器中对应的项目地址": "本机项目地址" // 绝对路径 "/var/www/html/debao/": "${workspaceroot}" } }, { "name": "launch currently open script", "type": "php", "request": "launch", "program": "${file}", "cwd": "${filedirname}", "port": 9001 } ] }
配置成功后，在项目下生成一个包含该配置的目录，如下：
. ├── .vscode │ ├── launch.json ├── 其它项目文件 2. docker 下的 php 环境
推荐直接克隆我之前封装的一个基于 docker 的 lnmpa 环境，当然你也可用使用你自己的 docker php 环境，但是这里的配置是针对 nginx apache 的组合形式，你可以根据具体环境进行调整。
详细如下：
2.1. 安装、配置 xdebug 扩展
修改 dockerfile 文件，安装 xdebug
… && mkdir -p /tmp/xdebug && wget -c https://github.com/xdebug/xdebug/archive/2.6.0.tar.gz && tar -xf 2.6.0.tar.gz -c /tmp/xdebug –strip-components=1 && docker-php-ext-configure /tmp/xdebug –enable-xdebug && docker-php-ext-install /tmp/xdebug …
修改后，需要重新编译对应的镜像文件，更多安装扩展的方式请参考：docker 中的 php 如何安装扩展
配置 xdebug
在 php.ini 文件追加以下配置
[xdebug] zend_extension = xdebug.so xdebug.remote_enable = 1 xdebug.remote_handler = dbgp xdebug.remote_port = 9001 xdebug.remote_autostart = 1 xdebug.remote_connect_back = 0 xdebug.idekey = docker xdebug.remote_host = 192.168.2.14
说明：
remote_port 默认 9000，为避免冲突，改为 9001 remote_host 是宿主机的 ip 地址 2.2. 调整 nginx server 配置
server { listen 80; server_name my.test; # 这里替换你的域名 index index.html index.htm index.php; root /usr/share/nginx/html/test; … location ~ .*.(php|php5)?$ { proxy_pass http://php_apache:8091; # 这里是对应的 apache 容器地址和端口 proxy_read_timeout 300; proxy_send_timeout 300; index index.php; proxy_set_header host $host; proxy_set_header x-real-ip $remote_addr; } … }
主要追加以下两个参数，用以解决在 debug 时 504 超时问题，具体数值可根据需要设置。
proxy_read_timeout proxy_send_timeout 2.3. 暴露 xdebug 通信接口
修改 docker-compose.yml 文件，在 nginx 和 apache 服务下通过 expose 暴露 9001 端口
使用如下命令重新启动服务
docker-compose stop docker-compose down docker-compose up -d 3. 测试断点调试
按快捷键 f5 打开断点，此时在浏览器中访问网页，将跳转到 vscode 编辑器，并且样式如下：
说明：上图是一个 tp 项目，虽然没有手动设置断点，但是开启调试模式后，访问网页会首先进入根目录下的框架入口文件。
网站在SEO优化中如何精准定位
商城网站要怎么提升转化率？
php如何将汉字转ascii
公司主体变更了那域名备案是怎么快速变过来
微信接入需要设置白名单-虚拟主机/数据库问题
请问这个营业执照可以了不呢
电脑没有word文档怎么安装 word怎么下载安装到电脑上
无法访问请帮忙处理下-云服务器问题
visual studio code docker 下的 php 环境 xdebug 1. visual studio code 1.1. 安装、设置
官方下载
macos linux windows
推荐配置
请参考这里，只是一些初始设置、美化等，与 php 调试无关。
1.2. php debug
安装
快捷键 cmd p 或 ctrl p，输入 ext install php debug
注意：安装完成后必须重启 vscode。
配置
打开一个 php 项目，点击菜单 debug > add configuration，或按照下图操作
详细配置如下：
{ // 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": "listen for xdebug", "type": "php", "request": "launch", "port": 9001, // 对应 xdebug 的配置 "stoponentry": true, "pathmappings": { // "容器中对应的项目地址": "本机项目地址" // 绝对路径 "/var/www/html/debao/": "${workspaceroot}" } }, { "name": "launch currently open script", "type": "php", "request": "launch", "program": "${file}", "cwd": "${filedirname}", "port": 9001 } ] }
配置成功后，在项目下生成一个包含该配置的目录，如下：
. ├── .vscode │ ├── launch.json ├── 其它项目文件 2. docker 下的 php 环境
推荐直接克隆我之前封装的一个基于 docker 的 lnmpa 环境，当然你也可用使用你自己的 docker php 环境，但是这里的配置是针对 nginx apache 的组合形式，你可以根据具体环境进行调整。
详细如下：
2.1. 安装、配置 xdebug 扩展
修改 dockerfile 文件，安装 xdebug
… && mkdir -p /tmp/xdebug && wget -c https://github.com/xdebug/xdebug/archive/2.6.0.tar.gz && tar -xf 2.6.0.tar.gz -c /tmp/xdebug –strip-components=1 && docker-php-ext-configure /tmp/xdebug –enable-xdebug && docker-php-ext-install /tmp/xdebug …
修改后，需要重新编译对应的镜像文件，更多安装扩展的方式请参考：docker 中的 php 如何安装扩展
配置 xdebug
在 php.ini 文件追加以下配置
[xdebug] zend_extension = xdebug.so xdebug.remote_enable = 1 xdebug.remote_handler = dbgp xdebug.remote_port = 9001 xdebug.remote_autostart = 1 xdebug.remote_connect_back = 0 xdebug.idekey = docker xdebug.remote_host = 192.168.2.14
说明：
remote_port 默认 9000，为避免冲突，改为 9001 remote_host 是宿主机的 ip 地址 2.2. 调整 nginx server 配置
server { listen 80; server_name my.test; # 这里替换你的域名 index index.html index.htm index.php; root /usr/share/nginx/html/test; … location ~ .*.(php|php5)?$ { proxy_pass http://php_apache:8091; # 这里是对应的 apache 容器地址和端口 proxy_read_timeout 300; proxy_send_timeout 300; index index.php; proxy_set_header host $host; proxy_set_header x-real-ip $remote_addr; } … }
主要追加以下两个参数，用以解决在 debug 时 504 超时问题，具体数值可根据需要设置。
proxy_read_timeout proxy_send_timeout 2.3. 暴露 xdebug 通信接口
修改 docker-compose.yml 文件，在 nginx 和 apache 服务下通过 expose 暴露 9001 端口
使用如下命令重新启动服务
docker-compose stop docker-compose down docker-compose up -d 3. 测试断点调试
按快捷键 f5 打开断点，此时在浏览器中访问网页，将跳转到 vscode 编辑器，并且样式如下：
说明：上图是一个 tp 项目，虽然没有手动设置断点，但是开启调试模式后，访问网页会首先进入根目录下的框架入口文件。
网站在SEO优化中如何精准定位
商城网站要怎么提升转化率？
php如何将汉字转ascii
公司主体变更了那域名备案是怎么快速变过来
微信接入需要设置白名单-虚拟主机/数据库问题
请问这个营业执照可以了不呢
电脑没有word文档怎么安装 word怎么下载安装到电脑上
无法访问请帮忙处理下-云服务器问题