file_get_contents

(PHP 4 >= 4.3.0, PHP 5)

file_get_contents -- Lee un archivo entero en una cadena

Descripción

string file_get_contents ( string nombre_archivo [, bool usar_ruta_inclusion [, resource contexto]] )

Función idéntica a file(), con la excepción de que file_get_contents() devuelve el archivo en una cadena. En caso de fallo, file_get_contents() devolverá FALSE.

file_get_contents() es el modo preferido para leer los contenidos de un archivo en una cadena. Esta función usa las técnicas de asignación de memoria que soporte su SO para incrementar su rendimiento.

Ejemplo 1. Uso de file_get_contents() con una URI

Si está abriendo una URI con caracteres especiales, como espacios, necesita codificar la URI con urlencode().

<?php
$url
= 'http://example.com/con caracteres chistosos';
list(
$protocolo, $uri) = split('//', $url);
$html = file_get_contents($protocolo . '//' . urlencode($uri));
?>

Nota: Esta función es segura binariamente.

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 L una lista de protocolos URL soportados

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 fgets(), file(), fread(), include(), y readfile().