SplFileInfo::openFile

Gets an SplFileObject object for the file

Description

public SplFileObject SplFileInfo::openFile(string $mode = "r", bool $useIncludePath = false, resourcenull $context = null)

Creates an SplFileObject object of the file. This is useful because SplFileObject contains additional methods for manipulating the file whereas SplFileInfo is only useful for gaining information, like whether the file is writable.

Parameters

mode

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

useIncludePath

When set to true, the filename is also searched for within the include_path

context

Refer to the context section of the manual for a description of contexts.

Return Values

The opened file as an SplFileObject object.

Errors/Exceptions

A RuntimeException if the file cannot be opened (e.g. insufficient access rights).

Changelog

Version Description
8.0.0 context is now nullable.

Examples

Example #1 SplFileInfo::openFile example

<?php
$fileinfo = new SplFileInfo('/tmp/foo.txt');

if ($fileinfo->isWritable()) {

    $fileobj = $fileinfo->openFile('a');

    $fileobj->fwrite("appended this sample text");
}
?>

See Also

  • SplFileObject
  • stream_context_create
  • fopen