1. class
  2. Drupal
  3. \
  4. Core
  5. \
  6. StreamWrapper
  7. \
  8. PublicStream

PublicStream

class PublicStream extends LocalStream (View source)

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

Provides support for storing publicly accessible files with the Drupal file interface.

Properties

resource $context

Stream context resource.

 from  LocalStream
resource $handle

A generic resource handle.

 from  LocalStream
protected string $uri

Instance URI (stream).

 from  LocalStream

Methods

static int
getType()

Returns the type of stream wrapper.

string
getDirectoryPath()

Gets the path that the wrapper is responsible for.

setUri(string $uri)

Sets the absolute stream resource URI.

from  LocalStream
string
getUri()

Returns the stream resource URI.

from  LocalStream
string|bool
getTarget(string $uri = NULL)

Returns the local writable target of the resource within the stream.

from  LocalStream
string
realpath()

Returns canonical, absolute path of the resource.

from  LocalStream
string|bool
getLocalPath(string $uri = NULL)

Returns the canonical absolute path of the URI, if possible.

from  LocalStream
bool
stream_open(string $uri, $mode, $options, $opened_path)

Support for fopen(), file_get_contents(), file_put_contents() etc.

from  LocalStream
bool
stream_lock($operation)

Support for flock().

from  LocalStream
string
stream_read($count)

Support for fread(), file_get_contents() etc.

from  LocalStream
int
stream_write($data)

Support for fwrite(), file_put_contents() etc.

from  LocalStream
bool
stream_eof()

Support for feof().

from  LocalStream
bool
stream_seek(int $offset, int $whence = SEEK_SET)

Seeks to specific location in a stream.

from  LocalStream
bool
stream_flush()

Support for fflush().

from  LocalStream
int
stream_tell()

Support for ftell().

from  LocalStream
array
stream_stat()

Support for fstat().

from  LocalStream
stream_close()

Support for fclose().

from  LocalStream
resource|false
stream_cast(int $cast_as)

Retrieve the underlying stream resource.

from  LocalStream
bool
stream_metadata($uri, int $option, mixed $value)

Sets metadata on the stream.

from  LocalStream
bool
stream_set_option(int $option, int $arg1, int $arg2)

Change stream options.

from  LocalStream
bool
stream_truncate(int $new_size)

Truncate stream.

from  LocalStream
bool
unlink(string $uri)

Support for unlink().

from  LocalStream
bool
rename(string $from_uri, string $to_uri)

Support for rename().

from  LocalStream
string
dirname(string $uri = NULL)

Gets the name of the directory from a given path.

from  LocalStream
bool
mkdir(string $uri, $mode, $options)

Support for mkdir().

from  LocalStream
bool
rmdir(string $uri, $options)

Support for rmdir().

from  LocalStream
array
url_stat(string $uri, $flags)

Support for stat().

from  LocalStream
bool
dir_opendir(string $uri, $options)

Support for opendir().

from  LocalStream
string
dir_readdir()

Support for readdir().

from  LocalStream
bool
dir_rewinddir()

Support for rewinddir().

from  LocalStream
bool
dir_closedir()

Support for closedir().

from  LocalStream
string
getName()

Returns the name of the stream wrapper for use in the UI.

string
getDescription()

Returns the description of the stream wrapper for use in the UI.

string
getExternalUrl()

Returns a web accessible URL for the resource.

static string
baseUrl()

Finds and returns the base URL for public://.

static string
basePath(string $site_path = NULL)

Returns the base path for public://.

Details

at line 21
static int getType()

Returns the type of stream wrapper.

Return Value

int

at line 42
string getDirectoryPath()

Gets the path that the wrapper is responsible for.

Return Value

string

String specifying the path.

in LocalStream at line 60
setUri(string $uri)

Sets the absolute stream resource URI.

This allows you to set the URI. Generally is only called by the factory method.

Parameters

string $uri

A string containing the URI that should be used for this instance.

in LocalStream at line 67
string getUri()

Returns the stream resource URI.

Return Value

string

Returns the current URI of the instance.

in LocalStream at line 87
protected string|bool getTarget(string $uri = NULL)

Returns the local writable target of the resource within the stream.

This function should be used in place of calls to realpath() or similar functions when attempting to determine the location of a file. While functions like realpath() may return the location of a read-only file, this method may return a URI or path suitable for writing that is completely separate from the URI used for reading.

Parameters

string $uri

Optional URI.

Return Value

string|bool

Returns a string representing a location suitable for writing of a file, or FALSE if unable to write to the file such as with read-only streams.

in LocalStream at line 101
string realpath()

Returns canonical, absolute path of the resource.

