Filesystem (Sistema de arquivos)
Introdução
Dependências
Não são necessárias bibliotecas externas para compilar esta extensão, mas se você que que o PHP suporte LFS (Arquivos Grandes) no Linux, então você precisa ter uma versão recente da glibc e você precisa compilar o PHP com as seguintes opções do compilador: -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64.
Instalação
Não há nenhuma instalação necessária para utilizar estas funções, elas fazem parte do núcleo do PHP.
Configurações em execução
O comportamento dessas funções podem ser modificado pelas configurações do php.ini.
| Nome | Padrão | Alterável | Changelog |
|---|---|---|---|
| allow_url_fopen | "1" | PHP_INI_ALL | PHP_INI_ALL no PHP <= 4.3.4. PHP_INI_SYSTEM no PHP < 6. Disponível desde o PHP 4.0.4. |
| allow_url_include | "0" | PHP_INI_ALL | PHP_INI_SYSTEM no PHP 5. Disponível desde o PHP 5.2.0. |
| user_agent | NULL | PHP_INI_ALL | Disponível desde PHP 4.3.0. |
| default_socket_timeout | "60" | PHP_INI_ALL | Disponível desde PHP 4.3.0. |
| from | "" | PHP_INI_ALL | |
| auto_detect_line_endings | "0" | PHP_INI_ALL | Disponível desde PHP 4.3.0. |
Breve descrição 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 definição pode ser definida apenas no php.ini devido a motivos de segurança.
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 .
AvisoNas versões Windows anterioes a PHP 4.3.0, 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 Imagens.
- allow_url_include boolean
-
Esta função permite o uso de wrappers URL com as seguintes funções include(), include_once(), require(), require_once().
Nota: Esta definição requer que allow_url_fopen esteja on.
- 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.0.
- from 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.0.
Tipos Resource
Constantes pré-definidas
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)
- PATHINFO_FILENAME (integer)
- Desde PHP 5.2.0.
- FILE_USE_INCLUDE_PATH (integer)
- Procura por filename em include_path (desde o PHP 5).
- FILE_APPEND (integer)
- Adiciona conteúdo ao arquivo existente.
- FILE_IGNORE_NEW_LINES (integer)
- Remove caracteres EOL (desde o PHP 5).
- FILE_SKIP_EMPTY_LINES (integer)
- Pula linhas em branco (desde o PHP 5).
- FILE_BINARY (integer)
- Modo binário (desde o PHP 6).
- FILE_TEXT (integer)
- Modo texto (desde o PHP 6).
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 List of Supported Protocols/Wrappers.
Í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 sobre 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 — Lê uma linha do ponteiro de arquivos e a interpreta como campos CSV
- fgets — Lê 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 — Lê todo o conteúdo de um arquivo para uma string
- file_put_contents — Escreve uma string para um arquivo
- file — Lê todo o arquivo 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 do arquivo
- flock — Monitor de travamento de arquivos portátil
- fnmatch — Compara nome de arquivo com um padrão
- fopen — Abre um arquivo ou URL
- fpassthru — Imprime todo os dados restantes de um ponteiro de arquivo
- fputcsv — Formata a linha como CSV e a escreve em 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ê informações sobre um arquivo usando um ponteiro de arquivo aberto
- ftell — Retorna a posição de leitura/gravação do ponteiro do arquivo
- ftruncate — Reduz um arquivo a um tamanho especificado
- fwrite — Escrita binary-safe em arquivos
- glob — Acha caminhos que combinam com um 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 pode ser lido
- is_uploaded_file — Diz se o arquivo foi enviado por POST HTTP
- is_writable — Diz se pode-se escrever para o arquivo (writable)
- is_writeable — Esta é uma função sinônima (alias) de is_writable
- lchgrp — Changes group ownership of symlink
- lchown — Changes user ownership of symlink
- link — Criando um hard link
- linkinfo — Ler informações sobre um link
- lstat — Obtem informações sobre um arquivo ou link simbólico
- mkdir — Cria um diretório
- move_uploaded_file — Move um arquivo enviado para uma nova localização
- parse_ini_file — Interpreta um arquivo de configuração
- pathinfo — Retorna informações sobre um caminho de 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