streamWrapper::stream_open
(PHP 4 >= 4.3.2, PHP 5)
streamWrapper::stream_open — Opens file or URL
Descrierea
$path
, string $mode
, int $options
, string &$opened_path
)This method is called immediately after the wrapper is initialized (f.e. by fopen() and file_get_contents()).
Parametri
-
path -
Specifies the URL that was passed to the original function.
Notă:
The URL can be broken apart with parse_url(). Note that only URLs delimited by :// are supported. : and :/ while technically valid URLs, are not.
-
mode -
The mode used to open the file, as detailed for fopen().
Notă:
Remember to check if the
modeis valid for thepathrequested. -
options -
Holds additional flags set by the streams API. It can hold one or more of the following values OR'd together.
Flag Description STREAM_USE_PATHIf pathis relative, search for the resource using the include_path.STREAM_REPORT_ERRORSIf this flag is set, you are responsible for raising errors using trigger_error() during opening of the stream. If this flag is not set, you should not raise any errors. -
opened_path -
If the
pathis opened successfully, andSTREAM_USE_PATHis set inoptions,opened_pathshould be set to the full path of the file/resource that was actually opened.
Valorile întoarse
Întoarce valoarea TRUE în cazul
succesului sau FALSE în cazul eșecului.
Erori/Excepții
Emite o eroare
E_WARNING dacă apelul acestei metode eșuează
(de ex. nu este implementată).
Note
Notă:
Proprietatea streamWrapper::$context este reînnoită dacă un context valid este transmis funcției apelante.
