1. 准备工作:安装系统依赖
在Debian上安装PhpStorm前,需先安装必要的图形界面库和工具,避免安装或运行时出现依赖错误。打开终端,运行以下命令:
sudo apt update && sudo apt install -y libgtk-3-0 libgconf-2-4 libasound2 libatk1.0-0 libc6 libcairo2 libx11-6 libx11-xcb1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxtst6 libnss3 libxss1 libpangocairo-1.0-0 libatk-bridge2.0-0
2. 下载并安装PhpStorm
.deb格式安装包(如phpstorm-2025.2.deb)。~/Downloads),运行以下命令安装:sudo dpkg -i ~/Downloads/phpstorm-*.debsudo apt --fix-broken install自动修复。3. 配置PHP环境 PhpStorm需关联系统中的PHP解释器才能正确解析代码。
sudo apt install -y php php-cli php-mbstring php-xml php-curl php-mysqlFile > Settings > Languages & Frameworks > PHP,点击CLI Interpreter右侧的齿轮图标,选择“Add”,然后浏览至系统PHP路径(通常为/usr/bin/php),PhpStorm会自动检测PHP版本及已安装扩展。4. 配置Xdebug调试(可选但推荐) Xdebug是PHP调试的常用工具,需配合PhpStorm使用。
sudo apt install -y php-xdebug安装扩展。/etc/php/8.2/cli/php.ini),添加以下内容:[Xdebug]
zend_extension=/usr/lib/php/20220829/xdebug.so  # 路径需根据实际安装位置调整
xdebug.mode=debug
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.idekey=PHPSTORM
保存后重启PHP服务(如使用Apache:sudo systemctl restart apache2)。File > Settings > Languages & Frameworks > PHP > Debug,确认Debug port设置为9003(与php.ini一致),并勾选“Can accept external connections”。5. 创建或导入项目
New Project,选择PHP Empty Project(或根据需求选择其他模板),设置项目名称(如my_debian_project)和保存路径(如~/projects/my_debian_project),选择已配置的PHP解释器,点击Finish。Open,浏览至项目目录,选择项目根文件夹即可导入。6. 配置项目运行/调试
Run > Edit Configurations,点击+号添加PHP Web Page配置,设置:
Name:自定义配置名称(如My Project Debug);Start URL:项目入口URL(如http://localhost/my_debian_project/index.php);Debugger:选择Xdebug;Server:选择已配置的服务器(若未配置,需进入Languages & Frameworks > PHP > Servers添加,设置Name、Host(如localhost)、Port(如80)、Debugger(Xdebug))。Shift+F10)运行项目;若需调试,点击左侧的电话图标(Debug模式),然后在代码中设置断点,刷新浏览器页面即可触发调试。7. 可选优化:提升开发体验
File > Settings > Plugins,搜索并安装常用插件(如Chinese (Simplified) Language Pack(中文支持)、Git Integration(版本控制)、Database Tools(数据库管理)),重启PhpStorm生效。/opt/phpstorm/bin/phpstorm.vmoptions文件,调整-Xms(初始内存)和-Xmx(最大内存)参数(如-Xms1024m -Xmx2048m),保存后重启。VCS > Enable Version Control Integration,选择Git,然后通过Git > Commit Directory提交代码,或使用Git > Repository进行分支管理。