You are here

final class TransferStats in Zircon Profile 8

Same name and namespace in other branches
  1. 8.0 vendor/guzzlehttp/guzzle/src/TransferStats.php \GuzzleHttp\TransferStats

Represents data at the point after it was transferred either successfully or after a network error.

Hierarchy

Expanded class hierarchy of TransferStats

3 files declare their use of TransferStats
CurlFactory.php in vendor/guzzlehttp/guzzle/src/Handler/CurlFactory.php
MockHandler.php in vendor/guzzlehttp/guzzle/src/Handler/MockHandler.php
StreamHandler.php in vendor/guzzlehttp/guzzle/src/Handler/StreamHandler.php

File

vendor/guzzlehttp/guzzle/src/TransferStats.php, line 12

Namespace

GuzzleHttp
View source
final class TransferStats {
  private $request;
  private $response;
  private $transferTime;
  private $handlerStats;
  private $handlerErrorData;

  /**
   * @param RequestInterface  $request          Request that was sent.
   * @param ResponseInterface $response         Response received (if any)
   * @param null              $transferTime     Total handler transfer time.
   * @param mixed             $handlerErrorData Handler error data.
   * @param array             $handlerStats     Handler specific stats.
   */
  public function __construct(RequestInterface $request, ResponseInterface $response = null, $transferTime = null, $handlerErrorData = null, $handlerStats = []) {
    $this->request = $request;
    $this->response = $response;
    $this->transferTime = $transferTime;
    $this->handlerErrorData = $handlerErrorData;
    $this->handlerStats = $handlerStats;
  }

  /**
   * @return RequestInterface
   */
  public function getRequest() {
    return $this->request;
  }

  /**
   * Returns the response that was received (if any).
   *
   * @return ResponseInterface|null
   */
  public function getResponse() {
    return $this->response;
  }

  /**
   * Returns true if a response was received.
   *
   * @return bool
   */
  public function hasResponse() {
    return $this->response !== null;
  }

  /**
   * Gets handler specific error data.
   *
   * This might be an exception, a integer representing an error code, or
   * anything else. Relying on this value assumes that you know what handler
   * you are using.
   *
   * @return mixed
   */
  public function getHandlerErrorData() {
    return $this->handlerErrorData;
  }

  /**
   * Get the effective URI the request was sent to.
   *
   * @return UriInterface
   */
  public function getEffectiveUri() {
    return $this->request
      ->getUri();
  }

  /**
   * Get the estimated time the request was being transferred by the handler.
   *
   * @return float Time in seconds.
   */
  public function getTransferTime() {
    return $this->transferTime;
  }

  /**
   * Gets an array of all of the handler specific transfer data.
   *
   * @return array
   */
  public function getHandlerStats() {
    return $this->handlerStats;
  }

  /**
   * Get a specific handler statistic from the handler by name.
   *
   * @param string $stat Handler specific transfer stat to retrieve.
   *
   * @return mixed|null
   */
  public function getHandlerStat($stat) {
    return isset($this->handlerStats[$stat]) ? $this->handlerStats[$stat] : null;
  }

}

Members

Namesort descending Modifiers Type Description Overrides
TransferStats::$handlerErrorData private property
TransferStats::$handlerStats private property
TransferStats::$request private property
TransferStats::$response private property
TransferStats::$transferTime private property
TransferStats::getEffectiveUri public function Get the effective URI the request was sent to.
TransferStats::getHandlerErrorData public function Gets handler specific error data.
TransferStats::getHandlerStat public function Get a specific handler statistic from the handler by name.
TransferStats::getHandlerStats public function Gets an array of all of the handler specific transfer data.
TransferStats::getRequest public function
TransferStats::getResponse public function Returns the response that was received (if any).
TransferStats::getTransferTime public function Get the estimated time the request was being transferred by the handler.
TransferStats::hasResponse public function Returns true if a response was received.
TransferStats::__construct public function