在 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），并重启服务。