(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)
streamWrapper::stream_open — Abre arquivo ou URL
$path,$mode,$options,&$opened_pathEste método é chamado imediatamente após o empacotador ser inicializado (por exemplo por fopen() e file_get_contents()).
pathEspecifica 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.
modeO 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.
optionsConté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.