(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)
streamWrapper::stream_open — Abre arquivo ou URL
$path
,$mode
,$options
,&$opened_path
Este método é chamado imediatamente após o empacotador ser inicializado (por exemplo por fopen() e file_get_contents()).
path
Especifica a URL que foi passada à função original.
Nota:
A URL pode ser quebrada em partes com parse_url(). Note que apenas URLs delimitadas por :// são suportadas. : e :/ são delimitadores tecnicamente válidos, porém não suportados.
mode
O modo usado para abrir o arquivo, como detalhado para fopen().
Nota:
Importante lembrar de verificar se o parâmetro
mode
é válido para o caminho (path
) requisitado.
options
Contém opções adicionais definidas pela API de fluxos. Pode conter uma ou mais das opcções a seguir somadas (com a operação OR).
Opção | Descrição |
---|---|
STREAM_USE_PATH |
Se o caminho path for relativo, a pesquisa
pelo recurso utilizará include_path.
|
STREAM_REPORT_ERRORS |
Se esta opção estiver definida, o programador é responsável por emitir erros usando trigger_error() durante abertura do fluxo. Se não estiver definida, o programador não deve emitir erros. |
opened_path
Se o caminho path
for aberto com sucesso,
e STREAM_USE_PATH
estiver definida em options
,
opened_path
deve ser definida para o caminho
completo do arquivo/recurso que foi realmente aberto.
Emite
um E_WARNING
se a chamada a este método falhar
(ou seja, não implementado).
Nota:
A propriedade streamWrapper::$context será atualizada se um contexto válido for passado para a função invocadora.