Dir

Represent dir.

class Dir

Properties

path

Store the path.

protected string $path

backend

Store the backend.

protected Backend $backend

manager

Store the manager.

protected Manager $manager

files

public array $files

allowHidden

Store the allow hidden.

protected bool $allowHidden

__media_uri

public URL $__media_uri

relativePath

public string $relativePath

Methods

__construct

Create a new instance.

public __construct(string $path, ?Manager $manager, ?string $relativePath): void

Parameters

Parameter	Type	Description
$path	string
$manager	Manager
$relativePath	string

__toString

Convert the instance to a string representation.

public __toString(): string

backend

Execute the backend operation for this file component.

public backend(): string

getManager

Get the manager.

public getManager(): Manager

setMeta

public setMeta(array $values): bool

Parameters

Parameter	Type	Description
$values	array

getMeta

Get the meta.

public getMeta(?string $key): mixed

Parameters

Parameter	Type	Description
$key	string

toString

To string.

public toString(): string

path

Execute the path operation for this file component.

public path(?string $suffix): string

Parameters

Parameter	Type	Description
$suffix	string

fullpath

Execute the fullpath operation for this file component.

public fullpath(?string $suffix): string

Parameters

Parameter	Type	Description
$suffix	string

relativepath

Get the relative path of the directory.

public relativepath(null $path): string

If the file was returned from a Hazaar\File\Dir object, then it will have a stored relative path. Otherwise any file/path can be provided in the form of another [[Hazaar\File\ object, Hazaar\File\Dir object, or string path, and the relative path to the file will be returned.

Parameters

Parameter	Type	Description
$path	null

setRelativePath

Set the relative path.

public setRelativePath(string $path): void

Parameters

Parameter	Type	Description
$path	string

realpath

Resolve a logical backend path to its canonical remote representation.

public realpath(): string

dirname

Execute the dirname operation for this file component.

public dirname(): string

name

Execute the name operation for this file component.

public name(): string

extension

Execute the extension operation for this file component.

public extension(): string

basename

Execute the basename operation for this file component.

public basename(): string

size

Execute the size operation for this file component.

public size(): int

type

Execute the type operation for this file component.

public type(): string

exists

Determine whether a path exists in backend storage.

public exists(?string $filename): bool

Parameters

Parameter	Type	Description
$filename	string

isReadable

Check whether the instance readable.

public isReadable(): bool

isWritable

Check whether the instance writable.

public isWritable(): bool

isFile

Check whether the instance file.

public isFile(): bool

isDir

Check whether the instance dir.

public isDir(): bool

isLink

Check whether the instance link.

public isLink(): bool

parent

Execute the parent operation for this file component.

public parent(): Dir

ctime

Execute the ctime operation for this file component.

public ctime(): int

mtime

Execute the mtime operation for this file component.

public mtime(): int

touch

Create a file or update modification time for a backend path.

public touch(): bool

atime

Execute the atime operation for this file component.

public atime(): int

allowHidden

Allow hidden.

public allowHidden(bool $toggle = true): void

Parameters

Parameter	Type	Description
$toggle	bool

create

Execute the create operation for this file component.

public create(bool $recursive): bool

Parameters

Parameter	Type	Description
$recursive	bool

rename

Execute the rename operation for this file component.

public rename(string $newname): bool

Parameters

Parameter	Type	Description
$newname	string

delete

Delete the directory, optionally removing all it's contents.

public delete(bool $recursive): bool

Executing this method will simply delete or "unlink" the directory. Normally it must be empty to succeed. However specifying the $recursive parameter as TRUE will delete everything inside the directory, recursively (obviously).

Parameters

Parameter	Type	Description
$recursive	bool

unlink

File::unlink() compatible delete that removes dir and all contents (ie: recursive).

public unlink(): bool

isEmpty

Check whether the instance empty.

public isEmpty(): bool

Empty a directory of all it's contents.

public (boolean $includeHidden): void

This is the same as calling delete(true) except that the directory itself is not deleted.

By default hidden files are not deleted. This is for protection. You can choose to delete them as well by setting $includeHidden to true.

Parameters

Parameter	Type	Description
$includeHidden	boolean	also delete hidden files

close

Execute the close operation for this file component.

public close(): void

read

Read and return file contents from backend storage.

public read(?string $regexFilter): File

Parameters

Parameter	Type	Description
$regexFilter	string

rewind

Execute the rewind operation for this file component.

public rewind(): void

find

Find files in the current path optionally recursing into sub directories.

public find(string $pattern, bool $showHidden, bool $caseSensitive = true, ?int $depth): void

Parameters

Parameter	Type	Description
$pattern	string	The pattern to match against. This can be either a wildcard string, such as "*.txt" or a regex pattern. Regex is detected if the string is longer than a single character and first character is the same as the last.
$showHidden	bool
$caseSensitive	bool	if TRUE character case will be honoured
$depth	int	Recursion depth. NULL will always recurse. 0 will prevent recursion.

copyTo

Copy to.

public copyTo(string $target, bool $recursive, null $transportCallback): bool

Parameters

Parameter	Type	Description
$target	string
$recursive	bool
$transportCallback	null

get

Return the requested value from the current file abstraction.

public get(string $child, bool $forceDir): File

Parameters

Parameter	Type	Description
$child	string
$forceDir	bool

getDir

Get the dir.

public getDir(string $path): Dir

Parameters

Parameter	Type	Description
$path	string

mimeContentType

Mime content type.

public mimeContentType(): string

dir

Execute the dir operation for this file component.

public dir(?string $child): Dir

Parameters

Parameter	Type	Description
$child	string

toArray

public toArray(): void

put

Copy a file object into the current directory.

public put(File $file, bool $overwrite): File

Parameters

Parameter	Type	Description
$file	File	The file to put in this directory
$overwrite	bool

download

Download a file from a URL directly to the directory and return a new File object.

public download(mixed $sourceUrl, int $timeout = 60): void

This is useful for download large files as this method will write the file directly to storage. Currently, only local storage is supported as this uses OS file access.

Parameters

Parameter	Type	Description
$sourceUrl	mixed	The source URL of the file to download
$timeout	int	The download timeout after which an exception will be thrown

mediaURL

Media u r l.

public mediaURL(null $setPath): ?URL

Parameters

Parameter	Type	Description
$setPath	null

sync

Execute the sync operation for this file component.

public sync(Dir $source, bool $recursive, null $progressCallback, int $maxRetries = 3): bool

Parameters

Parameter	Type	Description
$source	Dir
$recursive	bool
$progressCallback	null
$maxRetries	int

write

Write content to a backend path and return bytes written.

public write(string $file, string $bytes, ?string $contentType): ?int

Parameters

Parameter	Type	Description
$file	string
$bytes	string
$contentType	string

callSyncCallback

Call sync callback.

private callSyncCallback(): bool

---

Generated by Hazaar API Doc Generator on Tue, 21 Apr 2026 04:00:24 +0000