trait CloudFilesystemDecorator

Traits

Decorates the underlying filesystem by wrapping all calls to it with tracing.

Properties

protected Filesystem $filesystem from  FilesystemDecorator
protected array $defaultData from  FilesystemDecorator
protected bool $recordSpans from  FilesystemDecorator
protected bool $recordBreadcrumbs from  FilesystemDecorator

Methods

mixed
withSentry(string $method, array $args, string|null $description, array $data)

Execute the method on the underlying filesystem and wrap it with tracing and log a breadcrumb.

string
path(string $path)

Get the full path to the file that exists at the given relative path.

bool
exists(string $path)

Determine if a file exists.

string|null
get(string $path)

Get the contents of a file.

mixed
readStream(string $path)

Get a resource to read the file.

mixed
readStreamRange(string $path, int|null $start, int|null $end)

Get a resource to read part of the file.

bool|string
put(string $path, mixed $contents, mixed $options = [])

Write the contents of a file.

false|string
putFile(string|File|UploadedFile $path, array|string|File|UploadedFile|null $file = null, mixed $options = [])

Store the uploaded file on the disk.

false|string
putFileAs(string|File|UploadedFile $path, array|string|File|UploadedFile|null $file, array|string|null $name = null, mixed $options = [])

Store the uploaded file on the disk with a given name.

bool
writeStream(string $path, mixed $resource, array $options = [])

Write a new file using a stream.

string
getVisibility(string $path)

Get the visibility for the given path.

bool
setVisibility(string $path, string $visibility)

Set the visibility for the given path.

bool
prepend(string $path, string $data, string $separator = PHP_EOL)

Prepend to a file.

bool
append(string $path, string $data, string $separator = PHP_EOL)

Append to a file.

bool
delete(array|string $paths)

Delete the file at a given path.

bool
copy(string $from, string $to)

Copy a file to a new location.

bool
move(string $from, string $to)

Move a file to a new location.

bool
copyToDisk(Filesystem|string|UnitEnum $disk, string $from, string|null $to = null)

Copy a file to another disk.

bool
moveToDisk(Filesystem|string|UnitEnum $disk, string $from, string|null $to = null)

Move a file to another disk.

bool
transferToDisk(string $method, Filesystem|string|UnitEnum $disk, string $from, string|null $to)

Trace a transfer while preserving the wrapped disk's identity check.

int
size(string $path)

Get the file size of a given file.

int
lastModified(string $path)

Get the file's last modification time.

array
files(string|null $directory = null, bool $recursive = false)

Get an array of all files in a directory.

array
allFiles(string|null $directory = null)

Get all of the files from the given directory recursively.

array
directories(string|null $directory = null, bool $recursive = false)

Get all of the directories within a given directory.

array
allDirectories(string|null $directory = null)

Get all of the directories recursively.

bool
makeDirectory(string $path)

Create a directory.

bool
deleteDirectory(string $directory)

Recursively delete a directory.

getFilesystem()

Get the wrapped filesystem.

bool
invalidatePool()

Invalidate the wrapped filesystem's pool when supported.

array
getDescriptionAndDataForPathOrPaths(array|string $pathOrPaths)

Get the description and data for one or more paths.

mixed
__call(string $name, array $arguments)

Dynamically proxy calls to the wrapped filesystem.

string
url(string $path)

Get the URL for the file at the given path.

Details

protected mixed withSentry(string $method, array $args, string|null $description, array $data)

Execute the method on the underlying filesystem and wrap it with tracing and log a breadcrumb.

Parameters

string $method
array $args
string|null $description
array $data

Return Value

mixed

string path(string $path)

Get the full path to the file that exists at the given relative path.

Parameters

string $path

Return Value

string

bool exists(string $path)

Determine if a file exists.

Parameters

string $path

Return Value

bool

string|null get(string $path)

Get the contents of a file.

Parameters

string $path

Return Value

string|null

in FilesystemDecorator at line 106
mixed readStream(string $path)

Get a resource to read the file.

Parameters

string $path

Return Value

mixed

in FilesystemDecorator at line 116
mixed readStreamRange(string $path, int|null $start, int|null $end)

Get a resource to read part of the file.

Parameters

string $path
int|null $start
int|null $end

Return Value

mixed

in FilesystemDecorator at line 126
bool|string put(string $path, mixed $contents, mixed $options = [])

Write the contents of a file.

Parameters

string $path
mixed $contents
mixed $options

Return Value

bool|string

in FilesystemDecorator at line 136
false|string putFile(string|File|UploadedFile $path, array|string|File|UploadedFile|null $file = null, mixed $options = [])

Store the uploaded file on the disk.

Parameters

