http://confluence.jetbrains.com/display/PhpStorm/Built-in+REST+Client+in+PhpStorm

建立一个REST API？需要测试对Web应用程序的调用？在构建基于REST的Web API时，值得拥有一个可用于调用和测试的工具，以查看对我们的请求的响应。在本教程中，我们将看看PhpStorm中的内置REST客户端。

创建一个HTTP请求
- 生成授权标题
- 饼干
重新使用请求
- 最近的请求
- 导入和导出请求重新使用
配置代理设置

创建一个HTTP请求

REST客户端可以在Tools |下找到 测试REST风格的Web服务菜单。它打开一个新的工具窗口，我们可以创建HTTP请求，我们可以调用并检查结果。

在REST Client工具窗口中，我们可以指定HTTP方法，要连接的主机和端口（IP地址或主机名，本地和Internet），我们要发送请求的路径，标题，请求参数和请求体。现在我们跳过所有这些，并创建一个GET请求到“http://www.google.com”。请注意，如果我们想要发送cookie，我们可以在Cookies选项卡中制作这些cookie。

当我们点击工具栏中的运行按钮（或者按下Ctrl + Enter）时，请求将被执行，响应标签将会打开。在那里，我们可以看到响应正文为HTML，XML，JSON或“原始”，没有任何格式。我们也可以将其导出到一个文件或在浏览器中打开它。

以下是返回JSON的响应示例：

“ Cookies”选项卡向我们显示远程服务器返回的所有Cookie的密钥和值。这些cookie可以被修改或删除，并在随后的请求中被发送到服务器。

如果我们对响应标题感兴趣，我们可以在响应标题选项卡中看到。

生成授权标题

有些端点将需要授权。我们可以在构建我们的请求时手动添加授权标头。例如，在使用需要OAuth载体令牌的服务时，我们可以将其添加到我们的请求中：

对于基本身份验证，PhpStorm可以为我们生成头文件。单击工具栏中的“ 生成授权标题”图标可让我们输入IDE将为其生成基本身份验证标头的用户名和密码。

饼干

正如我们在前面的例子中看到的那样，远程服务器返回的cookie将在Cookies选项卡下可见，并且可以被编辑。如果需要测试服务，我们也可以添加我们自己的cookie值。

单击+图标或按Alt + Insert（Mac OS X上的CMD + N）将添加一个新的cookie条目，我们可以在其中提供：

Cookie的名称
cookie的价值
该cookie有效的域
Cookie的有效路径
cookie的有效期限

当我们的REST服务要求存在特定的cookie或使用cookie来了解会话数据时，这非常方便。

图标

内置REST客户端支持创建cookie并从服务器响应中添加cookie的事实在创建针对使用会话的服务器的请求时非常有用。例如，当一个基于PHP的端点使用session_start（），然后利用会话数据时，标识用户的cookie将被存储起来，并在随后的请求中发送回服务器。

重新使用请求

PhpStorm在打开时会跟踪使用内置REST客户端发出的请求。先前执行的请求可以再次运行，我们也可以导入/导出请求。

导入和导出请求重新使用

每个通过内置REST客户端创建的HTTP请求都可以在稍后导出和导入。这使我们能够在需要的时候创建一系列可以在开发过程中使用的HTTP请求。创建一次，导出和重用。导出HTTP请求可以从工具栏完成。

请求存储在一个XML文件中，我们可以编辑，如果需要的话。我们也可以将这些导出的请求添加到VCS，以便团队成员在开发或测试某些特定功能时可以从中受益。以下是一个导出的请求示例，用于查询JetBrains GitHub组织中是否包含单词“PhpStorm”的代码：

<RestClientRequest>
  <option name="biscuits">
    <list />
  </option>
  <option name="httpMethod" value="GET" />
  <option name="urlBase" value="https://api.github.com" />
  <option name="urlPath" value="/search/code" />
  <option name="headers">
    <list>
      <KeyValuePair>
        <option name="key" value="Accept" />
        <option name="value" value="application/json" />
      </KeyValuePair>
      <KeyValuePair>
        <option name="key" value="Cache-Control" />
        <option name="value" value="no-cache" />
      </KeyValuePair>
    </list>
  </option>
  <option name="parameters">
    <list>
      <KeyValuePair>
        <option name="key" value="q" />
        <option name="value" value="PhpStorm user:jetbrains" />
      </KeyValuePair>
    </list>
  </option>
  <option name="parametersEnabled" value="true" />
  <option name="haveTextToSend" value="false" />
  <option name="haveFileToSend" value="false" />
  <option name="isFileUpload" value="false" />
  <option name="textToSend" value="" />
  <option name="filesToSend" value="" />
</RestClientRequest>