Funciones del Sistema de Archivos

Introducción

Requisitos

No se requieren bibliotecas externas para compilar esta extensión, pero si desea que PHP ofrezca soporte para LFS (archivos grandes) en Linux, entonces necesita tener una versión reciente de glibc y necesita compilar PHP con las siguientes banderas del compilador: -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64.

Instalación

No se necesita ninguna instalación para usar estas funciones, son parte del núcleo de PHP.

Configuración en tiempo de ejecución

El comportamiento de estas funciones está afectado por los valores definidos en php.ini.

**Opciones de Configuración del Sistema de Archivos y Secuencias**
Nombre	Predeterminado	Modificable	Cambios
allow_url_fopen	"1"	PHP_INI_ALL	PHP_INI_ALL en PHP <= 4.3.4. PHP_INI_SYSTEM en PHP < 6. Disponible desde PHP 4.0.4.
allow_url_include	"0"	PHP_INI_ALL	PHP_INI_SYSTEM in PHP 5. Disponible desde PHP 5.2.0.
user_agent	NULL	PHP_INI_ALL	Disponible desde PHP 4.3.0.
default_socket_timeout	"60"	PHP_INI_ALL	Disponible desde PHP 4.3.0.
from	""	PHP_INI_ALL
auto_detect_line_endings	"0"	PHP_INI_ALL	Disponible desde PHP 4.3.0.

A continuación se presenta una corta explicación de las directivas de configuración.

allow_url_fopen boolean

Esta opción habilita las envolturas fopen tipo URL que le permiten acceder a objetos URL como archivos. Existen envolturas predeterminadas para el acceso de archivos remotos usando los protocolos ftp o http, algunas extensiones como zlib pueden registrar envolturas adicionales.

Note: Este parámetro puede ser definido únicamente en php.ini debido a razones de seguridad.

Note: Esta opción fue introducida inmediatamente después del lanzamiento de la versión 4.0.3. Para versiones anteriores a, e incluyendo la 4.0.3, solo puede deshabilitar esta característica en tiempo de compilación usando el parámetro de configuración --disable-url-fopen-wrapper .

Warning

En versiones de windows anteriores a PHP 4.3.0, las siguientes funciones no soportan el acceso de archivos remotos: include(), include_once(), require(), require_once() y las funciones imagecreatefromXXX en la extensión Imágenes.

allow_url_include boolean

Esta opción permite el uso de envolturas fopen con soporte URL con las siguientes funciones: include(), include_once(), require(), require_once().

Note: Este parámetro requiere que se habilite allow_url_fopen.

user_agent string

Definir el agente de usuario que envía PHP.

default_socket_timeout integer

Tiempo de espera predeterminado (en segundos) para secuencias basadas en sockets.

Note: Esta opción de configuración fue introducida en PHP 4.3.0

from string

Definir la contraseña de ftp anónimo (su dirección de correo electrónico).

auto_detect_line_endings boolean

Cuando está habilitada esta opción, PHP examina los datos leídos por fgets() y file() para ver si está usando convenciones de final de líneo tipo Unix, MS-Dos o Macintosh.

Esto le permite a PHP interoperar con sistemas Macintosh, pero tiene un valor predeterminado de Off, ya que hay un impacto ligero de rendimiento cuando se detectan las convenciones EOL para la primera línea, y también porque las personas que usen retornos de carro como separador de elementos bajo sistemas Unix percibirían un comportamiento que no es compatible con versiones anteriores.

Note: Esta opción de configuración fue introducida en PHP 4.3.0

Tipos de recursos

Constantes predefinidas

Estas constantes están definidas por esta extensión y estarán disponibles solamente cuando la extensión ha sido o bien compilada dentro de PHP o grabada dinámicamente en tiempo de ejecución.

GLOB_BRACE (integer)
GLOB_ONLYDIR (integer)
GLOB_MARK (integer)
GLOB_NOSORT (integer)
GLOB_NOCHECK (integer)
GLOB_NOESCAPE (integer)
PATHINFO_DIRNAME (integer)
PATHINFO_BASENAME (integer)
PATHINFO_EXTENSION (integer)
PATHINFO_FILENAME (integer): Desde PHP 5.2.0.
FILE_USE_INCLUDE_PATH (integer): Busca por nombre_archivo en include_path (desde PHP 5).
FILE_APPEND (integer): Anexar contenido al archivo existente.
FILE_IGNORE_NEW_LINES (integer): Elimina caracteres de final de línea (EOL) (desde PHP 5).
FILE_SKIP_EMPTY_LINES (integer): Salta líneas vacías (desde PHP 5).
FILE_BINARY (integer): Modo binario (desde PHP 6).
FILE_TEXT (integer): Modo de texto (desde PHP 6).

