class AssetDumper in Flysystem 8

Flysystem dependency injection container.

@codeCoverageIgnore

Hierarchy

• class \Drupal\Core\Asset\AssetDumper implements AssetDumperInterface
  • class \Drupal\flysystem\Asset\AssetDumper uses SchemeExtensionTrait

2 files declare their use of AssetDumper

FlysystemServiceProviderTest.php in tests/src/Unit/FlysystemServiceProviderTest.php

JsCollectionOptimizerTest.php in tests/src/Unit/Asset/JsCollectionOptimizerTest.php

File

src/Asset/AssetDumper.php, line 13

Namespace

Drupal\flysystem\Asset

class AssetDumper extends DrupalAssetDumper {
  use SchemeExtensionTrait;

  /**
   * {@inheritdoc}
   */
  public function dump($data, $file_extension) {

    // Prefix filename to prevent blocking by firewalls which reject files
    // starting with "ad*".
    $filename = $file_extension . '_' . Crypt::hashBase64($data) . '.' . $file_extension;

    // Create the css/ or js/ path within the files folder.
    $path = $this
      ->getSchemeForExtension($file_extension) . '://' . $file_extension;
    $uri = $path . '/' . $filename;

    // Create the CSS or JS file.
    file_prepare_directory($path, FILE_CREATE_DIRECTORY);
    if (!file_exists($uri) && !file_unmanaged_save_data($data, $uri, FILE_EXISTS_REPLACE)) {
      return FALSE;
    }

    // If CSS/JS gzip compression is enabled and the zlib extension is available
    // then create a gzipped version of this file. This file is served
    // conditionally to browsers that accept gzip using .htaccess rules.
    // It's possible that the rewrite rules in .htaccess aren't working on this
    // server, but there's no harm (other than the time spent generating the
    // file) in generating the file anyway. Sites on servers where rewrite rules
    // aren't working can set css.gzip to FALSE in order to skip
    // generating a file that won't be used.
    if (extension_loaded('zlib') && \Drupal::config('system.performance')
      ->get($file_extension . '.gzip')) {
      if (!file_exists($uri . '.gz') && !file_unmanaged_save_data(gzencode($data, 9, FORCE_GZIP), $uri . '.gz', FILE_EXISTS_REPLACE)) {
        return FALSE;
      }
    }
    return $uri;
  }

}

Members

Name	Modifiers	Type	Description	Overrides
AssetDumper::$fileSystem	protected	property	The file system service.
AssetDumper::dump	public	function	The file name for the CSS or JS cache file is generated from the hash of the aggregated contents of the files in $data. This forces proxies and browsers to download new CSS when the CSS changes. Overrides AssetDumper::dump
AssetDumper::getFileSystem	private	function	Helper method for returning the file system service.
AssetDumper::__construct	public	function	AssetDumper constructor.
SchemeExtensionTrait::getSchemeForExtension	public	function	Returns the scheme that should serve an extension.