Issues in GMail.php (master) - Issues in master - francis94c/ci-gmail - Measure and Improve Code Quality continuously with Scrutinizer

Issues (42)

libraries/GMail.php (8 issues)

Labels

Severity

Minor 8

<?php
declare(strict_types=1);
defined('BASEPATH') OR exit('No direct script access allowed');

class GMail {

  const AUTH_URL  = 'https://accounts.google.com/o/oauth2/auth';
  const TOKEN_URL = 'https://www.googleapis.com/oauth2/v4/token';
  const API       = 'https://www.googleapis.com/gmail/v1/users/';
  const HTTP_CODE = 'http_code';
  const PACKAGE   = 'francis94c/ci-gmail';
  private $clientId;
  private $clientSecret;
  private $redirectUri = 'urn:ietf:wg:oauth:2.0:oob';
  private $token;
  private $userAgent = 'CodeIgniter GMail API';
  private $lastResponse;
  private $lastResponseCode;

  function __construct($params=null)
  {
    get_instance()->load->splint('francis94c/ci-gmail', '%curl');
    get_instance()->load->splint('francis94c/ci-gmail', '%base64');

    if ($params != null) $this->init($params);

    spl_autoload_register(function($name) {
      if (file_exists(APPPATH.'splints/'.self::PACKAGE."/libraries/$name.php")) {
        require(APPPATH.'splints/'.self::PACKAGE."/libraries/$name.php");
      }
    });
  }

