[ Index ]

PHP Cross Reference of phpBB-3.3.0-deutsch

title

Body

[close]

/vendor/symfony/http-foundation/ -> BinaryFileResponse.php (source)

   1  <?php
   2  
   3  /*
   4   * This file is part of the Symfony package.
   5   *
   6   * (c) Fabien Potencier <fabien@symfony.com>
   7   *
   8   * For the full copyright and license information, please view the LICENSE
   9   * file that was distributed with this source code.
  10   */
  11  
  12  namespace Symfony\Component\HttpFoundation;
  13  
  14  use Symfony\Component\HttpFoundation\File\Exception\FileException;
  15  use Symfony\Component\HttpFoundation\File\File;
  16  
  17  /**
  18   * BinaryFileResponse represents an HTTP response delivering a file.
  19   *
  20   * @author Niklas Fiekas <niklas.fiekas@tu-clausthal.de>
  21   * @author stealth35 <stealth35-php@live.fr>
  22   * @author Igor Wiedler <igor@wiedler.ch>
  23   * @author Jordan Alliot <jordan.alliot@gmail.com>
  24   * @author Sergey Linnik <linniksa@gmail.com>
  25   */
  26  class BinaryFileResponse extends Response
  27  {
  28      protected static $trustXSendfileTypeHeader = false;
  29  
  30      /**
  31       * @var File
  32       */
  33      protected $file;
  34      protected $offset = 0;
  35      protected $maxlen = -1;
  36      protected $deleteFileAfterSend = false;
  37  
  38      /**
  39       * @param \SplFileInfo|string $file               The file to stream
  40       * @param int                 $status             The response status code
  41       * @param array               $headers            An array of response headers
  42       * @param bool                $public             Files are public by default
  43       * @param string|null         $contentDisposition The type of Content-Disposition to set automatically with the filename
  44       * @param bool                $autoEtag           Whether the ETag header should be automatically set
  45       * @param bool                $autoLastModified   Whether the Last-Modified header should be automatically set
  46       */
  47      public function __construct($file, $status = 200, $headers = [], $public = true, $contentDisposition = null, $autoEtag = false, $autoLastModified = true)
  48      {
  49          parent::__construct(null, $status, $headers);
  50  
  51          $this->setFile($file, $contentDisposition, $autoEtag, $autoLastModified);
  52  
  53          if ($public) {
  54              $this->setPublic();
  55          }
  56      }
  57  
  58      /**
  59       * @param \SplFileInfo|string $file               The file to stream
  60       * @param int                 $status             The response status code
  61       * @param array               $headers            An array of response headers
  62       * @param bool                $public             Files are public by default
  63       * @param string|null         $contentDisposition The type of Content-Disposition to set automatically with the filename
  64       * @param bool                $autoEtag           Whether the ETag header should be automatically set
  65       * @param bool                $autoLastModified   Whether the Last-Modified header should be automatically set
  66       *
  67       * @return static
  68       */
  69      public static function create($file = null, $status = 200, $headers = [], $public = true, $contentDisposition = null, $autoEtag = false, $autoLastModified = true)
  70      {
  71          return new static($file, $status, $headers, $public, $contentDisposition, $autoEtag, $autoLastModified);
  72      }
  73  
  74      /**
  75       * Sets the file to stream.
  76       *
  77       * @param \SplFileInfo|string $file               The file to stream
  78       * @param string              $contentDisposition
  79       * @param bool                $autoEtag
  80       * @param bool                $autoLastModified
  81       *
  82       * @return $this
  83       *
  84       * @throws FileException
  85       */
  86      public function setFile($file, $contentDisposition = null, $autoEtag = false, $autoLastModified = true)
  87      {
  88          if (!$file instanceof File) {
  89              if ($file instanceof \SplFileInfo) {
  90                  $file = new File($file->getPathname());
  91              } else {
  92                  $file = new File((string) $file);
  93              }
  94          }
  95  
  96          if (!$file->isReadable()) {
  97              throw new FileException('File must be readable.');
  98          }
  99  
 100          $this->file = $file;
 101  
 102          if ($autoEtag) {
 103              $this->setAutoEtag();
 104          }
 105  
 106          if ($autoLastModified) {
 107              $this->setAutoLastModified();
 108          }
 109  
 110          if ($contentDisposition) {
 111              $this->setContentDisposition($contentDisposition);
 112          }
 113  
 114          return $this;
 115      }
 116  
 117      /**
 118       * Gets the file.
 119       *
 120       * @return File The file to stream
 121       */
 122      public function getFile()
 123      {
 124          return $this->file;
 125      }
 126  
 127      /**
 128       * Automatically sets the Last-Modified header according the file modification date.
 129       */
 130      public function setAutoLastModified()
 131      {
 132          $this->setLastModified(\DateTime::createFromFormat('U', $this->file->getMTime()));
 133  
 134          return $this;
 135      }
 136  
 137      /**
 138       * Automatically sets the ETag header according to the checksum of the file.
 139       */
 140      public function setAutoEtag()
 141      {
 142          $this->setEtag(base64_encode(hash_file('sha256', $this->file->getPathname(), true)));
 143  
 144          return $this;
 145      }
 146  
 147      /**
 148       * Sets the Content-Disposition header with the given filename.
 149       *
 150       * @param string $disposition      ResponseHeaderBag::DISPOSITION_INLINE or ResponseHeaderBag::DISPOSITION_ATTACHMENT
 151       * @param string $filename         Optionally use this UTF-8 encoded filename instead of the real name of the file
 152       * @param string $filenameFallback A fallback filename, containing only ASCII characters. Defaults to an automatically encoded filename
 153       *
 154       * @return $this
 155       */
 156      public function setContentDisposition($disposition, $filename = '', $filenameFallback = '')
 157      {
 158          if ('' === $filename) {
 159              $filename = $this->file->getFilename();
 160          }
 161  
 162          if ('' === $filenameFallback && (!preg_match('/^[\x20-\x7e]*$/', $filename) || false !== strpos($filename, '%'))) {
 163              $encoding = mb_detect_encoding($filename, null, true) ?: '8bit';
 164  
 165              for ($i = 0, $filenameLength = mb_strlen($filename, $encoding); $i < $filenameLength; ++$i) {
 166                  $char = mb_substr($filename, $i, 1, $encoding);
 167  
 168                  if ('%' === $char || \ord($char) < 32 || \ord($char) > 126) {
 169                      $filenameFallback .= '_';
 170                  } else {
 171                      $filenameFallback .= $char;
 172                  }
 173              }
 174          }
 175  
 176          $dispositionHeader = $this->headers->makeDisposition($disposition, $filename, $filenameFallback);
 177          $this->headers->set('Content-Disposition', $dispositionHeader);
 178  
 179          return $this;
 180      }
 181  
 182      /**
 183       * {@inheritdoc}
 184       */
 185      public function prepare(Request $request)
 186      {
 187          if (!$this->headers->has('Content-Type')) {
 188              $this->headers->set('Content-Type', $this->file->getMimeType() ?: 'application/octet-stream');
 189          }
 190  
 191          if ('HTTP/1.0' !== $request->server->get('SERVER_PROTOCOL')) {
 192              $this->setProtocolVersion('1.1');
 193          }
 194  
 195          $this->ensureIEOverSSLCompatibility($request);
 196  
 197          $this->offset = 0;
 198          $this->maxlen = -1;
 199  
 200          if (false === $fileSize = $this->file->getSize()) {
 201              return $this;
 202          }
 203          $this->headers->set('Content-Length', $fileSize);
 204  
 205          if (!$this->headers->has('Accept-Ranges')) {
 206              // Only accept ranges on safe HTTP methods
 207              $this->headers->set('Accept-Ranges', $request->isMethodSafe(false) ? 'bytes' : 'none');
 208          }
 209  
 210          if (self::$trustXSendfileTypeHeader && $request->headers->has('X-Sendfile-Type')) {
 211              // Use X-Sendfile, do not send any content.
 212              $type = $request->headers->get('X-Sendfile-Type');
 213              $path = $this->file->getRealPath();
 214              // Fall back to scheme://path for stream wrapped locations.
 215              if (false === $path) {
 216                  $path = $this->file->getPathname();
 217              }
 218              if ('x-accel-redirect' === strtolower($type)) {
 219                  // Do X-Accel-Mapping substitutions.
 220                  // @link http://wiki.nginx.org/X-accel#X-Accel-Redirect
 221                  foreach (explode(',', $request->headers->get('X-Accel-Mapping', '')) as $mapping) {
 222                      $mapping = explode('=', $mapping, 2);
 223  
 224                      if (2 === \count($mapping)) {
 225                          $pathPrefix = trim($mapping[0]);
 226                          $location = trim($mapping[1]);
 227  
 228                          if (substr($path, 0, \strlen($pathPrefix)) === $pathPrefix) {
 229                              $path = $location.substr($path, \strlen($pathPrefix));
 230                              // Only set X-Accel-Redirect header if a valid URI can be produced
 231                              // as nginx does not serve arbitrary file paths.
 232                              $this->headers->set($type, $path);
 233                              $this->maxlen = 0;
 234                              break;
 235                          }
 236                      }
 237                  }
 238              } else {
 239                  $this->headers->set($type, $path);
 240                  $this->maxlen = 0;
 241              }
 242          } elseif ($request->headers->has('Range')) {
 243              // Process the range headers.
 244              if (!$request->headers->has('If-Range') || $this->hasValidIfRangeHeader($request->headers->get('If-Range'))) {
 245                  $range = $request->headers->get('Range');
 246  
 247                  list($start, $end) = explode('-', substr($range, 6), 2) + [0];
 248  
 249                  $end = ('' === $end) ? $fileSize - 1 : (int) $end;
 250  
 251                  if ('' === $start) {
 252                      $start = $fileSize - $end;
 253                      $end = $fileSize - 1;
 254                  } else {
 255                      $start = (int) $start;
 256                  }
 257  
 258                  if ($start <= $end) {
 259                      if ($start < 0 || $end > $fileSize - 1) {
 260                          $this->setStatusCode(416);
 261                          $this->headers->set('Content-Range', sprintf('bytes */%s', $fileSize));
 262                      } elseif (0 !== $start || $end !== $fileSize - 1) {
 263                          $this->maxlen = $end < $fileSize ? $end - $start + 1 : -1;
 264                          $this->offset = $start;
 265  
 266                          $this->setStatusCode(206);
 267                          $this->headers->set('Content-Range', sprintf('bytes %s-%s/%s', $start, $end, $fileSize));
 268                          $this->headers->set('Content-Length', $end - $start + 1);
 269                      }
 270                  }
 271              }
 272          }
 273  
 274          return $this;
 275      }
 276  
 277      private function hasValidIfRangeHeader($header)
 278      {
 279          if ($this->getEtag() === $header) {
 280              return true;
 281          }
 282  
 283          if (null === $lastModified = $this->getLastModified()) {
 284              return false;
 285          }
 286  
 287          return $lastModified->format('D, d M Y H:i:s').' GMT' === $header;
 288      }
 289  
 290      /**
 291       * Sends the file.
 292       *
 293       * {@inheritdoc}
 294       */
 295      public function sendContent()
 296      {
 297          if (!$this->isSuccessful()) {
 298              return parent::sendContent();
 299          }
 300  
 301          if (0 === $this->maxlen) {
 302              return $this;
 303          }
 304  
 305          $out = fopen('php://output', 'wb');
 306          $file = fopen($this->file->getPathname(), 'rb');
 307  
 308          stream_copy_to_stream($file, $out, $this->maxlen, $this->offset);
 309  
 310          fclose($out);
 311          fclose($file);
 312  
 313          if ($this->deleteFileAfterSend && file_exists($this->file->getPathname())) {
 314              unlink($this->file->getPathname());
 315          }
 316  
 317          return $this;
 318      }
 319  
 320      /**
 321       * {@inheritdoc}
 322       *
 323       * @throws \LogicException when the content is not null
 324       */
 325      public function setContent($content)
 326      {
 327          if (null !== $content) {
 328              throw new \LogicException('The content cannot be set on a BinaryFileResponse instance.');
 329          }
 330  
 331          return $this;
 332      }
 333  
 334      /**
 335       * {@inheritdoc}
 336       */
 337      public function getContent()
 338      {
 339          return false;
 340      }
 341  
 342      /**
 343       * Trust X-Sendfile-Type header.
 344       */
 345      public static function trustXSendfileTypeHeader()
 346      {
 347          self::$trustXSendfileTypeHeader = true;
 348      }
 349  
 350      /**
 351       * If this is set to true, the file will be unlinked after the request is sent
 352       * Note: If the X-Sendfile header is used, the deleteFileAfterSend setting will not be used.
 353       *
 354       * @param bool $shouldDelete
 355       *
 356       * @return $this
 357       */
 358      public function deleteFileAfterSend($shouldDelete)
 359      {
 360          $this->deleteFileAfterSend = $shouldDelete;
 361  
 362          return $this;
 363      }
 364  }


Generated: Tue Apr 7 19:44:41 2020 Cross-referenced by PHPXref 0.7.1