Debian上phpstorm如何共享项目

Debian上PhpStorm共享项目的常见方法（以SFTP远程开发为例）

一、前置准备

1. 确保远程Debian服务器已安装PHP及必要组件：

   sudo apt update &
       &
        sudo apt install php php-cli php-mbstring php-xml -y
   

2. 确保远程服务器已安装并启动SSH服务：

   sudo systemctl enable --now ssh
   

3. 本地计算机与远程服务器之间可通过SSH连接（测试命令：ssh username@remote_ip）。

二、配置远程解释器（让PhpStorm识别远程PHP环境）

1. 打开PhpStorm，进入 File > Settings > Languages & Frameworks > PHP。
2. 点击右上角齿轮图标，选择 Add，在弹出窗口中选择 SSH Interpreter。
3. 输入远程服务器信息：
   • Host：远程服务器IP或域名；
   • Port：SSH端口（默认22）；
   • Username：远程登录用户名；
   • Authentication type：选择密码或密钥对（密钥对更安全，需提前将公钥添加到服务器~/.ssh/authorized_keys文件中）。
4. 点击 Test Connection 验证连接，成功后选择远程PHP解释器路径（通常为/usr/bin/php），点击 OK 保存。

三、配置Deployment（同步本地与远程项目文件）

1. 进入 File > Settings > Build, Execution, Deployment > Deployment，点击 + 添加新配置，选择 SFTP 类型。
2. 在 Connection 标签页配置连接信息：
   • SFTP host：远程服务器IP或域名；
   • Port：SSH端口（默认22）；
   • User name：远程登录用户名；
   • Authentication type：同远程解释器配置；
   • 点击 Test SFTP connection 验证连接，成功后进入 Mappings 标签页。
3. 在 Mappings 标签页设置目录映射：
   • Local path：本地项目目录（如/home/user/projects/my_php_project）；
   • Deployment path on server：远程服务器项目目录（如/var/www/html/my_php_project，需确保该目录有写入权限）；
   • Web path on server：项目在服务器上的Web访问路径（如/my_php_project，用于生成项目URL）。
4. （可选）进入 Options 标签页，勾选 Upload changed files automatically to the default server（自动上传修改的文件），或在保存文件时手动触发同步（点击工具栏 Deployment > Upload to…）。

四、配置远程运行/调试（可选，用于本地调试远程代码）

1. 进入 Run > Edit Configurations，点击 + 添加新配置，选择 PHP Built-in Web Server。
2. 配置运行参数：
   • Server：选择之前配置的远程解释器对应的服务器；
   • Document root：远程服务器项目目录（与Deployment中的Deployment path on server一致）；
   • Port：本地监听端口（如8000，需未被占用）。
3. 点击 OK 保存配置，此时可通过 Run > Debug 启动远程调试（需配合Xdebug配置，详见后续步骤）。

五、配置Xdebug远程调试（可选，增强调试能力）

1. 在远程服务器上安装Xdebug扩展：

   sudo apt install php-xdebug -y
   

2. 编辑远程服务器的PHP配置文件（如/etc/php/8.1/cli/php.ini，根据PHP版本调整）：

   zend_extension=xdebug.so
   xdebug.mode=debug
   xdebug.client_host=local_computer_ip  # 本地计算机的IP地址（需与远程服务器在同一网络或通过SSH反向隧道连接）
   xdebug.client_port=9003               # 默认调试端口（PhpStorm默认监听9003）
   xdebug.start_with_request=yes         # 自动启动调试
   

3. 重启远程服务器的Web服务（如Apache/Nginx）：

   sudo systemctl restart apache2  # 或 nginx
   

4. 在PhpStorm中配置调试监听：
   • 进入 Run > Edit Configurations，点击 + 添加 PHP Remote Debug 配置；
   • 选择之前创建的服务器，确保Debugger设置为Xdebug，Port与xdebug.client_port一致（9003）；
   • 点击 OK 保存，在代码行号旁点击设置断点，通过 Run > Debug 启动调试。

六、访问远程项目

1. 若配置了PHP Built-in Web Server，可在PhpStorm浏览器工具栏输入：
   http://localhost:8000（端口为配置中的Port）访问远程项目。
2. 若通过SFTP同步到远程服务器的Web目录（如/var/www/html），可直接通过浏览器访问：
   http://remote_ip/project_name（需确保服务器防火墙开放对应端口）。

注意事项

• 确保远程服务器的Web目录（如/var/www/html）有正确的写入权限（通常为www-data:www-data，可根据项目需求调整）；
• 若使用密钥对认证，需确保本地私钥文件权限为600（chmod 600 ~/.ssh/id_rsa）；
• 若遇到连接问题，检查远程服务器SSH服务状态（sudo systemctl status ssh）、防火墙设置（sudo ufw allow 22/tcp）及PhpStorm的网络代理配置（若有）。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！