Ver también

Para funciones relacionadas, vea también las secciones Directorio y Ejecución de Programas.

Para una lista de las varias envolturas de URL que pueden ser usadas como archivos remotos, y su explicación, vea también Lista de Protocolos/Envolturas Soportadas.

basename — Devuelve la parte del path correspondiente al nombre del archivo
chgrp — Cambia el grupo de un archivo
chmod — Cambia permisos de un archivo
chown — Cambia el propietario de un archivo
clearstatcache — Limpia la cache de estado de un archivo
copy — Copia un archivo
delete — Vea unlink o unset
dirname — Devuelve la parte del path correspondiente al directorio
disk_free_space — Devuelve el espacio disponible en el directorio
disk_total_space — Devuelve el tamaño total de un directorio
diskfreespace — Alias de disk_free_space
fclose — Cierra el apuntador a un archivo abierto
feof — Verifica si el apuntador a un archivo está al final del archivo
fflush — Vacía la salida hacia un archivo
fgetc — Obtiene un caracter del archivo apuntado
fgetcsv — Obtiene una linea del archivo apuntado y extrae los campos CSV
fgets — Obtiene una línea desde el apuntador de archivo
fgetss — Obtiene una lína desde el apuntador de archivo y elimina las etiquetas HTML
file_exists — Verifica si un archivo o directorio existe
file_get_contents — Lee un archivo entero en una cadena
file_put_contents — Escribir una cadena sobre un archivo
file — Lee un archivo entero hacia una matriz
fileatime — Obtiene la hora del último acceso al archivo
filectime — Obtiene la hora de modificación del inode del archivo
filegroup — Obtiene el grupo del archivo
fileinode — Obtiene el inode del archivo
filemtime — Obtiene la hora de modificación del archivo
fileowner — Obtiene el dueño del archivo
fileperms — Obtiene los permisos del archivo
filesize — Obtiene el tamaño del archivo
filetype — Obtiene el tipo de archivo
flock — Aviso de bloqueo de archivos portable
fnmatch — Comparar un nombre de archivo contra un patrón
fopen — Abre un archivo o URL
fpassthru — Imprime todos los datos restantes en un apuntador de archivo
fputcsv — Formatea la línea como CSV y la escribe en el archivo apuntado
fputs — Alias of fwrite
fread — Lectura de archivos segura con material binario
fscanf — Procesa la entrada desde un archivo de acuerdo a un formato
fseek — Realiza una búsqueda sobre un apuntador de archivo
fstat — Obtiene información sobre un archivo usando un apuntador de archivo abierto
ftell — Indica la posición de lectura/escritura del apuntador de archivo
ftruncate — Trunca un archivo a la longitud dada
fwrite — Escritura sobre archivos, segura con material binario
glob — Encontrar nombres de ruta coincidentes con un patrón
is_dir — Indica si el nombre de archivo es un directorio
is_executable — Indica si el archivo es ejecutable
is_file — Indica si el archivo es un archivo regular
is_link — Indica si el archivo es un enlace simbólico
is_readable — Indica si es posible leer el archivo
is_uploaded_file — Indica si un archivo fue cargado a través de HTTP POST
is_writable — Indica si el nombre de archivo es escribible
is_writeable — Alias of is_writable
lchgrp — Changes group ownership of symlink
lchown — Changes user ownership of symlink
link — Crea un enlace duro
linkinfo — Consigue información sobre un enlace
lstat — Entrega información sobre un archivo o enlace simbólico
mkdir — Crea un directorio
move_uploaded_file — Mueve un archivo cargado a una nueva ubicación
parse_ini_file — Procesar un archivo de configuración
pathinfo — Devuelve información sobre la ruta de un archivo
pclose — Cierra un apuntador de archivo de proceso
popen — Abre un apuntador de archivo de proceso
readfile — Imprime un archivo
readlink — Devuelve el objetivo de un enlace simbólico
realpath — Devuelve el nombre de ruta absoluto simplificado
rename — Renombra un archivo o directorio
rewind — Retroceder la posición de un apuntador de archivo
rmdir — Elimina un directorio
set_file_buffer — Alias of stream_set_write_buffer
stat — Entrega información sobre un archivo
symlink — Crea un enlace simbólico
tempnam — Crear un archivo con un nombre único
tmpfile — Crea un archivo temporal
touch — Establece la hora de acceso y modificación de un archivo
umask — Cambia la umask actual
unlink — Elimina un archivo