在 Ubuntu 中查看 PhpStorm 日志
一 查看 PhpStorm IDE 自身日志
- 在 IDE 内打开:依次点击 Help → Show Log in Explorer(在 Ubuntu 会打开文件管理器,定位到日志文件),主日志为 idea.log。也可在设置中搜索 Registry,开启 idea.log.debug 获取更详细输出。
- 在终端查看:日志目录通常为 ~/.PhpStorm<版本号>/system/log/,主日志文件为 idea.log。常用命令:
- 实时查看:
tail -f ~/.PhpStorm<版本号>/system/log/idea.log
- 打开目录:
nautilus ~/.PhpStorm<版本号>/system/log/(或 xdg-open)
- 旧版本或自定义配置路径:若使用 .WebIdeXX 目录,日志同样在 ~/.WebIdeXX/system/log/idea.log。
- 插件相关日志:位于 ~/.PhpStorm<版本号>/config/plugins/ 下对应插件的目录内(如有)。
以上路径与操作方式与 JetBrains 系列 IDE 一致,Ubuntu 下可直接使用。
二 查看 Ubuntu 系统及 Web 服务相关日志
- 系统日志:
- 实时查看系统日志:
tail -f /var/log/syslog
- 认证日志:
tail -f /var/log/auth.log
- 内核日志:
tail -f /var/log/kern.log 或 dmesg -T
- Web/PHP 服务日志:
- Apache:
/var/log/apache2/error.log、/var/log/apache2/access.log
- Nginx:
/var/log/nginx/error.log、/var/log/nginx/access.log
- PHP-FPM:常见为 /var/log/php<版本>-fpm.log(如 /var/log/php7.4-fpm.log;具体以
php.ini 的 error_log 配置为准)
- 使用 journalctl 查看服务日志(适用于使用 systemd 管理的服务):
- 例如:
journalctl -u apache2.service -f、journalctl -u php<版本>-fpm.service -f
这些路径与命令适用于 Ubuntu 常见的日志布局与工具链。
三 在 PhpStorm 中直接打开并跟踪日志文件
- 打开文件:在 PhpStorm 中使用 Ctrl+Shift+N(Navigate → File)输入日志完整路径(如 /var/log/syslog 或 ~/.PhpStorm2024.3/system/log/idea.log)。
- 跟踪实时输出:打开日志后,使用 Ctrl+Shift+F 调出“Find in Path”或在终端
tail -f 观察;也可借助 File Watchers 对日志变更做高亮或自动滚动(需自行配置)。
- 快速定位日志路径:若不确定 php.ini 中 error_log 的位置,可在项目内临时写入:
error_log('test', 3, '/tmp/debug.log');
然后在 PhpStorm 中直接打开 /tmp/debug.log 查看。
四 常见问题与排查建议
- 权限不足无法读取系统日志:将当前用户加入 adm 组(日志文件常见属组为 syslog:adm),或以 sudo 查看,例如
sudo tail -f /var/log/syslog。
- 找不到 PHP-FPM 日志:检查 php.ini 的 error_log 配置;若为 FPM 模式,日志通常在 /var/log/php<版本>-fpm.log,也可用
journalctl -u php<版本>-fpm 查看。
- IDE 日志目录不存在或被移动:在 PhpStorm 中通过 Help → Edit Custom Properties 检查或设置 idea.log.path;若使用 idea.properties 自定义了 idea.config.path / idea.system.path / idea.plugins.path,日志会随配置目录变更。