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 [, int desplazamiento [, int long_max]]]] )

Función idéntica a file(), con la excepción de que file_get_contents() devuelve el archivo en una cadena, comenzando en el desplazamiento especificado y hasta long_max bytes. 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.

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

Nota: El parámetro contexto puede obviarse usando NULL.

Registro de cambios

VersiónDescripción
5.0.0 Se agregó soporte para contextos.
5.1.0 Se agregaron los parámetros desplazamiento y long_max.

Notes

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

Ver también

file()
fgets()
fread()
readfile()
file_put_contents()
stream_get_contents()

Hosting by: hurra.com
Generated: 2007-01-26 18:00:58