  /**
   * [init Initialize library with cofigs. Can be called multiple times to set
   *       config items]
   * @param array $config Associative Config Array.
   */
  public function init(array $config):void {
    $this->clientId = $config['client_id'] ?? $this->clientId;
    $this->clientSecret = $config['client_secret'] ?? $this->clientSecret;
    $this->redirectUri = $config['redirect_uri'] ?? $this->redirectUri;
  }
  /**
   * [setAccessToken description]
   * @param string $token [description]
   */
  public function setAccessToken(string $token):void {
    $this->token = $token;
  }
  /**
   * [getClientId Get Client ID.]
   * @return null|string Client ID.
   */
  public function getClientId():?string {
    return $this->clientId;
  }
  /**
   * [getAuthorizeUrl Gets/composes the authorize url to direct users to so they
   *                  can give your application access to their GMail accounts
   *                  based on the given scopes.]
   * @param  string $scope        Access Scope.
   * @param  string $redirectUri  URL to redirect to after access is granted.
   * @param  string $responseType Response type. 'code' by default.
   * @param  bool   $prompt       Add the prompt=consent query to the URL.
   * @return string               Authorize URL
   */
  public function getAuthorizeUrl(string $scope, string $redirectUri=null,
  string $responseType='code', string $accessType='offline', bool $prompt=false):string
  {
    $redirectUri = $redirectUri ?? $this->redirectUri;
    if ($scope == null) throw new Exception("GMail scope cannot be null");
    $params = [
      'client_id'     => $this->clientId,
      'redirect_uri'  => $redirectUri,
      'scope'         => $scope,
      'response_type' => $responseType,
      'access_type'   => $accessType
    ];
    if ($prompt) $params['prompt'] = 'consent';
    return self::AUTH_URL . build_url_query($params, false);
  }
  /**
   * [getToken description]
   * @param  string $code [description]
   * @return [type]       [description]

   */
  public function getToken(string $code, string $redirectUri=null):?object
  {
    $redirectUri = $redirectUri ?? $this->redirectUri;
    $ch = curl_init(self::TOKEN_URL);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLINFO_HEADER_OUT, true);
    if (ENVIRONMENT == 'development') {
      curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
    }
    $body = http_build_query([
      'code'          => $code,
      'client_id'     => $this->clientId,
      'client_secret' => $this->clientSecret,
      'redirect_uri'  => $redirectUri,
      'grant_type'    => 'authorization_code'
    ]);
    $header = [
      'Content-Type: application/x-www-form-urlencoded',
      'Content-Length: ' . strlen($body)
    ];
    curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
    curl_setopt($ch, CURLOPT_USERAGENT, $this->userAgent);
    // Request Method and Body.
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
    $response = curl_exec($ch);
    $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    $this->lastResponse = $response;
    $this->lastResponseCode = $code;
    if ($response !== false) return $this->process_response($code, $response);
    return null;
  }
  /**
   * [refreshAccessToken description]
   * @param  string $refreshToken [description]
   * @return [type]               [description]

   */
  public function refreshAccessToken(string $refreshToken):?object
  {
    $ch = curl_init(self::TOKEN_URL);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLINFO_HEADER_OUT, true);
    if (ENVIRONMENT == 'development') {
      curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
    }
    $body = http_build_query([
      'refresh_token' => $refreshToken,
      'client_id'     => $this->clientId,
      'client_secret' => $this->clientSecret,
      'grant_type'    => 'refresh_token'
    ]);
    $header = [
      'Content-Type: application/x-www-form-urlencoded',
      'Content-Length: ' . strlen($body)
    ];
    curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
    curl_setopt($ch, CURLOPT_USERAGENT, $this->userAgent);
    // Request Method and Body.
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
    // Exec.
    $response = curl_exec($ch);
    $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    $this->lastResponse = $response;
    $this->lastResponseCode = $code;
    if ($response !== false) return $this->process_response($code, $response);
    return null;
  }
  /**
   * [getProfile Get user's profile
   * see https://developers.google.com/gmail/api/v1/reference/users/getProfile]
   * @param  string $user [description]
   * @return [type]       [description]

   */
  public function getProfile(string $user='me'):?object
  {
    list($code, $response) = (new GMailCURL(GMailCURL::GET))(
      self::API . "$user/profile",
      ["Authorization: Bearer $this->token"]
    );
    $this->lastResponse = $response;
    $this->lastResponseCode = $code;
    if ($response !== false) return $this->process_response($code, $response);
    return null;
  }

  /**
   * [watch Causes push notifications to be sent on events which occur in the
   * user's mailbox. Requires Google Cloud PubSub.
   * see https://developers.google.com/gmail/api/v1/reference/users/watch]
   * @param  string $topic             Topic to push events to.
   * @param  mixed  $labelIds          Narrow down labels in the mailbox, whose
   *                                   mailbox event, are being listened to.
   *                                   events are to be listened to.
   * @param  string $userId            The ID/Email address of the user.
   * @param  string $labelFilterAction [description]
   * @return [type]                    [description]

   */
  public function watch(string $topic, $labelIds=null, string $userId='me',
  string $labelFilterAction='include'):?object
  {
    $body = [
      'topicName'         => $topic,
      'labelFilterAction' => $labelFilterAction
    ];

    if ($labelIds != null) {
      if (is_scalar($labelIds)) {
        $body['labelIds'] = [$labelIds];
      } elseif (is_array($labelIds)) {
        $body['labelIds'] = $labelIds;
      }
    }

    list($code, $response) = (new GMailCURL(GMailCURL::POST))(
      self::API . "$userId/watch",
      ["Authorization: Bearer $this->token"],
      $body
    );
    $this->lastResponse = $response;
    $this->lastResponseCode = $code;
    if ($response !== false) return $this->process_response($code, $response);
    return null;
  }

  /**
   * [endWatch stop watch operations on given email ID]
   * @date   2019-11-20
   * @param  string     $userId ID or Email Address of the user.
   * @return bool               [description]
   */
  public function endWatch(string $userId='me'):bool
  {
    list($code, $response) = (new GMailCURL(GMailCURL::POST))(
      self::API . "$userId/stop",
      ["Authorization: Bearer $this->token"]
    );
    $this->lastResponse = $response;
    $this->lastResponseCode = $code;
    if ($response !== false) return $code == 204;
    return false;
  }

  /**
   * [getLabels description]
   * @date   2019-11-20
   * @param  string     $userID [description]
   * @return null|array         [description]
   */
  public function getLabels(string $userId='me'):?array
  {
    list($code, $response) = (new GMailCURL(GMailCURL::GET))(
      self::API . "$userId/labels",
      ["Authorization: Bearer $this->token"]
    );
    $this->lastResponse = $response;
    $this->lastResponseCode = $code;
    if ($response !== false) {
      return json_decode($response)->labels;
    }
    return null;
  }
  /**
   * [getMessages description]
   * @date   2019-11-21
   * @param  string     $userId           [description]
   * @param  [type]     $labelIds         [description]

   * @param  [type]     $q                [description]
   * @param  [type]     $maxMessages      [description]
   * @param  [type]     $pageToken        [description]
   * @param  boolean    $includeSpamTrash [description]
   * @param  [type]     $truncateAfter    [description]
   * @return [type]                       [description]

   */
  public function getMessages(string $userId='me', array $labelIds=null,
  string $q=null, int $maxMessages=null, string $pageToken=null, bool $includeSpamTrash=false,
  $truncateAfter=null):?object
  {
    $query = [];

    if ($labelIds) $query['labelIds'] = $labelIds;
    if ($includeSpamTrash) $query['includeSpamTrash'] = $includeSpamTrash;
    if ($q) $query['q'] = $q;
    if ($pageToken) $query['pageToken'] = $pageToken;
    if ($maxMessages) $query['maxResults'] = $maxMessages;

    list($code, $response) = (new GMailCURL(GMailCURL::GET))(
      self::API . "$userId/messages" . build_url_query($query),
      ["Authorization: Bearer $this->token"]
    );

    $this->lastResponse = $response;
    $this->lastResponseCode = $code;

    if ($response !== false) {
      if ($truncateAfter != null && $code == 200) {
        $response = json_decode($response);
        if ($response->messages) {
          $response->messages = array_filter($response->messages, function ($e) use ($truncateAfter) {
            return strcmp($truncateAfter, $e->id) < 0;
          });
        }
        $response->{self::HTTP_CODE} = $code;
        return $response;
      }

      return $this->process_response($code, $response);
    }

    return null;
  }

  /**
   * [getLastMessageId description]
   * @date   2020-03-08
   * @return string|null [description]
   */
  public function getLastMessageId():?string
  {
    $messages = $this->getMessages();
    return $messages->messages[0]->id ?? null;
  }

  /**
   * [getMessage description]
   * @date   2019-11-21
   * @param  string       $userId          [description]
   * @param  string       $messageId       [description]
   * @param  string       $format          [description]
   * @param  [type]       $metadataHeaders [description]

   * @return Message|null                  [description]
   */
  public function getMessage(string $userId='me', string $messageId,
  string $format='full', array $metadataHeaders=null):?Message
  {
    $query = [];

    if ($format != 'full' && $format != null) $query['format'] = $format;
    if ($metadataHeaders != null) $query['metadataHeaders'] = $metadataHeaders;

    list($code, $response) = (new GMailCURL(GMailCURL::GET))(
      self::API . "$userId/messages/$messageId?" . http_build_query($query),
      ["Authorization: Bearer $this->token"]
    );

    $this->lastResponse = $response;
    $this->lastResponseCode = $code;

    if ($response !== false) return new Message($response);

    return null;
  }

  /**
   * [getLastResponse description]
   * @date   2020-03-07
   * @return string     [description]
   */
  public function getLastResponse():string
  {
    return $this->lastResponse;
  }

  /**
   * [getLastResponseCode description]
   * @date   2020-03-07
   * @return int        [description]
   */
  public function getLastResponseCode():int
  {
    return $this->lastResponseCode;
  }

  /**
   * [process_response description]
   * @param  int    $code     [description]
   * @param  string $response [description]
   * @return [type]           [description]

   */
  private function process_response(int $code, string $response):?object {
    $response = json_decode($response);
    $response->{self::HTTP_CODE} = $code;
    return $response;
  }
}


