PhpStorm 2025.2 Help

导入现有项目

您可以围绕在其他 IDE 或专用编辑器中创建的现有源代码设置一个 PhpStorm 项目。 PhpStorm 会分析代码库并向其中添加一个 .idea 目录及其设置。

打开项目(简单导入)

如果您现在不打算在项目中使用 Web 服务器,您可以直接打开包含项目文件的文件夹。 此选项将所选项目按原样导入到 PhpStorm 中(打开它)。

  1. 启动 PhpStorm。

    如果“欢迎”屏幕打开,请点击 打开

    否则,请转到主菜单中的 文件 | 打开

  2. 在打开的对话框中,选择包含您的源代码、库和其他资产的目录,然后点击 打开

  3. 如果您正在处理另一个项目,请选择是否要在新对话框中打开新项目或在当前对话框中打开。

设置 Web 服务器并从中导入项目文件

如果除了源文件外,您还配置了用于应用程序部署的 Web 服务器,请使用 从现有文件创建新项目 向导来设置您的 PhpStorm 项目。 该向导涵盖了与不同源文件位置和服务器配置(原地、本地或远程 )对应的不同场景,并引导您配置 项目根目录下的文件夹

Web 服务器安装在本地,源文件位于其文档根目录下

  1. 请选择 文件 | 从现有文件新建项目 从主菜单。

  2. 选择您的场景页面 上,选择 Web 服务器安装在本地,源文件位于其文档根目录下 并单击 下一个

  3. 选择项目目录页面 上,选择存储源文件的文件夹,然后单击工具栏上的 项目图标 图标,或从所选内容的上下文菜单中选择 项目根目录 ,将该文件夹指定为 项目根目录。 PhpStorm 使用 项目图标 图标标记所选文件夹。

  4. 配置项目根目录下的文件夹。 或者,您可以稍后在 设置Ctrl+Alt+S )|目录 中进行配置。 点击 下一个

  5. 指定本地服务器页面 上,指定要使用的 服务器访问配置。 有关更多信息,请参阅 连接到 Web 服务器

    请执行以下操作之一:

    • 选择 使用现有服务器 并从列表中选择相关的服务器配置。 列表中仅包含标记为 icon_inplace_server.png原地 类型的配置,因为您的文件已经位于服务器文档根目录下。

    • 选择 添加新的本地服务器 ,单击 下一个 ,并在打开的 添加本地服务器页面 上定义一个新的服务器访问配置:

      1. 名称 字段中指定服务器配置名称。 PhpStorm 本身会将配置类型设置为 原地

      2. Web 服务器 URL(W) 字段中,输入与服务器配置文件中定义的 文档根目录 相关联的 URL 地址。 此 URL 地址将是构建您的应用程序 URL 地址的起点。

        同时支持 HTTPHTTPS

        例如,默认的 文档根目录 设置为 htdocs 文件夹,访问其中数据的默认 URL 地址为 http://localhost 。 如果您更改了默认端口 80 ,则必须明确指定端口: http://localhost:<port>

        请点击 下一个 完成准备。

      3. 指定 Web 路径页面 上,指定访问项目根文件夹的 URL 地址。 在 项目根目录的 Web 路径 字段中,输入相对于服务器配置文件中指定的服务器文档根目录的项目根文件夹路径。 在输入时,PhpStorm 会动态构建 URL 地址,并在 项目 URL 只读字段中显示为链接。 要检查 URL 地址是否构造正确并确保可以访问项目根目录,请单击该链接。

      有关更多信息,请参见 创建就地服务器配置

  6. 单击 创建 并指定项目窗口的打开选项。

Web 服务器安装在本地,源文件位于本地其他位置

  1. 请选择 文件 | 从现有文件新建项目 从主菜单。

  2. 选择您的场景页面 上,选择 Web 服务器安装在本地,源文件位于本地其他位置 并单击 下一个

  3. 指定本地路径页面 上,指定 项目根目录。 指定存储源文件和创建项目的文件夹。

  4. 指定服务器 页面上,指定 服务器访问配置 以启用与服务器的交互。 有关更多信息,请参阅 连接到 Web 服务器

    请执行以下操作之一:

    • 选择 使用现有服务器 并从列表中选择相关的服务器配置。 列表中仅包含标记为 icon_local_server.png本地 类型的配置,因为您的文件存储在本地计算机上但位于服务器文档根目录下,因此 原地 类型的配置不适用。

    • 选择 添加新的本地服务器 ,单击 下一个 ,并在打开的 添加服务器 页面上定义一个新的服务器访问配置:

      1. 名称 字段中指定服务器配置名称。 PhpStorm 本身会将配置类型设置为 本地

      2. 文件夹 字段的 上传/下载项目文件 区域中,指定服务器配置文件中定义的服务器文档根目录的绝对路径。 除了文档根目录本身之外,您还可以指定文档根目录下的任何其他现有文件夹。

        文档根目录是 Web 服务器将文件提供给 Web 服务器 URL 的文件夹。

      3. Web 服务器 URL 字段的 浏览服务器上的文件 区域中,输入映射到服务器配置文件中服务器文档根目录的 URL 地址(主机名和(可选)端口)。 这是您的应用程序网址的基础 URL。 支持 HTTPHTTPS

        请点击 浏览 在字段右上角以打开并检查提供的 Web 服务器 URL。

        点击 下一个

      有关更多信息和示例,请参阅 创建本地服务器配置

  5. 创建新项目:选择远程路径 页面上,在服务器上创建一个文件夹,PhpStorm 将把项目文件上传到该文件夹。 此文件夹称为 服务器上的项目根目录 ,并将自动映射到您的 项目根目录

    页面显示了指定的 服务器配置根目录 下的文件夹树。 选择相关的父文件夹,并在上下文菜单中选择 创建文件夹。 当新文件夹出现在树中时,选择它并单击工具栏上的 project_icon.png 图标,或在所选内容的上下文菜单中选择 项目根目录。 PhpStorm 使用 project_icon.png 图标标记所选文件夹。

    配置项目根目录下的文件夹。 或者,您可以稍后在 设置Ctrl+Alt+S )|目录 中进行配置。 点击 下一个

  6. 指定 Web 路径页面 上,指定访问您在上一步中指定的 服务器上的项目根文件夹 的 URL 地址。 在 项目根目录的 Web 路径 字段中,输入相对于 服务器配置根目录 的文件夹路径。 实际上,在 服务器上的项目根目录 字段中输入相对路径。 在输入时,PhpStorm 会动态构建 URL 地址,并在 项目 URL 只读字段中显示为链接。

  7. 单击 创建 并指定项目窗口的打开选项。

