fopen

Lista de parámetros

nombre_archivo

Si nombre_archivo es de la forma "esquema://...", se asume que es una URL y PHP buscará por un gestor de protocolo (también conocido como envoltura) para tal esquema. Si no hay envolturas registradas para ese protocolo, PHP emitirá una noticia para ayudarle a rastrear problemas potenciales en su script, y luego continúa como si nombre_archivo especificara un archivo corriente.

Si PHP decide que nombre_archivo hace referencia a un archivo local, entonces intentará abrir una secuencia sobre ese archivo. El archivo debe ser asequible para PHP, así que debe asegurarse de que los permisos de acceso del archivo sean los apropiados. Si tiene habilitado safe mode, o open_basedir, pueden aplicarse restricciones adicionales.

Si PHP decide que nombre_archivo hace referencia a un protocolo registrado, y ese protocolo está registrado como una URL de red, PHP verificará que allow_url_fopen se encuentre habilitado. Si no es así, PHP emitirá una advertencia y la llamada a fopen fallará.

Note: La lista de protocolos soportados puede encontrarse en Lista de Protocolos/Envolturas Soportadas. Algunos protocolos (también conocidos como envolturas) soportan un contexto u opciones php.ini. Refiérase a la página específica del protocolo en uso para una lista de opciones que pueden definirse. (p.ej. el valor php.ini user_agent usado por la envoltura http)

En la plataforma Windows, tenga cuidado de escapar cualquier barra invertida usada en la ruta al archivo, o use barras hace adelante.

<?php
$gestor = fopen("c:\\datos\\info.txt", "r");
?>

modo

El parámetro modo especifica el tipo de acceso que requiere para la secuencia. Puede ser cualquiera de los siguientes valores:

Una lista de modos posibles para fopen() usando modo

modo	Descripción
'r'	Apertura para sólo lectura; ubica el apuntador de archivo al comienzo del mismo.
'r+'	Apertura para lectura y escritura; ubica el apuntador de archivo al comienzo del mismo.
'w'	Apertura para sólo escritura; ubica el apuntador de archivo al comienzo de éste y lo trunca a una longitud de cero. Si el archivo no existe, intenta crearlo.
'w+'	Apertura para lectura y escritura; ubica el apuntador de archivo al comienzo de éste y lo trunca a una longitud cero. Si el archivo no existe, intenta crearlo.
'a'	Apertura para sólo escritura; ubica el apuntador de archivo al final del mismo. Si el archivo no existe, intenta crearlo.
'a+'	Apertura para lectura y escritura; ubica el apuntador de archivo al final del mismo. Si el archivo no existe, intenta crearlo.
'x'	Creación y apertura para sólo escritura; ubica el apuntador de archivo al comienzo de éste. Si el archivo ya existe, la llamada a fopen() fallará devolviendo FALSE y generando un error de nivel E_WARNING. Si el archivo no existe, intenta crearlo. Esto es equivalente a especificar las banderas O_EXCL|O_CREAT en la llamada de sistema open(2) interna.
'x+'	Creación y apertura para lectura y escritura; ubica el apuntador de archivo al comienzo de éste. Si el archivo ya existe, la llamada a fopen() fallará devolviendo FALSE y generando un error de nivel E_WARNING. Si el archivo no existe, intenta crearlo. Esto es equivalente a especificar las banderas O_EXCL|O_CREAT en la llamada de sistema open(2) interna.

Note: Diferentes familias de sistemas operativos tienen diferentes convenciones sobre el final-de-línea. Cuando escribe a un archivo de texto y desea insertar un salto de línea, necesita usar los caracteres correctos de final-de-línea para su sistema operativo. Los sistemas basados en Unix usan \n como el caracter de final de línea, los sistemas basados en Windows usan \r\n como los caracteres de final de línea, y los sistemas basados en Macintosh usan \r como el caracter de final de línea.
Si usa los caracteres de final de línea equivocados cuando crea sus archivos, puede que encuentre que otras aplicaciones que abren esos archivos lucirán "extraño".
Windows ofrece una bandera de traducción de modo-texto ('t') la cual traducirá transparentemente \n a \r\n cuando trabaje con el archivo. En contraste, también puede usar 'b' para forzar el modo binario, el cual no traduce sus datos. Para usar estas banderas, indique 'b' o 't' como el último caracter del parámetro modo .
El modo de traducción predeterminado depende de la SAPI y la versión de PHP que usa, así que es recomendable especificar siempre la bandera apropiada por razones de portabilidad. Debería usar el modo 't' si trabaja con archivos de texto-plano y usa \n para delimitar los finales de línea en su script, pero espera que sus archivos sean legibles en aplicaciones como el bloc de notas. Debería usar el modo 'b' en todos los demás casos.
Si no especifica la bandera 'b' cuando trabaja con archivos binarios, puede experimentar problemas con sus datos, incluyendo archivos de imagen corruptos y problemas extraños con los caracteres \r\n.

Note: Por razones de portabilidad, es bastante recomendable que siempre use la bandera 'b' cuando abre archivos con fopen().

Note: Nuevamente, por razones de portabilidad, es bastante recomendable que re-escriba el código que usa o depende del modo 't', de modo que use los finales de línea correctos y el modo 'b' en su lugar.

usar_ruta_inclusion

El tercer parámetro, opcional, usar_ruta_inclusion puede definirse como '1' o TRUE si desea buscar por el archivo en include_path, también.

contexto

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