GlobIterator

class GlobIterator extends FilesystemIterator implements Countable (View source)

Iterates through a file system in a similar fashion to glob.

Constants

CURRENT_MODE_MASK

CURRENT_AS_PATHNAME

CURRENT_AS_FILEINFO

CURRENT_AS_SELF

KEY_MODE_MASK

KEY_AS_PATHNAME

FOLLOW_SYMLINKS

KEY_AS_FILENAME

NEW_CURRENT_AND_KEY

SKIP_DOTS

UNIX_PATHS

OTHER_MODE_MASK

Methods

__construct($pattern, int $flags = FilesystemIterator::KEY_AS_PATHNAME | FilesystemIterator::CURRENT_AS_FILEINFO)

Construct a directory using glob

string
getPath()

Gets the path without filename

from  SplFileInfo
string
getFilename()

Gets the filename

from  SplFileInfo
string
getExtension()

Gets the file extension

from  SplFileInfo
string
getBasename(string $suffix = '')

Gets the base name of the file

from  SplFileInfo
string
getPathname()

Gets the path to the file

from  SplFileInfo
int|false
getPerms()

Gets file permissions

from  SplFileInfo
int|false
getInode()

Gets the inode for the file

from  SplFileInfo
int|false
getSize()

Gets file size

from  SplFileInfo
int|false
getOwner()

Gets the owner of the file

from  SplFileInfo
int|false
getGroup()

Gets the file group

from  SplFileInfo
int|false
getATime()

Gets last access time of the file

from  SplFileInfo
int|false
getMTime()

Gets the last modified time

from  SplFileInfo
int|false
getCTime()

Gets the inode change time

from  SplFileInfo
string|false
getType()

Gets file type

from  SplFileInfo
bool
isWritable()

Tells if the entry is writable

from  SplFileInfo
bool
isReadable()

Tells if file is readable

from  SplFileInfo
bool
isExecutable()

Tells if the file is executable

from  SplFileInfo
bool
isFile()

Tells if the object references a regular file

from  SplFileInfo
bool
isDir()

Tells if the file is a directory

from  SplFileInfo
bool
isLink()

Tells if the file is a link

from  SplFileInfo
string|false
getLinkTarget()

Gets the target of a link

from  SplFileInfo
string|false
getRealPath()

Gets absolute path to file

from  SplFileInfo
SplFileInfo
getFileInfo(T> $class = null)

Gets an SplFileInfo object for the file

from  SplFileInfo
SplFileInfo|null
getPathInfo(T> $class = null)

Gets an SplFileInfo object for the path

from  SplFileInfo
SplFileObject
openFile(string $mode = 'r', bool $useIncludePath = false, resource $context = null)

Gets an SplFileObject object for the file

from  SplFileInfo
void
setFileClass(T> $class = SplFileObject::class)

Sets the class name used with SplFileInfo::openFile

from  SplFileInfo
void
setInfoClass(T> $class = SplFileInfo::class)

Sets the class used with getFileInfo and getPathInfo

from  SplFileInfo
string
__toString()

Returns the path to the file as a string

from  SplFileInfo
void
_bad_state_ex()

No description

from  SplFileInfo
__wakeup()

No description

from  SplFileInfo
array
__debugInfo()

No description

from  SplFileInfo
bool
isDot()

Determine if current DirectoryIterator item is '.' or '..'

from  DirectoryIterator
void
rewind()

Rewinds back to the beginning

from  FilesystemIterator
bool
valid()

Check whether current DirectoryIterator position is a valid file

from  DirectoryIterator
mixed
key()

Retrieve the key for the current file

from  FilesystemIterator
mixed
current()

The current file

from  FilesystemIterator
void
next()

Move to the next file

from  FilesystemIterator
void
seek(int $offset)

Seek to a DirectoryIterator item

from  DirectoryIterator
int
getFlags()

Get the handling flags

from  FilesystemIterator
void
setFlags(int $flags)

Sets handling flags

