PhpStorm Ubuntu版使用指南
下载安装包
访问JetBrains官网(jetbrains.com),进入PhpStorm产品页面,下载适用于Linux系统的.tar.gz格式安装包(建议选择最新稳定版)。
解压安装包
打开终端,导航至下载目录(如~/Downloads),运行以下命令解压:
tar -xvzf PhpStorm-*.tar.gz
解压后会生成PhpStorm-*目录(如PhpStorm-2024.3)。
移动至系统目录(可选)
为保持系统整洁,可将解压后的目录移动至/opt(需管理员权限):
sudo mv PhpStorm-* /opt/phpstorm
创建软链接(可选)
为方便命令行启动,可创建软链接:
sudo ln -s /opt/phpstorm/bin/phpstorm.sh /usr/local/bin/phpstorm
之后可直接通过phpstorm命令启动。
启动PhpStorm
phpstorm(若已创建软链接)。/opt/phpstorm/bin目录,双击phpstorm.sh或在终端运行./phpstorm.sh。激活软件
ja-netfilter-all文件夹复制至/opt/phpstorm/bin目录,并编辑phpstorm64.vmoptions(64位系统)文件,添加以下内容(替换为实际路径):-javaagent:/opt/phpstorm/bin/ja-netfilter-all/ja-netfilter.jar=jetbrains--add-opens=java.base/jdk.internal.org.objectweb.asm=ALL-UNNAMED--add-opens=java.base/jdk.internal.org.objectweb.asm.tree=ALL-UNNAMED
保存后重启PhpStorm。安装Java环境(若未安装)
PhpStorm基于Java开发,需安装JDK(推荐OpenJDK 11及以上):
sudo apt update
sudo apt install openjdk-11-jdk
验证安装:java -version,需显示JDK版本信息。
配置PHP解释器
File→Settings(或Ctrl+Alt+S)。Languages & Frameworks→PHP。Add,选择PHP可执行文件路径(如/usr/bin/php),点击OK保存。配置数据库连接(可选)
Settings→Languages & Frameworks→PHP→Servers。+号,选择数据库类型(如MySQL),输入主机名(localhost)、端口(3306)、用户名、密码,点击Test Connection验证连接,确认后保存。部署设置(同步本地与远程服务器)
Settings→Tools→Deployment→Configuration。+号,选择协议(如SFTP),填写服务器信息(主机名、端口、用户名、密码/密钥)。Mappings标签,配置本地项目目录与远程服务器目录的映射(如本地/project→远程/var/www/html)。Automatic Upload,实现本地修改后自动同步至服务器。调试配置(Xdebug)
sudo apt install php-xdebug
/etc/php/7.x/apache2/php.ini(根据PHP版本调整),添加以下内容:zend_extension=xdebug.so
xdebug.remote_enable=1
xdebug.remote_autostart=1
xdebug.remote_port=9003
重启Apache:sudo systemctl restart apache2。Run→Edit Configurations,点击+号选择PHP Remote Debug。Server标签添加服务器配置(与部署设置一致),Debugger标签确认端口为9003。OK保存。插件管理
Settings→Plugins,搜索所需插件(如中文语言包、Code With Me)。Install,安装完成后重启PhpStorm生效(如中文语言包需重启后切换语言)。新建项目
File→New→Project,选择PHP类型。~/projects/my_api),选择PHP解释器(已配置),点击Create。编写与调试代码
src/Api/UserController.php),编写代码(如处理HTTP请求的函数)。Debug按钮(绿色虫子图标)或使用Shift+F9启动调试会话。http://localhost/user/info),程序执行至断点时暂停,可查看变量值、单步执行(F7/F8)等。创建桌面启动器:
若需桌面图标启动,可运行以下命令编辑桌面文件:
sudo gedit /usr/share/applications/phpstorm.desktop
输入以下内容(替换为实际路径):
[Desktop Entry]
Name=PhpStorm
Comment=PHP IDE
Exec=/opt/phpstorm/bin/phpstorm.sh
Icon=/opt/phpstorm/bin/webide.png
Terminal=false
Type=Application
Categories=Development;IDE;
保存后,桌面将出现PhpStorm图标,双击即可启动。
调整外观:
进入File→Settings→Appearance & Behavior→Appearance,可选择主题(如Darcula深色模式)或字体大小,提升视觉体验。
通过以上步骤,可在Ubuntu系统上完成PhpStorm的安装、基础配置及日常使用,满足PHP开发的常见需求。若遇问题,可参考PhpStorm官方文档或社区论坛获取帮助。