Cloud Storage Client - Class StreamWrapper (1.30.3)

Reference documentation and code samples for the Cloud Storage Client class StreamWrapper.

A streamWrapper implementation for handling gs://bucket/path/to/file.jpg.

Note that you can only open a file with mode 'r', 'rb', 'rt', 'w', 'wb', 'wt', 'a', 'ab', or 'at'.

See: http://php.net/manual/en/class.streamwrapper.php

Methods

__destruct

Ensure we close the stream when this StreamWrapper is destroyed.

stream_set_option

Starting PHP 7.4, this is called when include/require is used on a stream.

Absence of this method presents a warning. https://www.php.net/manual/en/migration74.incompatible.php

register

Parameters
Name	Description
`client`	`Google\Cloud\Storage\StorageClient` The StorageClient configuration to use.
`protocol`	`string` The name of the protocol to use. Defaults to `gs`.

unregister

Unregisters the SteamWrapper

Parameter
Name	Description
`protocol`	`string` The name of the protocol to unregister. Defaults to `gs`.

getClient

Get the default client to use for streams.

Parameter
Name	Description
`protocol`	`string` The name of the protocol to get the client for. Defaults to `gs`.

Returns
Type	Description
`Google\Cloud\Storage\StorageClient`

stream_open

Callback handler for when a stream is opened. For reads, we need to download the file to see if it can be opened.

Parameters
Name	Description
`path`	`string` The path of the resource to open
`mode`	`string` The fopen mode. Currently supports ('r', 'rb', 'rt', 'w', 'wb', 'wt', 'a', 'ab', 'at')
`flags`	`int` Bitwise options STREAM_USE_PATH\|STREAM_REPORT_ERRORS\|STREAM_MUST_SEEK
`openedPath`	`string` Will be set to the path on success if STREAM_USE_PATH option is set

Returns
Type	Description
`bool`

stream_read

Callback handler for when we try to read a certain number of bytes.

Parameter
Name	Description
`count`	`int` The number of bytes to read.

Returns
Type	Description
`string`

stream_write

Callback handler for when we try to write data to the stream.

Parameter
Name	Description
`data`	`string` The data to write

Returns
Type	Description
`int`	The number of bytes written.

stream_stat

Callback handler for getting data about the stream.

Returns
Type	Description
`array`

stream_eof

Callback handler for checking to see if the stream is at the end of file.

Returns
Type	Description
`bool`

stream_close

Callback handler for trying to close the stream.

stream_seek

Callback handler for trying to seek to a certain location in the stream.

Parameters
Name	Description
`offset`	`int` The stream offset to seek to
`whence`	`int` Flag for what the offset is relative to. See: http://php.net/manual/en/streamwrapper.stream-seek.php

Returns
Type	Description
`bool`

stream_tell

Callhack handler for inspecting our current position in the stream

Returns
Type	Description
`int`

dir_closedir

Callback handler for trying to close an opened directory.

Returns
Type	Description
`bool`

dir_opendir

Callback handler for trying to open a directory.

Parameters
Name	Description
`path`	`string` The url directory to open
`options`	`int` Whether or not to enforce safe_mode

Returns
Type	Description
`bool`

dir_readdir

Callback handler for reading an entry from a directory handle.

Returns
Type	Description
`string\|bool`

dir_rewinddir

Callback handler for rewind the directory handle.

Returns
Type	Description
`bool`

mkdir

Callback handler for trying to create a directory. If no file path is specified, or STREAM_MKDIR_RECURSIVE option is set, then create the bucket if it does not exist.

Parameters
Name	Description
`path`	`string` The url directory to create
`mode`	`int` The permissions on the directory
`options`	`int` Bitwise mask of options. STREAM_MKDIR_RECURSIVE

Returns
Type	Description
`bool`

rename

Callback handler for trying to move a file or directory.

Parameters
Name	Description
`from`	`string` The URL to the current file
`to`	`string` The URL of the new file location

Returns
Type	Description
`bool`

rmdir

Callback handler for trying to remove a directory or a bucket. If the path is empty or '/', the bucket will be deleted.

Note that the STREAM_MKDIR_RECURSIVE flag is ignored because the option cannot be set via the rmdir() function.

Parameters
Name	Description
`path`	`string` The URL directory to remove. If the path is empty or is '/', This will attempt to destroy the bucket.
`options`	`int` Bitwise mask of options.

Returns
Type	Description
`bool`

stream_cast

Callback handler for retrieving the underlaying resource

Parameter
Name	Description
`castAs`	`int` STREAM_CAST_FOR_SELECT\|STREAM_CAST_AS_STREAM

Returns
Type	Description
`resource\|bool`

unlink

Callback handler for deleting a file

Parameter
Name	Description
`path`	`string` The URL of the file to delete

Returns
Type	Description
`bool`

url_stat

Callback handler for retrieving information about a file

Parameters
Name	Description
`path`	`string` The URI to the file
`flags`	`int` Bitwise mask of options

Returns
Type	Description
`array\|bool`

stream_flush

Callback handler for fflush() function.

Returns
Type	Description
`bool`

Constants

DEFAULT_PROTOCOL

Value: 'gs'

FILE_WRITABLE_MODE

Value: 33206

FILE_READABLE_MODE

Value: 33060

DIRECTORY_WRITABLE_MODE

Value: 16895

DIRECTORY_READABLE_MODE

Value: 16676

TAIL_NAME_SUFFIX

Value: '~'