from  FilesystemIterator
int
count()

Get the number of directories and files

Details

at line 596
__construct($pattern, int $flags = FilesystemIterator::KEY_AS_PATHNAME | FilesystemIterator::CURRENT_AS_FILEINFO)

Construct a directory using glob

Parameters

$pattern
int $flags [optional]

in SplFileInfo at line 30
string getPath()

Since: 5.1.2

Gets the path without filename

Return Value

string

the path to the file.

in SplFileInfo at line 39
string getFilename()

Since: 5.1.2

Gets the filename

Return Value

string

The filename.

in SplFileInfo at line 49
string getExtension()

Since: 5.3.6

Gets the file extension

Return Value

string

a string containing the file extension, or an empty string if the file has no extension.

in SplFileInfo at line 61
string getBasename(string $suffix = '')

Since: 5.2.2

Gets the base name of the file

Parameters

string $suffix

[optional]

Optional suffix to omit from the base name returned.

Return Value

string

the base name without path information.

in SplFileInfo at line 70
string getPathname()

Since: 5.1.2

Gets the path to the file

Return Value

string

The path to the file.

in SplFileInfo at line 79
int|false getPerms()

Since: 5.1.2

Gets file permissions

Return Value

int|false

The file permissions on success, or FALSE on failure.

in SplFileInfo at line 89
int|false getInode()

Since: 5.1.2

Gets the inode for the file

Return Value

int|false

The inode number for the filesystem object on success, or FALSE on failure.

Exceptions

RuntimeException

in SplFileInfo at line 99
int|false getSize()

Since: 5.1.2

Gets file size

Return Value

int|false

The filesize in bytes on success, or FALSE on failure.

Exceptions

RuntimeException

in SplFileInfo at line 109
int|false getOwner()

Since: 5.1.2

Gets the owner of the file

Return Value

int|false

The owner id in numerical format on success, or FALSE on failure.

Exceptions

RuntimeException

in SplFileInfo at line 119
int|false getGroup()

Since: 5.1.2

Gets the file group

Return Value

int|false

The group id in numerical format on success, or FALSE on failure.

Exceptions

RuntimeException

in SplFileInfo at line 129
int|false getATime()

Since: 5.1.2

Gets last access time of the file

Return Value

int|false

The time the file was last accessed on success, or FALSE on failure.

Exceptions

RuntimeException

in SplFileInfo at line 138
int|false getMTime()

Since: 5.1.2

Gets the last modified time

Return Value

int|false

The last modified time for the file, in a Unix timestamp on success, or FALSE on failure.

in SplFileInfo at line 148
int|false getCTime()

Since: 5.1.2

Gets the inode change time

Return Value

int|false

The last change time, in a Unix timestamp on success, or FALSE on failure.

Exceptions

RuntimeException

in SplFileInfo at line 160
string|false getType()

Since: 5.1.2

Gets file type

Return Value

string|false

A string representing the type of the entry. May be one of file, link, dir, block, fifo, char, socket, or unknown, or FALSE on failure. May be one of file, link, or dir

Exceptions

RuntimeException

in SplFileInfo at line 169
bool isWritable()

Since: 5.1.2

Tells if the entry is writable

Return Value

bool

true if writable, false otherwise;

in SplFileInfo at line 178
bool isReadable()

Since: 5.1.2

Tells if file is readable

Return Value

bool

true if readable, false otherwise.

in SplFileInfo at line 187
bool isExecutable()

Since: 5.1.2

Tells if the file is executable

Return Value

bool

true if executable, false otherwise.

in SplFileInfo at line 196
bool isFile()

Since: 5.1.2

Tells if the object references a regular file

Return Value

bool

true if the file exists and is a regular file (not a link), false otherwise.

in SplFileInfo at line 205
bool isDir()

Since: 5.1.2

Tells if the file is a directory

Return Value

bool

true if a directory, false otherwise.
Since: 5.1.2

Tells if the file is a link

Return Value

bool

