public static function PublicStream::basePath

public static PublicStream::basePath(\SplString $site_path = NULL)

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:

$base_path = PublicStream::basePath(\Drupal::service('site.path'));

Parameters

\SplString $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 value

string The base path for public:// typically sites/default/files.

File

core/lib/Drupal/Core/StreamWrapper/PublicStream.php, line 102

Class

PublicStream

Defines a Drupal public (public://) stream wrapper class.

Namespace

Drupal\Core\StreamWrapper

Code

public static function basePath(\SplString $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::service('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');
}