Implementation placeholder. PHP's realpath() does not support stream wrappers. We provide this as a default so that individual wrappers may implement their own solutions.

Return Value

string

Returns a string with absolute pathname on success (implemented by core wrappers), or FALSE on failure or if the registered wrapper does not provide an implementation.

in LocalStream at line 120
protected string|bool getLocalPath(string $uri = NULL)

Returns the canonical absolute path of the URI, if possible.

Parameters

string $uri

(optional) The stream wrapper URI to be converted to a canonical absolute path. This may point to a directory or another type of file.

Return Value

string|bool

If $uri is not set, returns the canonical absolute path of the URI previously set by the Drupal\Core\StreamWrapper\StreamWrapperInterface::setUri() function. If $uri is set and valid for this class, returns its canonical absolute path, as determined by the realpath() function. If $uri is set but not valid, returns FALSE.

in LocalStream at line 163
bool stream_open(string $uri, $mode, $options, $opened_path)

Support for fopen(), file_get_contents(), file_put_contents() etc.

Parameters

string $uri

A string containing the URI to the file to open.
$mode
$options
$opened_path

Return Value

bool

See also

http://php.net/manual/streamwrapper.stream-open.php

in LocalStream at line 191
bool stream_lock($operation)

Support for flock().

Parameters

$operation

Return Value

bool

See also

http://php.net/manual/streamwrapper.stream-lock.php

in LocalStream at line 210
string stream_read($count)

Support for fread(), file_get_contents() etc.

Parameters

$count

Return Value

string

See also

http://php.net/manual/streamwrapper.stream-read.php

in LocalStream at line 225
int stream_write($data)

Support for fwrite(), file_put_contents() etc.

Parameters

$data

Return Value

int

See also

http://php.net/manual/streamwrapper.stream-write.php

in LocalStream at line 237
bool stream_eof()

Support for feof().

Return Value

bool

See also

http://php.net/manual/streamwrapper.stream-eof.php

in LocalStream at line 244
bool stream_seek(int $offset, int $whence = SEEK_SET)

Seeks to specific location in a stream.

This method is called in response to fseek().

The read/write position of the stream should be updated according to the offset and whence.

Parameters

int $offset

The byte offset to seek to.
int $whence

Possible values:

  • SEEK_SET: Set position equal to offset bytes.
  • SEEK_CUR: Set position to current location plus offset.
  • SEEK_END: Set position to end-of-file plus offset. Defaults to SEEK_SET.

Return Value

bool

TRUE if the position was updated, FALSE otherwise.

in LocalStream at line 258
bool stream_flush()

Support for fflush().

Return Value

bool

See also

http://php.net/manual/streamwrapper.stream-flush.php

in LocalStream at line 270
int stream_tell()

Support for ftell().

Return Value

int

See also

http://php.net/manual/streamwrapper.stream-tell.php

in LocalStream at line 283
array stream_stat()

Support for fstat().

Return Value

array

See also

http://php.net/manual/streamwrapper.stream-stat.php

in LocalStream at line 295
stream_close()

Support for fclose().

See also

http://php.net/manual/streamwrapper.stream-close.php

in LocalStream at line 302
resource|false stream_cast(int $cast_as)

Retrieve the underlying stream resource.

This method is called in response to stream_select().

Parameters

int $cast_as

Can be STREAM_CAST_FOR_SELECT when stream_select() is calling stream_cast() or STREAM_CAST_AS_STREAM when stream_cast() is called for other uses.

Return Value

resource|false

The underlying stream resource or FALSE if stream_select() is not supported.

in LocalStream at line 309
bool stream_metadata($uri, int $option, mixed $value)

Sets metadata on the stream.

Parameters

$uri
int $option

One of:

  • STREAM_META_TOUCH: The method was called in response to touch().
  • STREAM_META_OWNER_NAME: The method was called in response to chown() with string parameter.
  • STREAM_META_OWNER: The method was called in response to chown().
  • STREAM_META_GROUP_NAME: The method was called in response to chgrp().
  • STREAM_META_GROUP: The method was called in response to chgrp().
  • STREAM_META_ACCESS: The method was called in response to chmod().
mixed $value

If option is:

  • STREAM_META_TOUCH: Array consisting of two arguments of the touch() function.
  • STREAM_META_OWNER_NAME or STREAM_META_GROUP_NAME: The name of the owner user/group as string.
  • STREAM_META_OWNER or STREAM_META_GROUP: The value of the owner user/group as integer.
  • STREAM_META_ACCESS: The argument of the chmod() as integer.

Return Value

bool

Returns TRUE on success or FALSE on failure. If $option is not implemented, FALSE should be returned.

