PHP 8.3.4 Released!

streamWrapper::stream_open

(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)

streamWrapper::stream_openAbre arquivo ou URL

Descrição

public streamWrapper::stream_open(
    string $path,
    string $mode,
    int $options,
    ?string &$opened_path
): bool

Este método é chamado imediatamente após o empacotador ser inicializado (por exemplo por fopen() e file_get_contents()).

Parâmetros

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.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Erros/Exceções

Emite um E_WARNING se a chamada a este método falhar (ou seja, não implementado).

Notas

Nota:

A propriedade streamWrapper::$context será atualizada se um contexto válido for passado para a função invocadora.

Veja Também

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top