PhpStorm教程

2026-10-13 0 次查看

PhpStorm教程的核心是带你从新建项目到调试运行，掌握日常开发中最常用的操作流程，而不是罗列所有功能。

  1. 新建项目与导入现有代码
    打开 PhpStorm 后，在欢迎界面点击「New Project」即可创建新项目。选择项目类型时，如果只是纯 PHP 脚本，选「Empty Project」再手动添加文件；如果有框架（如 Laravel、Symfony），建议用 Composer 创建项目后再用「Open」打开目录。导入现有代码时，直接 File → Open 选择项目根目录，PhpStorm 会自动识别项目结构并建立索引。首次打开大型项目时索引会持续几分钟，属正常现象，期间代码提示可能不完整，等索引完成后即可正常使用。
  2. 配置 PHP 解释器与运行环境
    要让 PhpStorm 能运行和调试 PHP 代码，必须配置 PHP 解释器。打开 Settings（Windows/Linux 是 File → Settings，macOS 是 PhpStorm → Preferences），在 Languages & Frameworks → PHP 中点击 CLI Interpreter 旁的「...」按钮。如果本机已安装 PHP，选择「Local Path to Interpreter」并指向 php.exe（Windows）或 php（macOS/Linux）；如果没装，可以用「Remote」方式连接 Docker 或 SSH 上的 PHP 环境。配置完成后，在编辑器中右键选择「Run」即可运行当前脚本，输出会显示在底部的 Run 工具窗口。
  3. 常用快捷键与代码编辑技巧
    PhpStorm 的快捷键能大幅提升编码效率。最常用的有：Ctrl+Shift+F10 运行当前文件（macOS 是 Ctrl+Shift+R），Ctrl+P 查看函数参数，Ctrl+Q 查看文档，Shift+Shift 全局搜索。代码补全默认是自动触发的，输入类名或函数名时按 Ctrl+Space 可手动呼出。多光标编辑用 Alt+鼠标点击（macOS 是 Option+点击），可以同时修改多处。格式化代码用 Ctrl+Alt+L（macOS 是 Option+Cmd+L），重构重命名用 Shift+F6，会自动同步所有引用。建议在 Settings → Keymap 中查看完整快捷键列表，也可以下载自己喜欢的键位方案。
  4. 调试 PHP 代码（Xdebug 配置）
    调试是 PhpStorm 的重要功能。首先确保 PHP 环境安装了 Xdebug 扩展，可以在 Settings → Languages & Frameworks → PHP → Debug 中检查。然后配置一个调试服务器：在 Settings → Languages & Frameworks → PHP → Servers 中点击「+」，填写主机名和端口（默认 80），并勾选「Use path mappings」。接着点击工具栏上的电话图标（Start Listening for PHP Debug Connections），在代码中设置断点（点击行号右侧空白处），最后用浏览器访问带调试参数的 URL（如 ?XDEBUG_SESSION_START=1）或使用 IDE 内置的调试运行按钮，程序会在断点处暂停，你可以查看变量值、单步执行。如果断点没有触发，检查 Xdebug 的配置是否正确，以及 PhpStorm 的调试监听是否开启。
  5. 使用 Composer 与版本控制
    PhpStorm 内置了 Composer 支持。在 Settings → Tools → Composer 中设置 Composer 可执行文件路径（如果本机没有，可以在项目根目录下载 composer.phar）。右键项目目录可以执行「Composer」菜单中的常用命令，如 install、update、dump-autoload。版本控制方面，PhpStorm 支持 Git、SVN 等。如果你的项目已经用 Git 管理，打开后会自动识别，底部会出现 Git 工具栏。提交代码用 Ctrl+K（macOS 是 Cmd+K），查看历史用 Ctrl+Alt+C（macOS 是 Option+Cmd+C）。在 Settings → Version Control 中配置默认的 VCS 工具，可以方便地进行分支切换、合并和冲突解决。

软件页面：PhpStorm。