string|File|UploadedFile $path
array|string|File|UploadedFile|null $file
mixed $options

Return Value

false|string

in FilesystemDecorator at line 149
false|string putFileAs(string|File|UploadedFile $path, array|string|File|UploadedFile|null $file, array|string|null $name = null, mixed $options = [])

Store the uploaded file on the disk with a given name.

Parameters

string|File|UploadedFile $path
array|string|File|UploadedFile|null $file
array|string|null $name
mixed $options

Return Value

false|string

in FilesystemDecorator at line 165
bool writeStream(string $path, mixed $resource, array $options = [])

Write a new file using a stream.

Parameters

string $path
mixed $resource
array $options

Return Value

bool

in FilesystemDecorator at line 173
string getVisibility(string $path)

Get the visibility for the given path.

Parameters

string $path

Return Value

string

in FilesystemDecorator at line 181
bool setVisibility(string $path, string $visibility)

Set the visibility for the given path.

Parameters

string $path
string $visibility

Return Value

bool

in FilesystemDecorator at line 189
bool prepend(string $path, string $data, string $separator = PHP_EOL)

Prepend to a file.

Parameters

string $path
string $data
string $separator

Return Value

bool

in FilesystemDecorator at line 199
bool append(string $path, string $data, string $separator = PHP_EOL)

Append to a file.

Parameters

string $path
string $data
string $separator

Return Value

bool

in FilesystemDecorator at line 209
bool delete(array|string $paths)

Delete the file at a given path.

Parameters

array|string $paths

Return Value

bool

in FilesystemDecorator at line 219
bool copy(string $from, string $to)

Copy a file to a new location.

Parameters

string $from
string $to

Return Value

bool

in FilesystemDecorator at line 227
bool move(string $from, string $to)

Move a file to a new location.

Parameters

string $from
string $to

Return Value

bool

in FilesystemDecorator at line 235
bool copyToDisk(Filesystem|string|UnitEnum $disk, string $from, string|null $to = null)

Copy a file to another disk.

Parameters

Filesystem|string|UnitEnum $disk
string $from
string|null $to

Return Value

bool

in FilesystemDecorator at line 243
bool moveToDisk(Filesystem|string|UnitEnum $disk, string $from, string|null $to = null)

Move a file to another disk.

Parameters

Filesystem|string|UnitEnum $disk
string $from
string|null $to

Return Value

bool

in FilesystemDecorator at line 251
protected bool transferToDisk(string $method, Filesystem|string|UnitEnum $disk, string $from, string|null $to)

Trace a transfer while preserving the wrapped disk's identity check.

Parameters

string $method
Filesystem|string|UnitEnum $disk
string $from
string|null $to

Return Value

bool

in FilesystemDecorator at line 273
int size(string $path)

Get the file size of a given file.

Parameters

string $path

Return Value

int

in FilesystemDecorator at line 281
int lastModified(string $path)

Get the file's last modification time.

Parameters

string $path

Return Value

int

in FilesystemDecorator at line 289
array files(string|null $directory = null, bool $recursive = false)

Get an array of all files in a directory.

Parameters

string|null $directory
bool $recursive

Return Value

array

in FilesystemDecorator at line 297
array allFiles(string|null $directory = null)

Get all of the files from the given directory recursively.

Parameters

string|null $directory

Return Value

array

in FilesystemDecorator at line 305
array directories(string|null $directory = null, bool $recursive = false)

Get all of the directories within a given directory.

Parameters

string|null $directory
bool $recursive

Return Value

array

in FilesystemDecorator at line 313
array allDirectories(string|null $directory = null)

Get all of the directories recursively.

Parameters

string|null $directory

Return Value

array

in FilesystemDecorator at line 321
bool makeDirectory(string $path)

Create a directory.

Parameters

string $path

Return Value

bool

in FilesystemDecorator at line 329
bool deleteDirectory(string $directory)

Recursively delete a directory.

Parameters

string $directory

Return Value

bool

in FilesystemDecorator at line 337
Filesystem getFilesystem()

Get the wrapped filesystem.

Return Value

Filesystem

in FilesystemDecorator at line 345
bool invalidatePool()

Invalidate the wrapped filesystem's pool when supported.

Return Value

bool

in FilesystemDecorator at line 356
protected array getDescriptionAndDataForPathOrPaths(array|string $pathOrPaths)

Get the description and data for one or more paths.

Parameters

array|string $pathOrPaths

Return Value

array

in FilesystemDecorator at line 372
mixed __call(string $name, array $arguments)

Dynamically proxy calls to the wrapped filesystem.

Parameters

string $name
array $arguments

Return Value

mixed

at line 14
string url(string $path)

Get the URL for the file at the given path.

Parameters

string $path

Return Value

string