Debian系统中PHPStorm如何进行远程开发 - 问答

1. 安装与准备

安装PHPStorm：通过JetBrains官网下载Linux安装包（.tar.gz格式），解压后运行bin/phpstorm.sh启动；或使用snap install phpstorm --classic（推荐，便于后续更新）。安装完成后，确保PHPStorm具有访问网络和文件的权限。
远程服务器准备：Debian服务器需安装PHP环境（如sudo apt install php php-cli php-mbstring php-xml）、Web服务器（Apache/Nginx）及SSH服务（sudo apt install openssh-server）。启动SSH服务：sudo systemctl start sshd，并设置开机自启：sudo systemctl enable sshd。

2. 配置远程服务器连接（Deployment）

打开PHPStorm，进入File > Settings > Build, Execution, Deployment > Deployment，点击+添加新配置，选择SFTP（常用传输协议）。
在Connection标签页填写服务器信息：
- SFTP Host：服务器IP或域名（如192.168.1.100）；
- Port：SSH端口（默认22，若修改需同步调整服务器配置）；
- User name：登录用户名（如debian）；
- Authentication：选择Password（输入密码）或Key pair（推荐，提前将本地公钥~/.ssh/id_rsa.pub添加到服务器~/.ssh/authorized_keys）。
点击Test SFTP connection验证连接，成功后会显示绿色勾选框。
切换至Mappings标签页，设置本地项目目录（如/home/user/my_project）与远程服务器目录（如/var/www/html/my_project）的映射，确保文件同步路径正确。

3. 配置远程PHP解释器

进入File > Settings > Languages & Frameworks > PHP，点击CLI Interpreter右侧的齿轮图标，选择Add。
选择SSH Interpreter，点击...选择之前配置的Deployment服务器（避免重复输入连接信息），或手动填写服务器信息。
在Interpreter字段，点击...浏览远程服务器上的PHP可执行文件路径（通常为/usr/bin/php，可通过which php命令获取）。
（可选）指定远程Composer路径（如/usr/local/bin/composer），便于依赖管理。
点击OK保存，PHPStorm将通过SSH调用远程PHP解释器执行代码（如运行脚本、安装依赖）。

4. 配置Xdebug远程调试

安装Xdebug扩展：在Debian服务器上运行sudo apt install php-xdebug（根据PHP版本调整，如php7.4-xdebug、php8.1-xdebug）。

修改php.ini配置：通过php --ini找到php.ini文件路径（如/etc/php/8.1/cli/php.ini），添加以下配置：

zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes  ; 自动启动调试（可选：trigger/yes）
xdebug.client_host=192.168.1.100  ; 本地电脑IP（需与PHPStorm所在机器一致）
xdebug.client_port=9003         ; 调试端口（默认9003，需与PHPStorm配置一致）
xdebug.idekey=PHPSTORM          ; IDE标识（需与PHPStorm设置一致）

重启Web服务器：若使用Apache，运行sudo systemctl restart apache2；若使用Nginx+PHP-FPM，运行sudo systemctl restart php8.1-fpm。
配置PHPStorm调试：
- 进入File > Settings > Languages & Frameworks > PHP > Servers，点击+添加服务器，填写：
  - Name：自定义名称（如Debian Server）；
  - Host：远程服务器IP或域名（如192.168.1.100）；
  - Port：HTTP端口（如80）；
  - Debugger：选择Xdebug。
- 进入Run > Edit Configurations，点击+添加PHP Remote Debug配置，选择刚才添加的服务器，点击OK。
启动调试：点击PHPStorm右上角的电话图标（Start Listening for PHP Debug Connections），在浏览器中访问远程项目时添加参数XDEBUG_SESSION=PHPSTORM（可通过Chrome插件“Xdebug helper”一键设置），刷新页面即可触发断点。

5. 文件同步设置

在Deployment配置中，切换至Options标签页，设置自动同步策略：
- Upload changed files automatically to the default server：勾选后，本地保存文件时自动上传至远程服务器；
- Exclude files by name：可排除无需同步的文件（如node_modules、.git）。
手动同步：右键项目根目录，选择Deployment > Upload to...，选择目标服务器即可。

注意事项

确保本地电脑与远程服务器之间的网络连通（可通过ping命令测试）；
若使用密钥认证，确保本地私钥（~/.ssh/id_rsa）权限为600，且公钥已添加到服务器~/.ssh/authorized_keys；
Xdebug配置中的client_host需填写本地电脑的实际IP（若服务器与本地在同一局域网，可使用局域网IP；若跨网络，需使用公网IP或配置SSH反向隧道）；
若调试端口9003被占用，可在php.ini和PHPStorm中修改为其他端口（如9004），并确保防火墙允许该端口通过（sudo ufw allow 9003/tcp）。

0 赞

0 踩