1. class
  2. Hypervel
  3. \
  4. Http
  5. \
  6. Testing
  7. \
  8. File

File

class File extends UploadedFile

Traits

FileHelpers
Macroable

Properties

protected string|null $hashName

The cache copy of the file's hash name.

 from  FileHelpers
static protected array $macros

The registered string macros.

 from  Macroable
string $name

The name of the file.
resource $tempFile

The temporary file resource.
int|null $sizeToReport

The "size" to report.
string|null $mimeTypeToReport

The MIME type to report.

Methods

string
path()

Get the fully-qualified path to the file.

from  FileHelpers
string
extension()

Get the file's extension.

from  FileHelpers
string
hashName(string|null $path = null)

Get a filename for the file.

from  FileHelpers
array|null
dimensions()

Get the dimensions of the image (if applicable).

from  FileHelpers
static void
macro(string $name, callable|object $macro)

Register a custom macro.

from  Macroable
static void
mixin(object $mixin, bool $replace = true)

Mix another object into the class.

from  Macroable
static bool
hasMacro(string $name)

Check if macro is registered.

from  Macroable
static void
flushMacros()

Flush the existing macros.

from  Macroable
static mixed
__callStatic(string $method, array $parameters)

Dynamically handle calls to the class.

from  Macroable
mixed
__call(string $method, array $parameters)

Dynamically handle calls to the class.

from  Macroable
static FileFactory
fake()

Begin creating a new file fake.

from  UploadedFile
string|false
store(string $path = '', array|string $options = [])

Store the uploaded file on a filesystem disk.

from  UploadedFile
string|false
storePublicly(string $path = '', array|string $options = [])

Store the uploaded file on a filesystem disk with public visibility.

from  UploadedFile
string|false
storePubliclyAs(string $path, array|string|null $name = null, array|string $options = [])

Store the uploaded file on a filesystem disk with public visibility.

from  UploadedFile
string|false
storeAs(string $path, array|string|null $name = null, array|string $options = [])

Store the uploaded file on a filesystem disk.

from  UploadedFile
string|false
get()

Get the contents of the uploaded file.

from  UploadedFile
string
clientExtension()

Get the file's extension supplied by the client.

from  UploadedFile
static UploadedFile
createFromBase(UploadedFile $file, bool $test = false)

Create a new file instance from a base instance.

from  UploadedFile
array
parseOptions(array|string $options)

Parse and format the given options.

from  UploadedFile
static void
flushState()

Flush all static state.

from  UploadedFile
__construct(string $name, mixed $tempFile)

Create a new file instance.

static File
create(string $name, string|int $kilobytes = 0)

Create a new fake file.

static File
createWithContent(string $name, string $content)

Create a new fake file with content.

static File
image(string $name, int $width = 10, int $height = 10)

Create a new fake image.

File
size(int $kilobytes)

Set the "size" of the file in kilobytes.

int
getSize()

Get the size of the file.

File
mimeType(string $mimeType)

Set the MIME type for the file.

string
getMimeType()

Get the MIME type of the file.

string
tempFilePath()

Get the path to the temporary file.

Details

in FileHelpers at line 19
string path()

Get the fully-qualified path to the file.

Return Value

string

in FileHelpers at line 27
string extension()

Get the file's extension.

Return Value

string

in FileHelpers at line 35
string hashName(string|null $path = null)

Get a filename for the file.

Parameters

string|null $path

Return Value

string

in FileHelpers at line 53
array|null dimensions()

Get the dimensions of the image (if applicable).

Return Value

array|null

in Macroable at line 28
static void macro(string $name, callable|object $macro)

Register a custom macro.

Boot-only. Macros persist in a static property for the worker lifetime and apply to every subsequent call on the macroable class.

Parameters

string $name
callable|object $macro

Return Value

void

in Macroable at line 41
static void mixin(object $mixin, bool $replace = true)

Mix another object into the class.

Boot-only. Delegates to macro() for each method; registered macros persist in a static property for the worker lifetime.

Parameters

object $mixin
bool $replace

Return Value

void

Exceptions

ReflectionException

in Macroable at line 57
static bool hasMacro(string $name)

Check if macro is registered.

Parameters

string $name

Return Value

bool

in Macroable at line 68
static void flushMacros()

Flush the existing macros.

Boot or tests only. Clears worker-wide macros; concurrent coroutines may resolve different methods depending on timing.

Return Value

void

in Macroable at line 78
static mixed __callStatic(string $method, array $parameters)

Dynamically handle calls to the class.

Parameters

string $method
array $parameters

Return Value

mixed

Exceptions

BadMethodCallException

in Macroable at line 103
mixed __call(string $method, array $parameters)

Dynamically handle calls to the class.

Parameters

string $method
array $parameters

Return Value

mixed

Exceptions

BadMethodCallException

in UploadedFile at line 23
static FileFactory fake()

Begin creating a new file fake.

Return Value

FileFactory

in UploadedFile at line 31
string|false store(string $path = '', array|string $options = [])

Store the uploaded file on a filesystem disk.

Parameters

string $path
array|string $options

Return Value

string|false

in UploadedFile at line 39
string|false storePublicly(string $path = '', array|string $options = [])

Store the uploaded file on a filesystem disk with public visibility.

Parameters

string $path
array|string $options

Return Value

string|false

in UploadedFile at line 51
string|false storePubliclyAs(string $path, array|string|null $name = null, array|string $options = [])

Store the uploaded file on a filesystem disk with public visibility.

Parameters

string $path
array|string|null $name
array|string $options

Return Value

string|false

in UploadedFile at line 67
string|false storeAs(string $path, array|string|null $name = null, array|string $options = [])

Store the uploaded file on a filesystem disk.

Parameters

string $path
array|string|null $name
array|string $options

Return Value

string|false

in UploadedFile at line 90
string|false get()

Get the contents of the uploaded file.

Return Value

string|false

Exceptions

FileNotFoundException

in UploadedFile at line 102
string clientExtension()

Get the file's extension supplied by the client.

Return Value

string

in UploadedFile at line 110
static UploadedFile createFromBase(UploadedFile $file, bool $test = false)

Create a new file instance from a base instance.

Parameters

UploadedFile $file
bool $test

Return Value

UploadedFile

in UploadedFile at line 124
protected array parseOptions(array|string $options)

Parse and format the given options.

Parameters

array|string $options

Return Value

array

in UploadedFile at line 136
static void flushState()

Flush all static state.

Return Value

void

at line 38
__construct(string $name, mixed $tempFile)

Create a new file instance.

Parameters

string $name
mixed $tempFile

at line 55
static File create(string $name, string|int $kilobytes = 0)

Create a new fake file.

Parameters

string $name
string|int $kilobytes

Return Value

File

at line 63
static File createWithContent(string $name, string $content)

Create a new fake file with content.

Parameters

string $name
string $content

Return Value

File

at line 71
static File image(string $name, int $width = 10, int $height = 10)

Create a new fake image.

Parameters

string $name
int $width
int $height

Return Value

File

at line 79
File size(int $kilobytes)

Set the "size" of the file in kilobytes.

Parameters

int $kilobytes

Return Value

File

at line 89
int getSize()

Get the size of the file.

Return Value

int

at line 97
File mimeType(string $mimeType)

Set the MIME type for the file.

Parameters

string $mimeType

Return Value

File

at line 107
string getMimeType()

Get the MIME type of the file.

Return Value

string

at line 115
protected string tempFilePath()

Get the path to the temporary file.

Return Value

string