为什么参数名称是 $accessToken？答案

【问题标题】：Why the param name is $accessToken?为什么参数名称是 $accessToken？
【发布时间】：2012-06-13 16:33:42
【问题描述】：

Drive SDK 的开发者 - 或者一般来说，OAuth2.0 PHP 客户端库！

在apiClient.php中有一个setAccessToken函数：

  public function setAccessToken($accessToken) {
    if ($accessToken == null || 'null' == $accessToken) {
      $accessToken = null;
    }
    self::$auth->setAccessToken($accessToken);
  }

这个函数的@param是这样的：

{"access_token":"TOKEN", "refresh_token":"TOKEN", "token_type":"Bearer",
        "expires_in":3600, "id_token":"TOKEN", "created":1320790426}

如果访问令牌只是此 JSON 编码字符串的一部分，为什么要将此参数命名为 $accessToken？？

我认为这非常具有误导性。

当我们深入查看：$auth->setAccessToken($accessToken); in apiOAuth2.php 我们看到：

  public function setAccessToken($accessToken) {
    $accessToken = json_decode($accessToken, true);
    if ($accessToken == null) {
      throw new apiAuthException('Could not json decode the access token');
    }
    if (! isset($accessToken['access_token'])) {
      throw new apiAuthException("Invalid token format");
    }
    $this->accessToken = $accessToken;
  }

查看第二个如果：$accessToken['access_token']。这有什么意义？ accessToken 中的访问令牌 ?? :)

您应该将这些函数的 $accessToken 参数（整个 JSON 字符串）命名为 $credentials 或其他名称，因为它有点模糊......但如果我错了，请告诉我。

【问题讨论】：

虽然是一个合理的问题，但这正是应该在特定于您所询问的库的论坛中提出的问题。
您会在 PHP 客户端库support forum 上找到更好的帮助来询问相同的问题。

标签： google-drive-api

【解决方案1】：

正如一些 cmets 提到的，我将在 Google APIs PHP 客户端库表单上发布此内容：https://groups.google.com/forum/?fromgroups#!forum/google-api-php-client 或者在他们的问题跟踪器上提交问题：http://code.google.com/p/google-api-php-client/issues/list

这将确保从事 PHP 客户端库的工程师知道这一点。

你说得对，这很有意义:)

【讨论】：