在 Ubuntu 上使用 PhpStorm 进行代码分析
一 环境准备与 PHP 解释器配置
- 安装 PHP(CLI 与 FPM 任选其一或同时安装),并确认版本:
- 命令:sudo apt update && sudo apt install php php-cli php-fpm
- 验证:php -v
- 在 PhpStorm 中设置解释器:
- 打开 File → Settings → Languages & Frameworks → PHP,点击右上角齿轮选择 Add,添加 PHP Executable(如 /usr/bin/php)。这一步为后续静态分析、单元测试、Composer 等提供语言环境。
二 静态代码分析与规范检查
- 安装与集成 PHP_CodeSniffer(PHPCS):
- 系统包安装:sudo apt-get install php-codesniffer
- 或 Composer 全局安装:composer global require “squizlabs/php_codesniffer=*”
- 在 PhpStorm:File → Settings → Languages & Frameworks → PHP → Quality Tools → Code Sniffer,将 PHP Code Sniffer (phpcs) 的路径设置为可执行文件(常见为 /usr/bin/phpcs 或 ~/.config/composer/vendor/bin/phpcs)。
- 启用实时检查与规范选择:
- 在 PhpStorm:File → Settings → Editor → Inspections → Quality Tools → PHP Code Sniffer validation,勾选启用,并在右侧选择规范(如 PSR2/PSR12)。保存后编辑器会实时标出不符合规范的代码。
三 调试与运行时分析 Xdebug 3
- 安装 Xdebug(适配你的 PHP 版本,如 php8.1):
- 命令:sudo apt-get install php8.1-xdebug
- 配置 php.ini(注意 CLI 与 FPM 可能分别有配置,路径如 /etc/php/8.1/cli/php.ini 与 /etc/php/8.1/fpm/php.ini):
- 重启服务:
- Web:sudo systemctl restart apache2 或 sudo systemctl restart nginx
- PHP-FPM:sudo systemctl restart php8.1-fpm
- PhpStorm 调试设置:
- File → Settings → Languages & Frameworks → PHP → Servers 新增服务器(如 localhost,端口 80/443),Debugger 选 Xdebug。
- Run → Edit Configurations 新建 PHP Web Page,选择服务器与起始 URL,点击调试即可联动断点、变量查看与单步执行。
四 性能优化让分析更顺畅