Chris@0: <?php
Chris@0: 
Chris@0: namespace Drupal\Core\Render;
Chris@0: 
Chris@0: use Drupal\Core\Cache\CacheableMetadata;
Chris@0: use Drupal\Core\Cache\CacheableResponseInterface;
Chris@0: use Drupal\Core\Cache\CacheableResponseTrait;
Chris@0: use Symfony\Component\HttpFoundation\Response;
Chris@0: 
Chris@0: /**
Chris@0:  * A response that contains and can expose cacheability metadata and attachments.
Chris@0:  *
Chris@0:  * Supports Drupal's caching concepts: cache tags for invalidation and cache
Chris@0:  * contexts for variations.
Chris@0:  *
Chris@0:  * Supports Drupal's idea of #attached metadata: libraries, settings, http_header and html_head.
Chris@0:  *
Chris@0:  * @see \Drupal\Core\Cache\CacheableResponse
Chris@0:  * @see \Drupal\Core\Render\AttachmentsInterface
Chris@0:  * @see \Drupal\Core\Render\AttachmentsTrait
Chris@0:  */
Chris@0: class HtmlResponse extends Response implements CacheableResponseInterface, AttachmentsInterface {
Chris@0: 
Chris@0:   use CacheableResponseTrait;
Chris@0:   use AttachmentsTrait;
Chris@0: 
Chris@0:   /**
Chris@0:    * {@inheritdoc}
Chris@0:    */
Chris@0:   public function setContent($content) {
Chris@0:     // A render array can automatically be converted to a string and set the
Chris@0:     // necessary metadata.
Chris@0:     if (is_array($content) && (isset($content['#markup']))) {
Chris@0:       $content += [
Chris@0:         '#attached' => [
Chris@0:           'html_response_attachment_placeholders' => [],
Chris@0:           'placeholders' => [],
Chris@0:         ],
Chris@0:       ];
Chris@0:       $this->addCacheableDependency(CacheableMetadata::createFromRenderArray($content));
Chris@0:       $this->setAttachments($content['#attached']);
Chris@0:       $content = $content['#markup'];
Chris@0:     }
Chris@0: 
Chris@0:     return parent::setContent($content);
Chris@0:   }
Chris@0: 
Chris@0: }