1			<?php
2			declare(strict_types=1);
3			defined('BASEPATH') OR exit('No direct script access allowed');
4
5			class GMail {
6
7			const AUTH_URL = 'https://accounts.google.com/o/oauth2/auth';
8			const TOKEN_URL = 'https://www.googleapis.com/oauth2/v4/token';
9			const API = 'https://www.googleapis.com/gmail/v1/users/';
10			const HTTP_CODE = 'http_code';
11			const PACKAGE = 'francis94c/ci-gmail';
12			private $clientId;
13			private $clientSecret;
14			private $redirectUri = 'urn:ietf:wg:oauth:2.0:oob';
15			private $token;
16			private $userAgent = 'CodeIgniter GMail API';
17			private $lastResponse;
18			private $lastResponseCode;
19
20			function __construct($params=null)
21			{
22			get_instance()->load->splint('francis94c/ci-gmail', '%curl');
23			get_instance()->load->splint('francis94c/ci-gmail', '%base64');
24
25			if ($params != null) $this->init($params);
26
27			spl_autoload_register(function($name) {
28			if (file_exists(APPPATH.'splints/'.self::PACKAGE."/libraries/$name.php")) {
29			require(APPPATH.'splints/'.self::PACKAGE."/libraries/$name.php");
30			}
31			});
32			}
33
34			/**
35			* [init Initialize library with cofigs. Can be called multiple times to set
36			* config items]
37			* @param array $config Associative Config Array.
38			*/
39			public function init(array $config):void {
40			$this->clientId = $config['client_id'] ?? $this->clientId;
41			$this->clientSecret = $config['client_secret'] ?? $this->clientSecret;
42			$this->redirectUri = $config['redirect_uri'] ?? $this->redirectUri;
43			}
44			/**
45			* [setAccessToken description]
46			* @param string $token [description]
47			*/
48			public function setAccessToken(string $token):void {
49			$this->token = $token;
50			}
51			/**
52			* [getClientId Get Client ID.]
53			* @return null\|string Client ID.
54			*/
55			public function getClientId():?string {
56			return $this->clientId;
57			}
58			/**
59			* [getAuthorizeUrl Gets/composes the authorize url to direct users to so they
60			* can give your application access to their GMail accounts
61			* based on the given scopes.]
62			* @param string $scope Access Scope.
63			* @param string $redirectUri URL to redirect to after access is granted.
64			* @param string $responseType Response type. 'code' by default.
65			* @param bool $prompt Add the prompt=consent query to the URL.
66			* @return string Authorize URL
67			*/
68			public function getAuthorizeUrl(string $scope, string $redirectUri=null,
69			string $responseType='code', string $accessType='offline', bool $prompt=false):string
70			{
71			$redirectUri = $redirectUri ?? $this->redirectUri;
72			if ($scope == null) throw new Exception("GMail scope cannot be null");
73			$params = [
74			'client_id' => $this->clientId,
75			'redirect_uri' => $redirectUri,
76			'scope' => $scope,
77			'response_type' => $responseType,
78			'access_type' => $accessType
79			];
80			if ($prompt) $params['prompt'] = 'consent';
81			return self::AUTH_URL . build_url_query($params, false);
82			}
83			/**
84			* [getToken description]
85			* @param string $code [description]
86			* @return [type] [description]
			0 ignored issues – show Documentation Bug introduced 2019-09-16 06:27 UTC by Report Bug Copy Issue Report Show Similar Issues like this The doc comment `[type]` at position `0` could not be parsed: Unknown type name '[' at position 0 in [type]. Loading history...
87			*/
88			public function getToken(string $code, string $redirectUri=null):?object
89			{
90			$redirectUri = $redirectUri ?? $this->redirectUri;
91			$ch = curl_init(self::TOKEN_URL);
92			curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
93			curl_setopt($ch, CURLINFO_HEADER_OUT, true);
94			if (ENVIRONMENT == 'development') {
95			curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
96			}
97			$body = http_build_query([
98			'code' => $code,
99			'client_id' => $this->clientId,
100			'client_secret' => $this->clientSecret,
101			'redirect_uri' => $redirectUri,
102			'grant_type' => 'authorization_code'
103			]);
104			$header = [
105			'Content-Type: application/x-www-form-urlencoded',
106			'Content-Length: ' . strlen($body)
107			];
108			curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
109			curl_setopt($ch, CURLOPT_USERAGENT, $this->userAgent);
110			// Request Method and Body.
111			curl_setopt($ch, CURLOPT_POST, true);
112			curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
113			$response = curl_exec($ch);
114			$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
115			curl_close($ch);
116			$this->lastResponse = $response;
117			$this->lastResponseCode = $code;
118			if ($response !== false) return $this->process_response($code, $response);
119			return null;
120			}
121			/**
122			* [refreshAccessToken description]
123			* @param string $refreshToken [description]
124			* @return [type] [description]
			0 ignored issues – show Documentation Bug introduced 2019-08-28 09:45 UTC by Report Bug Copy Issue Report Show Similar Issues like this The doc comment `[type]` at position `0` could not be parsed: Unknown type name '[' at position 0 in [type]. Loading history...
125			*/
126			public function refreshAccessToken(string $refreshToken):?object
127			{
128			$ch = curl_init(self::TOKEN_URL);
129			curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
130			curl_setopt($ch, CURLINFO_HEADER_OUT, true);
131			if (ENVIRONMENT == 'development') {
132			curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
133			}
134			$body = http_build_query([
135			'refresh_token' => $refreshToken,
136			'client_id' => $this->clientId,
137			'client_secret' => $this->clientSecret,
138			'grant_type' => 'refresh_token'
139			]);
140			$header = [
141			'Content-Type: application/x-www-form-urlencoded',
142			'Content-Length: ' . strlen($body)
143			];
144			curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
145			curl_setopt($ch, CURLOPT_USERAGENT, $this->userAgent);
146			// Request Method and Body.
147			curl_setopt($ch, CURLOPT_POST, true);
148			curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
149			// Exec.
150			$response = curl_exec($ch);
151			$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
152			curl_close($ch);
153			$this->lastResponse = $response;
154			$this->lastResponseCode = $code;
155			if ($response !== false) return $this->process_response($code, $response);
156			return null;
157			}
158			/**
159			* [getProfile Get user's profile
160			* see https://developers.google.com/gmail/api/v1/reference/users/getProfile]
161			* @param string $user [description]
162			* @return [type] [description]
			0 ignored issues – show Documentation Bug introduced 2019-08-24 22:31 UTC by Report Bug Copy Issue Report Show Similar Issues like this The doc comment `[type]` at position `0` could not be parsed: Unknown type name '[' at position 0 in [type]. Loading history...
163			*/
164			public function getProfile(string $user='me'):?object
165			{
166			list($code, $response) = (new GMailCURL(GMailCURL::GET))(
167			self::API . "$user/profile",
168			["Authorization: Bearer $this->token"]
169			);
170			$this->lastResponse = $response;
171			$this->lastResponseCode = $code;
172			if ($response !== false) return $this->process_response($code, $response);
173			return null;
174			}
175
176			/**
177			* [watch Causes push notifications to be sent on events which occur in the
178			* user's mailbox. Requires Google Cloud PubSub.
179			* see https://developers.google.com/gmail/api/v1/reference/users/watch]
180			* @param string $topic Topic to push events to.
181			* @param mixed $labelIds Narrow down labels in the mailbox, whose
182			* mailbox event, are being listened to.
183			* events are to be listened to.
184			* @param string $userId The ID/Email address of the user.
185			* @param string $labelFilterAction [description]
186			* @return [type] [description]
			0 ignored issues – show Documentation Bug introduced 2019-08-28 21:32 UTC by Report Bug Copy Issue Report Show Similar Issues like this The doc comment `[type]` at position `0` could not be parsed: Unknown type name '[' at position 0 in [type]. Loading history...
187			*/
188			public function watch(string $topic, $labelIds=null, string $userId='me',
189			string $labelFilterAction='include'):?object
190			{
191			$body = [
192			'topicName' => $topic,
193			'labelFilterAction' => $labelFilterAction
194			];
195
196			if ($labelIds != null) {
197			if (is_scalar($labelIds)) {
198			$body['labelIds'] = [$labelIds];
199			} elseif (is_array($labelIds)) {
200			$body['labelIds'] = $labelIds;
201			}
202			}
203
204			list($code, $response) = (new GMailCURL(GMailCURL::POST))(
205			self::API . "$userId/watch",
206			["Authorization: Bearer $this->token"],
207			$body
208			);
209			$this->lastResponse = $response;
210			$this->lastResponseCode = $code;
211			if ($response !== false) return $this->process_response($code, $response);
212			return null;
213			}
214
215			/**
216			* [endWatch stop watch operations on given email ID]
217			* @date 2019-11-20
218			* @param string $userId ID or Email Address of the user.
219			* @return bool [description]
220			*/
221			public function endWatch(string $userId='me'):bool
222			{
223			list($code, $response) = (new GMailCURL(GMailCURL::POST))(
224			self::API . "$userId/stop",
225			["Authorization: Bearer $this->token"]
226			);
227			$this->lastResponse = $response;
228			$this->lastResponseCode = $code;
229			if ($response !== false) return $code == 204;
230			return false;
231			}
232
233			/**
234			* [getLabels description]
235			* @date 2019-11-20
236			* @param string $userID [description]
237			* @return null\|array [description]
238			*/
239			public function getLabels(string $userId='me'):?array
240			{
241			list($code, $response) = (new GMailCURL(GMailCURL::GET))(
242			self::API . "$userId/labels",
243			["Authorization: Bearer $this->token"]
244			);
245			$this->lastResponse = $response;
246			$this->lastResponseCode = $code;
247			if ($response !== false) {
248			return json_decode($response)->labels;
249			}
250			return null;
251			}
252			/**
253			* [getMessages description]
254			* @date 2019-11-21
255			* @param string $userId [description]
256			* @param [type] $labelIds [description]
			0 ignored issues – show Documentation Bug introduced 2019-11-21 08:31 UTC by Report Bug Copy Issue Report Show Similar Issues like this The doc comment `[type]` at position `0` could not be parsed: Unknown type name '[' at position 0 in [type]. Loading history...
257			* @param [type] $q [description]
258			* @param [type] $maxMessages [description]
259			* @param [type] $pageToken [description]
260			* @param boolean $includeSpamTrash [description]
261			* @param [type] $truncateAfter [description]
262			* @return [type] [description]
			0 ignored issues – show Documentation Bug introduced 2019-08-24 15:55 UTC by Report Bug Copy Issue Report Show Similar Issues like this The doc comment `[type]` at position `0` could not be parsed: Unknown type name '[' at position 0 in [type]. Loading history...
263			*/
264			public function getMessages(string $userId='me', array $labelIds=null,
265			string $q=null, int $maxMessages=null, string $pageToken=null, bool $includeSpamTrash=false,
266			$truncateAfter=null):?object
267			{
268			$query = [];
269
270			if ($labelIds) $query['labelIds'] = $labelIds;
271			if ($includeSpamTrash) $query['includeSpamTrash'] = $includeSpamTrash;
272			if ($q) $query['q'] = $q;
273			if ($pageToken) $query['pageToken'] = $pageToken;
274			if ($maxMessages) $query['maxResults'] = $maxMessages;
275
276			list($code, $response) = (new GMailCURL(GMailCURL::GET))(
277			self::API . "$userId/messages" . build_url_query($query),
278			["Authorization: Bearer $this->token"]
279			);
280
281			$this->lastResponse = $response;
282			$this->lastResponseCode = $code;
283
284			if ($response !== false) {
285			if ($truncateAfter != null && $code == 200) {
286			$response = json_decode($response);
287			if ($response->messages) {
288			$response->messages = array_filter($response->messages, function ($e) use ($truncateAfter) {
289			return strcmp($truncateAfter, $e->id) < 0;
290			});
291			}
292			$response->{self::HTTP_CODE} = $code;
293			return $response;
294			}
295
296			return $this->process_response($code, $response);
297			}
298
299			return null;
300			}
301
302			/**
303			* [getLastMessageId description]
304			* @date 2020-03-08
305			* @return string\|null [description]
306			*/
307			public function getLastMessageId():?string
308			{
309			$messages = $this->getMessages();
310			return $messages->messages[0]->id ?? null;
311			}
312
313			/**
314			* [getMessage description]
315			* @date 2019-11-21
316			* @param string $userId [description]
317			* @param string $messageId [description]
318			* @param string $format [description]
319			* @param [type] $metadataHeaders [description]
			0 ignored issues – show Documentation Bug introduced 2019-11-22 08:42 UTC by Report Bug Copy Issue Report Show Similar Issues like this The doc comment `[type]` at position `0` could not be parsed: Unknown type name '[' at position 0 in [type]. Loading history...
320			* @return Message\|null [description]
321			*/
322			public function getMessage(string $userId='me', string $messageId,
323			string $format='full', array $metadataHeaders=null):?Message
324			{
325			$query = [];
326
327			if ($format != 'full' && $format != null) $query['format'] = $format;
328			if ($metadataHeaders != null) $query['metadataHeaders'] = $metadataHeaders;
329
330			list($code, $response) = (new GMailCURL(GMailCURL::GET))(
331			self::API . "$userId/messages/$messageId?" . http_build_query($query),
332			["Authorization: Bearer $this->token"]
333			);
334
335			$this->lastResponse = $response;
336			$this->lastResponseCode = $code;
337
338			if ($response !== false) return new Message($response);
339
340			return null;
341			}
342
343			/**
344			* [getLastResponse description]
345			* @date 2020-03-07
346			* @return string [description]
347			*/
348			public function getLastResponse():string
349			{
350			return $this->lastResponse;
351			}
352
353			/**
354			* [getLastResponseCode description]
355			* @date 2020-03-07
356			* @return int [description]
357			*/
358			public function getLastResponseCode():int
359			{
360			return $this->lastResponseCode;
361			}
362
363			/**
364			* [process_response description]
365			* @param int $code [description]
366			* @param string $response [description]
367			* @return [type] [description]
			0 ignored issues – show Documentation Bug introduced 2019-11-21 08:31 UTC by Report Bug Copy Issue Report Show Similar Issues like this The doc comment `[type]` at position `0` could not be parsed: Unknown type name '[' at position 0 in [type]. Loading history...
368			*/
369			private function process_response(int $code, string $response):?object {
370			$response = json_decode($response);
371			$response->{self::HTTP_CODE} = $code;
372			return $response;
373			}
374			}
375

francis94c / ci-gmail

Issues (42)

libraries/GMail.php (8 issues)

Labels

Severity

Introduced By

Duplication Side-by-Side

Filter issues like