PublicStream.php

Same filename in other branches
  1. 9 core/lib/Drupal/Core/StreamWrapper/PublicStream.php
  2. 8.9.x core/lib/Drupal/Core/StreamWrapper/PublicStream.php
  3. 10 core/lib/Drupal/Core/StreamWrapper/PublicStream.php

Namespace

Drupal\Core\StreamWrapper

File

core/lib/Drupal/Core/StreamWrapper/PublicStream.php

View source
<?php

namespace Drupal\Core\StreamWrapper;

use Drupal\Component\Utility\UrlHelper;
use Drupal\Core\DrupalKernel;
use Drupal\Core\Site\Settings;
use Symfony\Component\HttpFoundation\Request;

/**
 * Defines a Drupal public (public://) stream wrapper class.
 *
 * Provides support for storing publicly accessible files with the Drupal file
 * interface.
 */
class PublicStream extends LocalStream {
    
    /**
     * {@inheritdoc}
     */
    public static function getType() {
        return StreamWrapperInterface::LOCAL_NORMAL;
    }
    
    /**
     * {@inheritdoc}
     */
    public function getName() {
        return t('Public files');
    }
    
    /**
     * {@inheritdoc}
     */
    public function getDescription() {
        return t('Public local files served by the webserver.');
    }
    
    /**
     * {@inheritdoc}
     */
    public function getDirectoryPath() {
        return static::basePath();
    }
    
    /**
     * {@inheritdoc}
     */
    public function getExternalUrl() {
        $path = str_replace('\\', '/', $this->getTarget());
        return static::baseUrl() . '/' . UrlHelper::encodePath($path);
    }
    
    /**
     * Finds and returns the base URL for public://.
     *
     * Defaults to the current site's base URL plus directory path.
     *
     * Note that this static method is used by \Drupal\system\Form\FileSystemForm
     * so you should alter that form or substitute a different form if you change
     * the class providing the stream_wrapper.public service.
     *
     * @return string
     *   The external base URL for public://
     */
    public static function baseUrl() {
        $settings_base_url = Settings::get('file_public_base_url', '');
        if ($settings_base_url) {
            return (string) $settings_base_url;
        }
        else {
            return $GLOBALS['base_url'] . '/' . static::basePath();
        }
    }
    
    /**
     * Returns the base path for public://.
     *
     * If we have a setting for the public:// scheme's path, we use that.
     * Otherwise we build a reasonable default based on the site.path service if
     * it's available, or a default behavior based on the request.
     *
     * Note that this static method is used by \Drupal\system\Form\FileSystemForm
     * so you should alter that form or substitute a different form if you change
     * the class providing the stream_wrapper.public service.
     *
     * The site path is injectable from the site.path service:
     * @code
     * $base_path = PublicStream::basePath(\Drupal::getContainer()->getParameter('site.path'));
     * @endcode
     *
     * @param string $site_path
     *   (optional) The site.path service parameter, which is typically the path
     *   to sites/ in a Drupal installation. This allows you to inject the site
     *   path using services from the caller. If omitted, this method will use the
     *   global service container or the kernel's default behavior to determine
     *   the site path.
     *
     * @return string
     *   The base path for public:// typically sites/default/files.
     */
    public static function basePath($site_path = NULL) {
        if ($site_path === NULL) {
            // Find the site path. Kernel service is not always available at this
            // point, but is preferred, when available.
            if (\Drupal::hasService('kernel')) {
                $site_path = \Drupal::getContainer()->getParameter('site.path');
            }
            else {
                // If there is no kernel available yet, we call the static
                // findSitePath().
                $site_path = DrupalKernel::findSitePath(Request::createFromGlobals());
            }
        }
        return Settings::get('file_public_path', $site_path . '/files');
    }
    
    /**
     * {@inheritdoc}
     */
    protected function getLocalPath($uri = NULL) {
        $path = parent::getLocalPath($uri);
        if (!$path || str_starts_with($path, 'vfs://')) {
            return $path;
        }
        if (Settings::get('sa_core_2022_012_override') === TRUE) {
            return $path;
        }
        $private_path = Settings::get('file_private_path');
        if ($private_path) {
            $private_path = realpath($private_path);
            if ($private_path && str_starts_with($path, $private_path)) {
                return FALSE;
            }
        }
        return $path;
    }

}

Classes

Title Deprecated Summary
PublicStream Defines a Drupal public (public://) stream wrapper class.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.