SplFileObject::__construct

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

SplFileObject::__construct — Construye un nuevo objeto de fichero

Descripción

public SplFileObject::__construct(
    string $filename,
    string $open_mode = "r",
    bool $use_include_path = false,
    resource $context = ?
)

Construye un nuevo objeto de fichero.

Parámetros

filename: El fichero a leer.

Sugerencia
Se puede emplear un URL como nombre de fichero con esta función si las envolturas de fopen han sido activadas. Véase fopen() para más información de cómo especificar el nombre de fichero. Véanse las Protocolos y Envolturas soportados; continen enlaces con información sobre las diferentes capacidades que tienen las envolturas, notas sobre su empleo, e información de cualquier variable predefinida que podría proporcionarse.
open_mode: El modo en el que abrir el fichero. Véase fopen() para una lista de los modos permitidos.
use_include_path: Si se va a buscar filename en el include_path.
context: Un contexto válido creado con stream_context_create().

Valores devueltos

No devuelve ningún valor.

Errores/Excepciones

Lanza una RuntimeException si filename no se puede abrir.

Ejemplos

Ejemplo #1 Ejemplo de SplFileObject::__construct()

Este ejemplo abre el fichero actual y recorre su contenido, línea por línea.


<?php
$fichero = new SplFileObject(__FILE__);
foreach ($fichero as $num_línea => $línea) {
    echo "La línea $num_línea es $línea";
}
?>

El resultado del ejemplo sería algo similar a:

La línea 0 es <?php
La línea 1 es $fichero = new SplFileObject(__FILE__);
La línea 2 es foreach ($fichero as $num_línea => $línea) {
La línea 3 es     echo "La línea $num_línea es $línea";
La línea 4 es }
La línea 5 es ?>

Ver también

SplFileInfo::openFile() - Obtiene un objeto SplFileObject para el fichero
fopen() - Abre un fichero o un URL

＋add a note

User Contributed Notes 2 notes

down

KEINOS at blog.keinos.com ¶

6 years ago


When using URL as a filename, such as "http://..." or "php://stdin", and also have the fopen wappers on, and you get a 'RuntimeException' error, try using "NoRewindIterator" class to a SplFileObject instance.

<?php
$url = 'http://sample.com/data.csv';
$file = new NoRewindIterator( new SplFileObject( $url ) );
foreach ($file as $line_num => $line) {
    echo "Line $line_num is $line";
}
?>

While opening a file, a rewind method will be called, but these URL iterators cannot be rewind, so you'll get a "Fatal error: Uncaught exception 'RuntimeException' with message 'Cannot rewind file ...'" error.

down

-1

majna ¶

8 years ago


(PHP >= 5.3) If filename is a directory, a LogicException will be thrown: "Cannot use SplFileObject with directories"

＋add a note