Web 服务器位于远程主机上,文件可通过网络共享或挂载驱动器访问

  1. 请选择 文件 | 从现有文件新建项目 从主菜单。

  2. 选择您的场景 页面上,选择 Web 服务器位于远程主机上,可以通过网络共享或挂载驱动器访问文件(S)。 并单击 下一个

  3. 创建新项目:指定本地路径 页面上,指定要设置的项目名称和下载项目源文件的本地文件夹,然后单击 下一个

  4. 选择现有服务器或单击 添加远程服务器 打开 创建新项目:添加远程服务器 页面。 在此页面上,指定新服务器的参数并单击 下一个

  5. 创建新项目:选择远程路径 页面上,在服务器上创建一个文件夹,PhpStorm 将把项目文件上传到该文件夹。 此文件夹称为 服务器上的项目根目录 ,并将自动映射到您的 项目根目录。 点击 下一个

  6. 指定 Web 路径页面 上,指定访问您在上一步中指定的 服务器上的项目根文件夹 的 URL 地址。 在 项目根目录的 Web 路径 字段中,输入相对于 服务器配置根目录 的文件夹路径。 实际上,在 服务器上的项目根目录 字段中输入相对路径。 在输入时,PhpStorm 会动态构建 URL 地址,并在 项目 URL 只读字段中显示为链接。

  7. 单击 创建 并指定项目窗口的打开选项。

Web 服务器位于远程主机上,文件可通过 FTP/SFTP/FTPS/WebDAV 访问

  1. 请选择 文件 | 从现有文件新建项目 从主菜单。

  2. 选择您的场景 页面上,选择 Web 服务器位于远程主机上,可通过 FTP/SFTP/FTPS/WebDAV 访问文件(F)。 并单击 下一个

  3. 创建新项目:指定本地路径 页面上,指定要设置的项目名称和下载项目源文件的本地文件夹,然后单击 下一个

  4. 选择现有服务器或单击 添加远程服务器 打开 创建新项目:添加远程服务器 页面。 在此页面上,指定新服务器的参数并单击 下一个

  5. 创建新项目:选择远程路径 页面上,在服务器上创建一个文件夹,PhpStorm 将把项目文件上传到该文件夹。 此文件夹称为 服务器上的项目根目录 ,并将自动映射到您的 项目根目录。 点击 下一个

  6. 指定 Web 路径页面 上,指定访问您在上一步中指定的 服务器上的项目根文件夹 的 URL 地址。 在 项目根目录的 Web 路径 字段中,输入相对于 服务器配置根目录 的文件夹路径。 实际上,在 服务器上的项目根目录 字段中输入相对路径。 在输入时,PhpStorm 会动态构建 URL 地址,并在 项目 URL 只读字段中显示为链接。

  7. 单击 创建 并指定项目窗口的打开选项。

源文件位于本地目录中,尚未配置 Web 服务器

  1. 请选择 文件 | 从现有文件新建项目 从主菜单。

  2. 选择您的场景页面 上,选择 源文件位于本地目录中,尚未配置 Web 服务器 并单击 下一个

  3. 选择项目目录页面 上,选择存储源文件的文件夹,然后单击工具栏上的 项目图标 图标,或从所选内容的上下文菜单中选择 项目根目录 ,将该文件夹指定为 项目根目录。 PhpStorm 使用 项目图标 图标标记所选文件夹。

  4. 配置项目根目录下的文件夹。 或者,您可以稍后在 设置Ctrl+Alt+S )|目录 中进行配置。

  5. 单击 创建 并指定项目窗口的打开选项。

最后修改日期: 2025年 9月 26日