如何在浏览器端Google Cloud Workstations中调试并运行PHP应用

一、安装PHP #

Cloud Workstations默认环境未预装PHP，可通过终端完成安装：

• 打开Code-OSS内置终端，执行包更新：sudo apt update
• 安装PHP及常用扩展：sudo apt install php php-cli php-xdebug php-curl php-mbstring
• 验证安装：php -v，输出PHP版本信息即为成功

二、运行PHP应用 #

运行逻辑与Cloud Shell类似，需注意端口暴露配置：

• 切换到你的PHP项目目录：cd /path/to/your/php-project
• 启动内置服务器时绑定所有网卡（而非仅localhost）：php -S 0.0.0.0:8080
• 终端右下角会弹出端口访问提示，点击「Open in Browser」即可访问应用；若未弹出，可通过Workstations的「端口转发」功能手动添加8080端口，再访问对应URL

三、调试PHP应用（基于Xdebug） #

1. 配置Xdebug #

• 找到Xdebug配置文件（路径示例：/etc/php/8.2/cli/conf.d/20-xdebug.ini，版本号根据实际安装情况调整）
• 编辑文件，添加或修改以下配置项：

  xdebug.mode=debug
  xdebug.start_with_request=yes
  xdebug.client_host=localhost
  xdebug.client_port=9003
  

• 保存后重启终端使配置生效

2. 配置Code-OSS调试环境 #

• 在Code-OSS扩展市场搜索「PHP Debug」（作者Felix Becker）并安装
• 点击左侧「运行和调试」图标，选择「创建launch.json文件」，再选「PHP」环境，自动生成调试配置
• 确保launch.json包含以下核心配置：

  {
      "version": "0.2.0",
      "configurations": [
          {
              "name": "Listen for Xdebug",
              "type": "php",
              "request": "launch",
              "port": 9003
          },
          {
              "name": "Launch currently open script",
              "type": "php",
              "request": "launch",
              "program": "${file}",
              "cwd": "${fileDirname}",
              "port": 9003
          }
      ]
  }
  

3. 开始调试 #

• 在PHP代码行号左侧点击设置断点（红色圆点标记）
• 点击调试面板的「Listen for Xdebug」启动监听
• 再次执行php -S 0.0.0.0:8080启动服务器，浏览器访问对应页面后，Code-OSS会自动触发断点，可进行变量查看、单步执行等调试操作

内容的提问来源于stack exchange，提问作者DanielAttard