PhpStorm 2025.2 Help

在项目中配置 PHP 命名空间

PhpStorm 支持 PSR-0/PSR-4 自动加载标准,该标准规定 PHP 中的命名空间名称应映射到目录结构。 在 PhpStorm 中标记为 Source root type 的目录被视为命名空间的根目录,在其下创建的每个目录都被视为单独的命名空间。

当设置了 Source 根类型时,PhpStorm 会在您创建新类/接口等时自动补全命名空间名称。 在此目录中。 对于不符合 PSR-0/PSR-4 项目结构的命名空间名称,IDE 会在编辑器中显示检查警告。

自动检测命名空间根目录

如果您使用 Composer 管理 PSR-0/PSR-4 自动加载,PhpStorm 会根据 composer.json 文件的内容在打开项目时自动将目录标记为 Source

如果项目中没有包含 "autoload" 部分的 composer.json 文件,PhpStorm 会检测到至少一个带有命名空间的文件,并通过显示通知消息提示您设置命名空间根目录。 如果尚未配置命名空间根目录,当您创建新类时,PhpStorm 会提示您配置命名空间根目录。

您还可以通过从主菜单中选择 代码 | 检测 PSR-0 命名空间根 来触发命名空间根目录的自动检测。 打开的 目录 对话框显示了项目根文件夹下的文件夹,其中项目根文件夹被标记为 Source ,这意味着它是其中所有命名空间的根目录。 通过单击 确定 接受设置,或 手动配置命名空间根目录

手动配置命名空间根目录

  1. 设置 对话框 (Ctrl+Alt+S) 中,前往 目录

  2. 打开的 目录 页面右侧窗格显示了项目中配置的所有 内容根目录。 通常情况下,只有一个内容根目录,即当前项目的根文件夹。

    中央窗格显示了所选内容根目录下的所有文件夹。 选择要作为命名空间根目录的文件夹,然后单击

    配置多个源根目录完全没有问题:PhpStorm 会将每个源根目录视为命名空间根目录,并为其下的文件提供命名空间提示。 例如,vendor 文件夹的每个子文件夹都可以标记为命名空间根目录。 在下面的示例中,我们有两个命名空间根目录:一个用于实际应用程序,一个用于 vendor 文件夹:

    配置命名空间根目录
  3. 要根据 PSR-4 配置命名空间前缀,请单击相关源文件夹(命名空间根目录)旁边的 “编辑属性”按钮 ,并在 编辑根属性 对话框中指定要使用的前缀。 要将前缀应用于自动生成的代码,请选中 对于生成的源 复选框。

    重命名命名空间根目录
最后修改日期: 2025年 9月 26日