1. class
  2. Hypervel
  3. \
  4. Ai
  5. \
  6. Files
  7. \
  8. RemoteDocument

RemoteDocument

class RemoteDocument extends Document implements Arrayable, JsonSerializable, StorableFile

Traits

CanBeUploadedToProvider
HasRemoteContent

Properties

string|null $name from  File
string|null $mime from  File
protected array<string, string>|SerializableClosure $headers from  File
protected array<string, mixed>|SerializableClosure $providerOptions from  File
protected Response|null $response from  HasRemoteContent

Methods

static File|null
fromArray(array $data)

Reconstruct a file instance from its array representation.

from  File
static string
value(array $data, string $key, string $type)

Get a required value from the file representation.

from  File
string|null
name()

Get the displayable name of the file.

from  HasRemoteContent
HasName
as(string|null $name)

Set the displayable name of the file.

from  File
File
withHeaders(array|Closure $headers)

Specify HTTP headers for the file upload. Closures may only capture serializable values.

from  File
File
withProviderOptions(array|Closure $options)

Specify provider-specific options for the file upload. Closures may only capture serializable values.

from  File
array
providerOptions(Lab|string $provider)

Get the provider-specific options for the file upload.

from  File
array
headers(Lab|string $provider)

Get the HTTP headers for the file upload.

from  File
string|null
mimeType()

Get the file's MIME type.

from  HasRemoteContent
File
withMimeType(string $mimeType)

Set the file's MIME type.

from  File
string
content()

Get the raw representation of the file.

from  HasRemoteContent
static Base64Document
fromString(string $content, string|null $mimeType = null)

Create a new document from a string.

from  Document
static Base64Document
fromBase64(string $base64, string|null $mimeType = null)

Create a new document from Base64 data.

from  Document
static ProviderDocument
fromId(string $id)

Create a new provider document using the document with the given ID.

from  Document
static LocalDocument
fromPath(string $path)

Create a new document using the document at the given path.

from  Document
static RemoteDocument
fromUrl(string $url)

Create a new remote document using the document at the given HTTP(S) URL.

from  Document
static StoredDocument
fromStorage(string $path, string|null $disk = null)

Create a new stored document using the document at the given path on the given disk.

from  Document
static Base64Document
fromUpload(UploadedFile $file, string|null $mimeType = null)

Create a new Base64 document using the given file upload.

from  Document
StoredFileResponse
put(string|null $mimeType = null, string|null $name = null, Provider|Lab|string|null $provider = null)

Store the file on a given provider.

from  CanBeUploadedToProvider
string|null
declaredMimeType()

Get the declared MIME type without fetching the remote resource.

from  HasRemoteContent
Response
response()

Get the HTTP response for the remote file.

from  HasRemoteContent
array
__serialize()

Prepare the file for serialization, discarding the cached HTTP response so it can be fetched again.

from  HasRemoteContent
string
__toString()

Get the file content as a string.

from  HasRemoteContent
__construct(string $url, string|null $mimeType = null)

Create a new remote document.

array
toArray()

Get the instance as an array.

array
jsonSerialize()

Get the JSON serializable representation of the instance.

Details

in File at line 29
static File|null fromArray(array $data)

Reconstruct a file instance from its array representation.

Parameters

array $data

Return Value

File|null

in File at line 70
static protected string value(array $data, string $key, string $type)

Get a required value from the file representation.

Parameters

array $data
string $key
string $type

Return Value

string

in HasRemoteContent at line 26
string|null name()

Get the displayable name of the file.

Return Value

string|null

in File at line 90
HasName as(string|null $name)

Set the displayable name of the file.

Parameters

string|null $name

Return Value

HasName

in File at line 102
File withHeaders(array|Closure $headers)

Specify HTTP headers for the file upload. Closures may only capture serializable values.

Parameters

array|Closure $headers

Return Value

File

in File at line 116
File withProviderOptions(array|Closure $options)

Specify provider-specific options for the file upload. Closures may only capture serializable values.

Parameters

array|Closure $options

Return Value

File

in File at line 130
array providerOptions(Lab|string $provider)

Get the provider-specific options for the file upload.

Parameters

Lab|string $provider

Return Value

array

in File at line 142
array headers(Lab|string $provider)

Get the HTTP headers for the file upload.

Parameters

Lab|string $provider

Return Value

array

in HasRemoteContent at line 36
string|null mimeType()

Get the file's MIME type.

Return Value

string|null

in File at line 160
File withMimeType(string $mimeType)

Set the file's MIME type.

Parameters

string $mimeType

Return Value

File

in HasRemoteContent at line 18
string content()

Get the raw representation of the file.

Return Value

string

in Document at line 19
static Base64Document fromString(string $content, string|null $mimeType = null)

Create a new document from a string.

Parameters

string $content
string|null $mimeType

Return Value

Base64Document

in Document at line 27
static Base64Document fromBase64(string $base64, string|null $mimeType = null)

Create a new document from Base64 data.

Parameters

string $base64
string|null $mimeType

Return Value

Base64Document

in Document at line 35
static ProviderDocument fromId(string $id)

Create a new provider document using the document with the given ID.

Parameters

string $id

Return Value

ProviderDocument

in Document at line 43
static LocalDocument fromPath(string $path)

Create a new document using the document at the given path.

Parameters

string $path

Return Value

LocalDocument

in Document at line 51
static RemoteDocument fromUrl(string $url)

Create a new remote document using the document at the given HTTP(S) URL.

Parameters

string $url

Return Value

RemoteDocument

in Document at line 59
static StoredDocument fromStorage(string $path, string|null $disk = null)

Create a new stored document using the document at the given path on the given disk.

Parameters

string $path
string|null $disk

Return Value

StoredDocument

in Document at line 67
static Base64Document fromUpload(UploadedFile $file, string|null $mimeType = null)

Create a new Base64 document using the given file upload.

Parameters

UploadedFile $file
string|null $mimeType

Return Value

Base64Document

in CanBeUploadedToProvider at line 17
StoredFileResponse put(string|null $mimeType = null, string|null $name = null, Provider|Lab|string|null $provider = null)

Store the file on a given provider.

Parameters

string|null $mimeType
string|null $name
Provider|Lab|string|null $provider

Return Value

StoredFileResponse

in HasRemoteContent at line 44
string|null declaredMimeType()

Get the declared MIME type without fetching the remote resource.

Return Value

string|null

in HasRemoteContent at line 52
protected Response response()

Get the HTTP response for the remote file.

Return Value

Response

in HasRemoteContent at line 60
array __serialize()

Prepare the file for serialization, discarding the cached HTTP response so it can be fetched again.

Return Value

array

in HasRemoteContent at line 72
string __toString()

Get the file content as a string.

Return Value

string

at line 22
__construct(string $url, string|null $mimeType = null)

Create a new remote document.

Parameters

string $url
string|null $mimeType

at line 34
array toArray()

Get the instance as an array.

Return Value

array

at line 47
array jsonSerialize()

Get the JSON serializable representation of the instance.

Return Value

array