true if the file is a link, false otherwise.

in SplFileInfo at line 224
string|false getLinkTarget()

Since: 5.2.2

Gets the target of a link

Return Value

string|false

The target of the filesystem link on success, or FALSE on failure.

Exceptions

RuntimeException

in SplFileInfo at line 233
string|false getRealPath()

Since: 5.2.2

Gets absolute path to file

Return Value

string|false

the path to the file, or FALSE if the file does not exist.

in SplFileInfo at line 246
SplFileInfo getFileInfo(T> $class = null)

Since: 5.1.2

Gets an SplFileInfo object for the file

Parameters

T> $class

[optional]

Name of an SplFileInfo derived class to use.

Return Value

SplFileInfo

An SplFileInfo object created for the file.

in SplFileInfo at line 259
SplFileInfo|null getPathInfo(T> $class = null)

Since: 5.1.2

Gets an SplFileInfo object for the path

Parameters

T> $class

[optional]

Name of an SplFileInfo derived class to use.

Return Value

SplFileInfo|null

A SplFileInfo object for the parent path of the file on success, or NULL on failure.

in SplFileInfo at line 278
SplFileObject openFile(string $mode = 'r', bool $useIncludePath = false, resource $context = null)

Since: 5.1.2

Gets an SplFileObject object for the file

Parameters

string $mode

[optional]

The mode for opening the file. See the fopen documentation for descriptions of possible modes. The default is read only.

bool $useIncludePath

[optional]

resource $context

[optional]

Return Value

SplFileObject

The opened file as an SplFileObject object.

Exceptions

RuntimeException

in SplFileInfo at line 295
void setFileClass(T> $class = SplFileObject::class)

Since: 5.1.2

Sets the class name used with SplFileInfo::openFile

Parameters

T> $class

[optional]

The class name to use when openFile() is called.

Return Value

void

in SplFileInfo at line 308
void setInfoClass(T> $class = SplFileInfo::class)

Since: 5.1.2

Sets the class used with getFileInfo and getPathInfo

Parameters

T> $class

[optional]

The class name to use.

Return Value

void

in SplFileInfo at line 317
string __toString()

Since: 5.1.2

Returns the path to the file as a string

Return Value

string

Returns string representation of the object that implements this interface (and/or "__toString" magic method).

in SplFileInfo at line 320
final void _bad_state_ex()

No description

Return Value

void

in SplFileInfo at line 323
__wakeup()

No description

in SplFileInfo at line 329
array __debugInfo()

Since: 7.4

No description

Return Value

array

in DirectoryIterator at line 355
bool isDot()

Determine if current DirectoryIterator item is '.' or '..'

Return Value

bool

true if the entry is . or .., otherwise false

in FilesystemIterator at line 446
void rewind()

Rewinds back to the beginning

Return Value

void

Any returned value is ignored.

in DirectoryIterator at line 371
bool valid()

Check whether current DirectoryIterator position is a valid file

Return Value

bool

The return value will be casted to boolean and then evaluated. Returns true on success or false on failure.

in FilesystemIterator at line 462
mixed key()

Retrieve the key for the current file

Return Value

mixed

TKey on success, or null on failure.

in FilesystemIterator at line 471
mixed current()

The current file

Return Value

mixed

Can return any type.

in FilesystemIterator at line 454
void next()

Move to the next file

Return Value

void

Any returned value is ignored.

in DirectoryIterator at line 406
void seek(int $offset)

Seek to a DirectoryIterator item

Parameters

int $offset

The position to seek to.

Return Value

void

in FilesystemIterator at line 479
int getFlags()

Get the handling flags

Return Value

int

The integer value of the set flags.

in FilesystemIterator at line 491
void setFlags(int $flags)

Sets handling flags

Parameters

int $flags

The handling flags to set. See the FilesystemIterator constants.

Return Value

void

at line 607
int count()

Get the number of directories and files

Return Value

int

The custom count as an integer.

The return value is cast to an integer.