file
Manual de PHP
AnteriorSiguiente

file

(PHP 3, PHP 4, PHP 5)

file -- Lee un archivo entero hacia una matriz

Descripci贸n

array file ( string nombre_archivo [, int usar_ruta_inclusion [, resource contexto]] )

Funci贸n id茅ntica a file_get_contents(), excepto que file() devuelve el archivo en una matriz. Cada elemento de la matriz corresponde a una l铆nea en el archivo, con el salto de l铆nea aun incluido. Si ocurre un fallo, file() devuelve FALSE.

Es posible usar el par谩metro opcional usar_ruta_inclusion, y definirlo como "1", si desea buscar por el archivo en include_path, tambi茅n.

<?php
// Obtiene un archivo en una matriz. En este ejemplo usaremos HTTP
// para obtener el codigo fuente HTML de una URL.

$lineas = file('http://www.example.com/');

// Recorrer nuestra matriz, mostrar el codigo HTML como codigo fuente
// HTML, y los numeros de linea tambien.
foreach ($lineas as $linea_num => $linea) {
    echo "L&iacute;nea #<b>{$linea_num}</b> : " . htmlspecialchars($linea) . "<br />\n";
}

// Otro ejemplo, obtengames una pagina web como una cadena. Vea
// tambien file_get_contents().
$html = implode('', file('http://www.example.com/'));
?>

Sugerencia: Puede usar una URL como nombre de archivo con esta funci贸n si los fopen wrappers han sido activados. Consulte fopen() para m谩s detalles sobre c贸mo especificar el nombre de fichero y Ap茅ndice M una lista de protocolos URL soportados

Nota: Cada l铆nea en la matriz resultante incluye el final de l铆nea, as铆 que aun necesita usar rtrim() si no quiere conservar el final de l铆nea.

Nota: Si sufre problemas con PHP no reconociendo los finales de l铆nea cuando lee archivos creados en un Macintosh (o leyendo archivos sobre uno), puede probar activando la opci贸n de configuraci贸n auto_detect_line_endings.

Nota: A partir de PHP 4.3.0, puede usar file_get_contents() para devolver el contenido de un archivo como una cadena.

En PHP 4.3.0 file(), se volvi贸 una funci贸n segura con material binario.

Nota: Soporte de contexto fue introducido con PHP.5.0.0.

Aviso

Cuando se usa SSL, Microsoft IIS violara el protocolo, cerrando la conexion sin mandar un indicador close_notify. PHP avisara de esto con este mensaje "SSL: Fatal Protocol Error", cuando llegue al final de los datos. Una solucion a este problema es bajar el nivel de aviso de errores del sistema para que no incluya advertencias. PHP 4.3.7 y versiones posteriores detectan servidores IIS con este problema y suprime la advertencia. Si usais la funcion fsockopen() para crear un socket ssl://, tendreis que suprimir la advertencia explicitamente.

Vea tambi茅n readfile(), fopen(), fsockopen(), popen(), file_get_contents(), y include().

AnteriorInicioSiguiente
file_put_contentsSubirfileatime