class FilesystemAdapter implements Cloud mixin FilesystemInterface (View source)

Properties

protected FilesystemInterface $driver

The Flysystem filesystem implementation.

Methods

void
__construct(FilesystemInterface $driver)

Create a new filesystem adapter instance.

$this
assertExists(string|array $path)

Assert that the given file exists.

$this
assertMissing(string|array $path)

Assert that the given file does not exist.

bool
exists(string $path)

Determine if a file exists.

bool
missing(string $path)

Determine if a file or directory is missing.

string
path(string $path)

Get the full path for the file at the given "short" path.

string
get(string $path)

Get the contents of a file.

StreamedResponse
response(string $path, string|null $name = null, array $headers = [], string|null $disposition = 'inline')

Create a streamed response for a given file.

StreamedResponse
download(string $path, string|null $name = null, array $headers = [])

Create a streamed download response for a given file.

string
fallbackName(string $name)

Convert the string to ASCII characters that are equivalent to the given name.

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

Write the contents of a file.

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

Store the uploaded file on the disk.

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

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

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(string|array $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.

int
size(string $path)

Get the file size of a given file.

string|false
mimeType(string $path)

Get the mime-type of a given file.

int
lastModified(string $path)

Get the file's last modification time.

string
url(string $path)

Get the URL for the file at the given path.

resource|null
readStream(string $path)

Get a resource to read the file.

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

Write a new file using a stream.

string
getAwsUrl(AwsS3Adapter $adapter, string $path)

Get the URL for the file at the given path.

string
getFtpUrl(string $path)

Get the URL for the file at the given path.

string
getLocalUrl(string $path)

Get the URL for the file at the given path.

string
temporaryUrl(string $path, DateTimeInterface $expiration, array $options = [])

Get a temporary URL for the file at the given path.

string
getAwsTemporaryUrl(AwsS3Adapter $adapter, string $path, DateTimeInterface $expiration, array $options)

Get a temporary URL for the file at the given path.

string
concatPathToUrl(string $url, string $path)

Concatenate a path to a URL.

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 (recursive).

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 (recursive) of the directories within a given directory.

bool
makeDirectory(string $path)

Create a directory.

bool
deleteDirectory(string $directory)

Recursively delete a directory.

void
flushCache()

Flush the Flysystem cache.

FilesystemInterface
getDriver()

Get the Flysystem driver.

array
filterContentsByType(array $contents, string $type)

Filter directory contents by type.

string|null
parseVisibility(string|null $visibility)

Parse the given visibility value.

mixed
__call(string $method, array $parameters)

Pass dynamic methods call onto Flysystem.

Details

void __construct(FilesystemInterface $driver)

Create a new filesystem adapter instance.

Parameters

FilesystemInterface $driver

Return Value

void

$this assertExists(string|array $path)

Assert that the given file exists.

Parameters

string|array $path

Return Value

$this

$this assertMissing(string|array $path)

Assert that the given file does not exist.

Parameters

string|array $path

Return Value

$this

bool exists(string $path)

Determine if a file exists.

Parameters

string $path

Return Value

bool

bool missing(string $path)

Determine if a file or directory is missing.

Parameters

string $path

Return Value

bool

string path(string $path)

Get the full path for the file at the given "short" path.

Parameters

string $path

Return Value

string

string get(string $path)

Get the contents of a file.

Parameters

string $path

Return Value

string

Exceptions

FileNotFoundException

StreamedResponse response(string $path, string|null $name = null, array $headers = [], string|null $disposition = 'inline')

Create a streamed response for a given file.

Parameters

string $path
string|null $name
array $headers
string|null $disposition

Return Value

StreamedResponse

StreamedResponse download(string $path, string|null $name = null, array $headers = [])

Create a streamed download response for a given file.

Parameters

string $path
string|null $name
array $headers

Return Value

StreamedResponse

protected string fallbackName(string $name)

Convert the string to ASCII characters that are equivalent to the given name.

Parameters

string $name

Return Value

string

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

Write the contents of a file.

Parameters

string $path
string|resource $contents
mixed $options

Return Value

bool

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

Store the uploaded file on the disk.

Parameters

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

Return Value

string|false

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

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

Parameters

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

Return Value

string|false

string getVisibility(string $path)

Get the visibility for the given path.

Parameters

string $path

Return Value

string

bool setVisibility(string $path, string $visibility)

Set the visibility for the given path.

Parameters

string $path
string $visibility

Return Value

bool

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

Prepend to a file.

Parameters

string $path
string $data
string $separator

Return Value

bool

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

Append to a file.

Parameters

string $path
string $data
string $separator

Return Value

bool

bool delete(string|array $paths)

Delete the file at a given path.

Parameters

string|array $paths

Return Value

bool

bool copy(string $from, string $to)

Copy a file to a new location.

Parameters

string $from
string $to

Return Value

bool

bool move(string $from, string $to)

Move a file to a new location.

Parameters

string $from
string $to

Return Value

bool

int size(string $path)

Get the file size of a given file.

Parameters

string $path

Return Value

int

string|false mimeType(string $path)

Get the mime-type of a given file.

Parameters

string $path

Return Value

string|false

int lastModified(string $path)

Get the file's last modification time.

Parameters

string $path

Return Value

int

string url(string $path)

Get the URL for the file at the given path.

Parameters

string $path

Return Value

string

Exceptions

RuntimeException

resource|null readStream(string $path)

Get a resource to read the file.

Parameters

string $path

Return Value

resource|null

The path resource or null on failure.

Exceptions

FileNotFoundException

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

Write a new file using a stream.

Parameters

string $path
resource $resource
array $options

Return Value

bool

Exceptions

InvalidArgumentException
FileExistsException

protected string getAwsUrl(AwsS3Adapter $adapter, string $path)

Get the URL for the file at the given path.

Parameters

AwsS3Adapter $adapter
string $path

Return Value

string

protected string getFtpUrl(string $path)

Get the URL for the file at the given path.

Parameters

string $path

Return Value

string

protected string getLocalUrl(string $path)

Get the URL for the file at the given path.

Parameters

string $path

Return Value

string

string temporaryUrl(string $path, DateTimeInterface $expiration, array $options = [])

Get a temporary URL for the file at the given path.

Parameters

string $path
DateTimeInterface $expiration
array $options

Return Value

string

Exceptions

RuntimeException

string getAwsTemporaryUrl(AwsS3Adapter $adapter, string $path, DateTimeInterface $expiration, array $options)

Get a temporary URL for the file at the given path.

Parameters

AwsS3Adapter $adapter
string $path
DateTimeInterface $expiration
array $options

Return Value

string

protected string concatPathToUrl(string $url, string $path)

Concatenate a path to a URL.

Parameters

string $url
string $path

Return Value

string

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

array allFiles(string|null $directory = null)

Get all of the files from the given directory (recursive).

Parameters

string|null $directory

Return Value

array

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

array allDirectories(string|null $directory = null)

Get all (recursive) of the directories within a given directory.

Parameters

string|null $directory

Return Value

array

bool makeDirectory(string $path)

Create a directory.

Parameters

string $path

Return Value

bool

bool deleteDirectory(string $directory)

Recursively delete a directory.

Parameters

string $directory

Return Value

bool

void flushCache()

Flush the Flysystem cache.

Return Value

void

FilesystemInterface getDriver()

Get the Flysystem driver.

Return Value

FilesystemInterface

protected array filterContentsByType(array $contents, string $type)

Filter directory contents by type.

Parameters

array $contents
string $type

Return Value

array

protected string|null parseVisibility(string|null $visibility)

Parse the given visibility value.

Parameters

string|null $visibility

Return Value

string|null

Exceptions

InvalidArgumentException

mixed __call(string $method, array $parameters)

Pass dynamic methods call onto Flysystem.

Parameters

string $method
array $parameters

Return Value

mixed

Exceptions

BadMethodCallException

Laravel Cloud is the best place to deploy Laravel, Nuxt, Express, Hono, Node.js, Bun, Go, Flask, Python, and more, with dedicated infrastructure available on AWS through Laravel Private Cloud.