SplFileInfo::openFile

(PHP 5 >= 5.1.2)

SplFileInfo::openFileGets an SplFileObject object for the file

Description

public SplFileObject SplFileInfo::openFile ([ string $open_mode = r [, bool $use_include_path = false [, resource $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

open_mode

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

use_include_path

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).

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