XXX. Filesystem (Sistema de arquivos)

Introdução

Requisitos

Nenhuma biblioteca externa é necessária para compilar esta extensão.

Instalação

Não há nenhuma instalação necessária para utilizar estas funções, elas fazem parte do núcleo do PHP.

Configuração durante execução

O comportamento dessas funções podem ser modificado pelas configurações do php.ini.

Tabela 1. Opções de configuração do Filesystem e Streams

Nome	Padrão	Alterável
allow_url_fopen	"1"	PHP_INI_ALL
user_agent	NULL	PHP_INI_ALL
default_socket_timeout	"60"	PHP_INI_ALL
from	NULL	??
auto_detect_line_endings	"Off"	PHP_INI_ALL

Descrição resumida das diretivas de configuração.

allow_url_fopen boolean

Esta opção ativa o dispositivo URL fopen wrappers que permite o acesso a objetos URL como arquivos. São disponibilizados por padrão wrappers para acesso de arquivos remotos utilizando os protocolos FTP ou HTTP, e algumas estensões como a zlib podem registar wrappers adicionais.

Nota: Esta opção foi introduzida imediatamente antes da liberação da versão 4.0.3. Até essa versão e incluindo a 4.0.3, você somente podia desabilitar este recurso na compilação, usando a opção --disable-url-fopen-wrapper.

Atenção

Nas versões Windows anterioes a PHP 4.3, as funções seguintes não suportavam acesso de arquivos remotos: include(), include_once(), require(), require_once() e as funções imagecreatefromXXX da extensão Referência XLI, Image Functions.

user_agent string

Define o user agent que o PHP irá enviar.

default_socket_timeout integer

Timeout padrão (em segundos) para streams baseados em socket.

Nota: Esta opção de configuração foi incluida no PHP 4.3.

from="joe@example.com" string

Define a senha do FTP anonimo (seu endereço de e-mail).

auto_detect_line_endings boolean

Quando ativo, o PHP irá examinar os dados lidos por fgets() e file() para verificar se está sendo utilizado a convensão de fim de linha Unix, MS-DOS ou Macintosh.

Isto ativa a interoperabilidade do PHP com sistemas Macintosh, mas seu padrão é Off, porque isso causa uma pequena perda de performance na detecção da convenção de fim de linha num primeiro momento e porque as pessoas que utilizam o fim de linha como separadores de itens sob sistemas Unix podem experimentar problemas de falta de compatibilidade.

Nota: Esta opção de configuração foi introduzida no PHP 4.3.

Tipos Resource

Constantes Predefinidas

As contantes abaixo são definidas por esta extensão e somente estarão disponíveis quando a extensão foi compilada com o PHP ou carregada dinamicamente durante a execução.

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)
FILE_USE_INCLUDE_PATH (integer)
FILE_APPEND (integer)
FILE_IGNORE_NEW_LINES (integer)
FILE_SKIP_EMPTY_LINES (integer)

Veja Também

Para funções relacionadas, veja também as seções Deritório e Execução de Programas.

Para uma lista e descrição dos vários wrappers URL que podem ser utilizados como arquivos remotos, veja em Apêndice J.

Índice
basename -- Retorna a parte nome do arquivo do caminho/path
chgrp -- Modifica o grupo do arquivo
chmod -- Modifica as permissões do arquivo
chown -- Modifica o dono do arquivo
clearstatcache -- Limpa as informações em cache de arquivos
copy -- Copia arquivo
delete -- Veja unlink() ou unset()
dirname -- Retorna o componente diretório de um caminho/path
disk_free_space -- Retorna o espaço disponivel no diretório
disk_total_space -- Retorna o tamanho total do diretório
diskfreespace -- Sinônimo de disk_free_space()
fclose -- Fecha um ponteiro de arquivo aberto
feof -- Testa pelo fim-de-arquivo (eof) em um ponteiro de arquivo
fflush -- Força a liberação do buffer para um arquivo
fgetc -- Le um caracter do ponteiro de arquivo
fgetcsv -- Le uma linha do ponteiro de arquivos e a interpreta por campos CSV
fgets -- Le uma linha de um ponteiro de arquivo
fgetss -- Ler uma linha de um ponteiro de arquivo e retira as tags HTML
file_exists -- Checa se um arquivo ou diretório existe
file_get_contents -- Le todo o conteúdo de um arquivo para uma string
file_put_contents -- Write a string to a file
file -- Le um arquivo inteiro para um array
fileatime -- Obtém o último horário de acesso do arquivo
filectime -- Ler o tempo de modificação do inode do arquivo
filegroup -- Lê o grupo do arquivo
fileinode -- Lê o inode do arquivo
filemtime -- Le o tempo de modificação do arquivo
fileowner -- Lê o dono (owner) do arquivo
fileperms -- Lê as permissões do arquivo
filesize -- Lê o tamanho do arquivo
filetype -- Lê o tipo de arquivo (file type)
flock -- Monitor de travamento de arquivos portátil
fnmatch -- Verifica se um nome de arquivo bate com padrão (wildcards)
fopen -- Abri um arquivo ou uma URL
fpassthru -- Imprime todo os dados restantes de um ponteiro de arquivo
fputs -- Sinônimo de fwrite()
fread -- Leitura binary-safe de arquivo
fscanf -- Interpreta a leitura de um arquivo de acordo com um formato
fseek -- Procura (seeks) em um ponteiro de arquivo
fstat -- Lê a informação sobre um arquivo usando um ponteiro de arquivo aberto
ftell -- Retorna a posição de leitura/gravação do ponteiro do arquivo
ftruncate -- Corta (trunca) um arquivo para um tamanho especificado
fwrite -- Gravação em arquivos binary-safe
glob -- Localiza diretórios/arquivos que combinem com o padrão
is_dir -- Diz se o caminho é um diretório
is_executable -- Diz se um arquivo é executável
is_file -- Diz se o arquivo é um arquivo comum (não é diretório)
is_link -- Diz se o arquivo é um link simbólico (symbolic link)
is_readable -- Diz se o arquivo é legivel (readable)
is_uploaded_file -- Diz se o arquivo foi uploaded via HTTP POST
is_writable -- Diz se pode-se escrever para o arquivo (writable)
is_writeable -- Esta é uma função sinônima (alias) de is_writable()
link -- Criando um hard link
linkinfo -- Ler informações sobre um link
lstat -- Obtem informações sobre um arquivo ou link simbólico
mkdir -- Criar um diretório
move_uploaded_file -- Move um arquivo carregado para uma nova localização
parse_ini_file -- Interpreta um arquivo de configuração
pathinfo -- Retorna informação sobre o path de um arquivo
pclose -- Fecha um processo de um ponteiro de arquivo
popen -- Abre um processo como ponteiro de arquivo
readfile -- Lê e exibe o conteúdo de um arquivo
readlink -- Retornar o alvo de um link simbólico
realpath -- Retorna o path absoluto canonicalizado
rename -- Renomear um arquivo
rewind -- Reinicializa a posição do ponteiro de arquivos para o início
rmdir -- Remove um diretório
set_file_buffer -- Sinônimo de stream_set_write_buffer()
stat -- Obtem informações sobre um arquivo
symlink -- Cria um link simbólico
tempnam -- Cria um nome de arquivo único
tmpfile -- Cria um arquivo temporário
touch -- Muda o tempo de modificação do arquivo
umask -- Modificar a umask atual
unlink -- Apaga um arquivo