Cloud Storage Client - Class StreamWrapper (1.48.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

Namespace

Google \ Cloud \ Storage

Methods

__destruct

Ensure we close the stream when this StreamWrapper is destroyed.

stream_set_option

This is called when include/require is used on a stream.

This is called when touch is used on a stream. See: https://www.php.net/manual/en/streamwrapper.stream-metadata.php

Parameters
Name
Description
path
mixed
option
mixed
value
mixed

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

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

static::register

Register a StreamWrapper for reading and writing to Google Storage

Parameters
Name
Description
client
StorageClient

The StorageClient configuration to use.

protocol
string

The name of the protocol to use. Defaults to gs .

static::unregister

Unregisters the SteamWrapper

Parameter
Name
Description
protocol
string

The name of the protocol to unregister. Defaults to gs .

static::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

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: '~' 
 
Design a Mobile Site
View Site in Mobile | Classic
Share by: