Manual do PHP
Anterior |  | Próxima

# XL. 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`.

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

Nome | Padrão | Alterável | Changelog
--- | --- | --- | ---
allow_url_fopen | "1" | PHP_INI_SYSTEM | PHP_INI_ALL em PHP <= 4.3.4. Disponível desde PHP 4.0.4.
allow_url_include | "0" | PHP_INI_SYSTEM | Disponível desde 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`.

  Atenção
  Nas 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 Referência LXV, Imagens, Funções de.

`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)

`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 N.

Anterior | Principal | Próxima
filepro | Acima | basename