class StreamedResponse

file.inc in drupal/core/includes/file.inc

API for handling file uploads and server file management.

HttpKernel.php in drupal/core/lib/Drupal/Core/HttpKernel.php

Definition of Drupal\Core\HttpKernel.

image.module in drupal/core/modules/image/image.module

Exposes global functionality for creating image styles.

StreamedResponseListener.php in drupal/core/vendor/symfony/http-kernel/Symfony/Component/HttpKernel/EventListener/StreamedResponseListener.php

StreamedResponseTest.php in drupal/core/vendor/symfony/http-foundation/Symfony/Component/HttpFoundation/Tests/StreamedResponseTest.php

... See full list

class StreamedResponse extends Response {
  protected $callback;
  protected $streamed;

  /**
   * Constructor.
   *
   * @param mixed   $callback A valid PHP callback
   * @param integer $status   The response status code
   * @param array   $headers  An array of response headers
   *
   * @api
   */
  public function __construct($callback = null, $status = 200, $headers = array()) {
    parent::__construct(null, $status, $headers);
    if (null !== $callback) {
      $this
        ->setCallback($callback);
    }
    $this->streamed = false;
  }

  /**
   * {@inheritDoc}
   */
  public static function create($callback = null, $status = 200, $headers = array()) {
    return new static($callback, $status, $headers);
  }

  /**
   * Sets the PHP callback associated with this Response.
   *
   * @param mixed $callback A valid PHP callback
   */
  public function setCallback($callback) {
    if (!is_callable($callback)) {
      throw new \LogicException('The Response callback must be a valid PHP callable.');
    }
    $this->callback = $callback;
  }

  /**
   * {@inheritdoc}
   */
  public function prepare(Request $request) {
    if ('HTTP/1.0' != $request->server
      ->get('SERVER_PROTOCOL')) {
      $this
        ->setProtocolVersion('1.1');
    }
    $this->headers
      ->set('Cache-Control', 'no-cache');
    return parent::prepare($request);
  }

  /**
   * {@inheritdoc}
   *
   * This method only sends the content once.
   */
  public function sendContent() {
    if ($this->streamed) {
      return;
    }
    $this->streamed = true;
    if (null === $this->callback) {
      throw new \LogicException('The Response callback must not be null.');
    }
    call_user_func($this->callback);
  }

  /**
   * {@inheritdoc}
   *
   * @throws \LogicException when the content is not null
   */
  public function setContent($content) {
    if (null !== $content) {
      throw new \LogicException('The content cannot be set on a StreamedResponse instance.');
    }
  }

  /**
   * {@inheritdoc}
   *
   * @return false
   */
  public function getContent() {
    return false;
  }

}