Referência das Funções
PHP Manual

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.

Opções de configuração do Filesystem e Streams
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 .

Aviso

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


Referência das Funções
PHP Manual