PHPStorm在Ubuntu上的远程开发配置指南
远程开发的核心是通过PHPStorm连接远程Ubuntu服务器,实现本地编辑、远程运行/调试的无缝衔接。以下是详细步骤:
安装SSH服务(用于安全连接)
在远程Ubuntu服务器上执行以下命令安装并启动SSH服务:
sudo apt update
sudo apt install openssh-server
sudo systemctl restart sshd
确保/etc/ssh/sshd_config中PasswordAuthentication yes(允许密码登录)或配置SSH密钥认证(更安全)。
安装PHP环境(根据项目需求选择版本)
更新软件源并安装PHP及常用扩展:
sudo apt update
sudo apt install php php-cli php-mbstring php-xml php-curl php-mysql # 根据项目需求添加扩展
验证安装:php -v。
配置远程项目目录
在远程服务器上创建项目目录并设置权限(替换your_username为实际用户名):
mkdir -p /var/www/html/my_project
sudo chown -R your_username:your_username /var/www/html/my_project
sudo chmod -R 755 /var/www/html/my_project
启动PHP内置Web服务器(临时测试用,生产环境建议用Apache/Nginx)
进入项目目录,启动服务器(端口可自定义,如8000):
cd /var/www/html/my_project
php -S localhost:8000
此时服务器仅允许本地访问,后续需通过PHPStorm配置反向隧道或端口转发。
添加远程解释器(让PHPStorm使用远程PHP版本)
File > Settings > Languages & Frameworks > PHP。CLI Interpreter右侧的...,选择Add。Remote类型,点击...配置SSH连接:
192.168.1.100)。22)。ubuntu)。Password(输入密码)或Key pair(推荐,需提前生成SSH密钥并上传到服务器)。...选择远程服务器上的PHP解释器路径(通常为/usr/bin/php),点击Test Connection验证连接,最后点击OK保存。配置Deployment(文件同步)(实现本地与远程代码同步)
File > Settings > Build, Execution, Deployment > Deployment,点击+添加新配置。SFTP类型,填写连接信息:
22)。/var/www/html/my_project)。Mappings标签,设置Local path(本地项目目录)和Deployment path on server(远程项目目录相对于Root path的路径,如/表示根目录)。OK保存,可通过Tools > Deployment > Automatic Upload开启自动同步。配置Web服务器(用于本地访问远程项目)
Run > Edit Configurations,点击+添加PHP Built-in Web Server配置。Remote Server)。/var/www/html/my_project)。8080,避免与本地服务冲突)。OK保存,之后可通过http://localhost:8080在本地浏览器访问远程项目。若需要远程调试,需完成以下步骤:
安装Xdebug扩展(远程服务器)
sudo apt install php-xdebug
配置Xdebug(编辑php.ini)
找到远程服务器的php.ini文件(如/etc/php/8.1/cli/php.ini),添加以下配置:
zend_extension=/usr/lib/php/20210902/xdebug.so # Xdebug扩展路径(通过`php -i | grep xdebug.so`获取)
xdebug.mode=debug
xdebug.client_host=127.0.0.1 # 本地IP(若服务器与本地不在同一网络,需改为公网IP或SSH反向隧道)
xdebug.client_port=9003 # 调试端口(默认9003,与PHPStorm一致)
xdebug.start_with_request=yes # 自动启动调试
配置PHPStorm调试
Run > Edit Configurations,点击+添加PHP Remote Debug配置。IDE key(默认PHPSTORM)。Validate验证配置,确保Debugger显示为Connected。Run > Start Listening for PHP Debug Connections,触发调试(如访问http://localhost:8080?XDEBUG_SESSION_START=PHPSTORM)。chmod 777,建议755或775)。22)和调试端口(9003),避免被拦截。ssh-keygen生成密钥并上传到服务器~/.ssh/authorized_keys。