1. 准备工作：安装PhpStorm
首先下载PhpStorm Linux版本（.tar.gz格式），解压至Ubuntu系统目录（如/opt/phpstorm）。通过终端进入解压后的bin目录，运行./phpstorm.sh启动PhpStorm。首次启动需通过界面激活（输入激活码或使用授权文件），激活后可长期使用。
2. 配置PHP环境（本地开发必需）
确保Ubuntu系统已安装PHP及常用扩展（如php-cli、php-mysql、php-curl等），可通过sudo apt install php php-cli php-mysql php-curl php-gd php-mbstring一键安装。安装完成后，通过php -v验证PHP版本，确认安装成功。若使用PHP-FPM（配合Nginx/Apache），需额外配置/etc/php/{version}/fpm/pool.d/www.conf（修改listen为unix:/run/php/php{version}-fpm.sock），并启动服务：sudo systemctl start php{version}-fpm、sudo systemctl enable php{version}-fpm。
3. 配置PhpStorm项目解释器
打开PhpStorm，进入File > Settings > Languages & Frameworks > PHP，点击“CLI Interpreter”右侧的...按钮，选择“Add”。若PHP安装在本地，选择“Local Path to Interpreter”，找到/usr/bin/php（默认路径）；若使用WSL或远程解释器，选择对应类型并填写信息。配置完成后，点击“OK”保存，确保PhpStorm能识别PHP版本。
4. 配置远程服务器部署（关键步骤）
若项目需部署到Ubuntu服务器（或本地模拟远程环境），需通过SFTP/FTP实现文件同步。进入Tools > Deployment > Configuration，点击+添加服务器，选择“SFTP”类型。填写服务器信息：Name（如“My Ubuntu Server”）、Host（服务器IP或域名）、Port（默认22）、User name/password（登录凭证）或Key pair（SSH密钥，推荐）。切换至“Mappings”标签，设置Local path（本地项目路径，如~/projects/my_php_project）、Deployment path on server（服务器项目路径，如/var/www/my_php_project，需确保目录有写入权限）。点击“Test SFTP connection”验证连接，成功后保存配置。
5. 同步与调试项目
配置完成后，可通过Tools > Deployment > Upload to [服务器名称]手动上传文件，或设置自动上传（勾选“Tools > Deployment > Automatic Upload”）。若需调试，需安装Xdebug扩展：在服务器上编辑php.ini（如/etc/php/{version}/fpm/php.ini），添加zend_extension=xdebug.so、xdebug.mode=debug、xdebug.client_host=127.0.0.1、xdebug.client_port=9003（端口需与PhpStorm一致）。回到PhpStorm，进入Run > Edit Configurations，添加“PHP Remote Debug”，配置“Server”（与Deployment同名）和“Debugger”（端口设为9003），即可通过断点调试远程代码。
6. 版本控制集成（可选但推荐）
若项目使用Git，进入File > Settings > Version Control > Git，配置Git路径（如/usr/bin/git），点击“Test”验证。返回项目根目录，右键选择Git > Add添加文件，通过Commit Directory提交更改，或Push推送至远程仓库（如GitHub、GitLab）。