in LocalStream at line 352
bool stream_set_option(int $option, int $arg1, int $arg2)

Change stream options.

This method is called to set options on the stream.

Parameters

int $option

One of:

  • STREAM_OPTION_BLOCKING: The method was called in response to stream_set_blocking().
  • STREAM_OPTION_READ_TIMEOUT: The method was called in response to stream_set_timeout().
  • STREAM_OPTION_WRITE_BUFFER: The method was called in response to stream_set_write_buffer().
int $arg1

If option is:

  • STREAM_OPTION_BLOCKING: The requested blocking mode:
    • 1 means blocking.
    • 0 means not blocking.
  • STREAM_OPTION_READ_TIMEOUT: The timeout in seconds.
  • STREAM_OPTION_WRITE_BUFFER: The buffer mode, STREAM_BUFFER_NONE or STREAM_BUFFER_FULL.
int $arg2

If option is:

  • STREAM_OPTION_BLOCKING: This option is not set.
  • STREAM_OPTION_READ_TIMEOUT: The timeout in microseconds.
  • STREAM_OPTION_WRITE_BUFFER: The requested buffer size.

Return Value

bool

TRUE on success, FALSE otherwise. If $option is not implemented, FALSE should be returned.

in LocalStream at line 360
bool stream_truncate(int $new_size)

Truncate stream.

Will respond to truncation; e.g., through ftruncate().

Parameters

int $new_size

The new size.

Return Value

bool

TRUE on success, FALSE otherwise.

Support for unlink().

Parameters

string $uri

A string containing the URI to the resource to delete.

Return Value

bool

See also

http://php.net/manual/streamwrapper.unlink.php

in LocalStream at line 393
bool rename(string $from_uri, string $to_uri)

Support for rename().

Parameters

string $from_uri

The URI to the file to rename.
string $to_uri

The new URI for file.

Return Value

bool

See also

http://php.net/manual/streamwrapper.rename.php

in LocalStream at line 412
string dirname(string $uri = NULL)

Gets the name of the directory from a given path.

This method is usually accessed through \Drupal\Core\File\FileSystemInterface::dirname(), which wraps around the PHP dirname() function because it does not support stream wrappers.

Parameters

string $uri

An optional URI.

Return Value

string

A string containing the directory name, or FALSE if not applicable.

See also

FileSystemInterface::dirname

in LocalStream at line 439
bool mkdir(string $uri, $mode, $options)

Support for mkdir().

Parameters

string $uri

A string containing the URI to the directory to create.
$mode
$options

Return Value

bool

See also

http://php.net/manual/streamwrapper.mkdir.php

in LocalStream at line 473
bool rmdir(string $uri, $options)

Support for rmdir().

Parameters

string $uri

A string containing the URI to the directory to delete.
$options

Return Value

bool

See also

http://php.net/manual/streamwrapper.rmdir.php

in LocalStream at line 499
array url_stat(string $uri, $flags)

Support for stat().

Parameters

string $uri

A string containing the URI to get information about.
$flags

Return Value

array

See also

http://php.net/manual/streamwrapper.url-stat.php

in LocalStream at line 525
bool dir_opendir(string $uri, $options)

Support for opendir().

Parameters

string $uri

A string containing the URI to the directory to open.
$options

Return Value

bool

See also

http://php.net/manual/streamwrapper.dir-opendir.php

in LocalStream at line 540
string dir_readdir()

Support for readdir().

Return Value

string

See also

http://php.net/manual/streamwrapper.dir-readdir.php

in LocalStream at line 552
bool dir_rewinddir()

Support for rewinddir().

Return Value

bool

See also

http://php.net/manual/streamwrapper.dir-rewinddir.php

in LocalStream at line 568
bool dir_closedir()

Support for closedir().

Return Value

bool

See also

http://php.net/manual/streamwrapper.dir-closedir.php

at line 28
string getName()

Returns the name of the stream wrapper for use in the UI.

Return Value

string

The stream wrapper name.

at line 35
string getDescription()

Returns the description of the stream wrapper for use in the UI.

Return Value

string

The stream wrapper description.

at line 49
string getExternalUrl()

Returns a web accessible URL for the resource.

This function should return a URL that can be embedded in a web page and accessed from a browser. For example, the external URL of "youtube://xIpLd0WQKCY" might be "http://www.youtube.com/watch?v=xIpLd0WQKCY".

Return Value

string

Returns a string containing a web accessible URL for the resource.

at line 66
static string baseUrl()

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 Value

string

The external base URL for public://

at line 102
static string basePath(string $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:

Parameters

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 Value

string

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