在 Ubuntu 上搭建 PhpStorm 集成开发环境
一 安装与启动
- 安装 OpenJDK 11(PhpStorm 运行依赖 Java):sudo apt update && sudo apt install openjdk-11-jdk;验证:java -version。
- 从 JetBrains 官网下载 Linux 版 PhpStorm 的 .tar.gz,解压至 /opt/phpstorm:tar -xvzf PhpStorm-.tar.gz && sudo mv PhpStorm- /opt/phpstorm。
- 启动:/opt/phpstorm/bin/phpstorm.sh;为便于全局调用,可创建软链:sudo ln -s /opt/phpstorm/bin/phpstorm.sh /usr/local/bin/phpstorm,之后直接输入 phpstorm 即可启动。
二 配置 PHP 与 Web 环境
- 安装 PHP 及常用扩展:sudo apt install php php-xdebug php-mysql php-zip php-gd;验证:php -v。
- 安装 Apache 并启用 PHP 模块(以 PHP 7.4 为例):sudo apt install apache2;sudo a2enmod php7.4;sudo systemctl restart apache2。
- 验证 Web+PHP:在 /var/www/html/info.php 写入 ,浏览器访问 http://localhost/info.php。
三 配置调试与运行
- 确认 Xdebug 已安装:sudo apt install php-xdebug。
- 配置 php.ini(路径可用 php --ini 查看),启用 Xdebug 并设置端口为 9003:
zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_port=9003
重启 Apache:sudo systemctl restart apache2。
- 在 PhpStorm:File → Settings → PHP → Servers 新增服务器,Host 填 localhost,Port 80,Debugger 选 Xdebug,PHP Executable 选 /usr/bin/php,Debug port 9003;Run → Edit Configurations 新建 PHP Web Page,配置 URL(如 http://localhost/info.php),使用工具栏的调试按钮启动。
四 版本控制与数据库集成
- 安装并配置 Git:sudo apt install git;在 PhpStorm:File → Settings → Version Control → Git 配置路径(通常 /usr/bin/git),可克隆或导入项目进行版本管理。
- 配置 MySQL 数据库连接:sudo apt install mysql-server;执行 sudo mysql_secure_installation 完成安全初始化;在 PhpStorm:Database 工具窗口 → + → MySQL,填写 Host localhost、Port 3306、用户名与密码,点击 Test Connection 验证。
五 常用优化与排错
- 创建桌面启动器:Tools → Create Desktop Entry,勾选 Create associations 以便从应用菜单启动。
- 插件与外观:Settings → Plugins 安装如 Chinese(Simplified)Language Pack 等;按需调整 Keymap 与 Editor 配色。
- 常见问题:
- 端口冲突:确认 9003 未被占用(lsof -i:9003),或修改为其他端口并同步 php.ini 与 PhpStorm 设置。
- Xdebug 不生效:检查 php.ini 路径、zend_extension 是否加载、Apache 是否重启、Server 与 Run Configuration 的 Debug port 一致。
- PHP 版本不匹配:a2enmod 启用与已安装 PHP 版本一致的模块(如 php8.1),并重启服务。