streamWrapper::stream_open
(PHP 4 >= 4.3.2, PHP 5)
streamWrapper::stream_open — Opens file or URL
Beschreibung
This method is called immediately after the wrapper is initialized (f.e. by fopen() and file_get_contents()).
Parameter-Liste
- path
-
Specifies the URL that was passed to the original function.
Hinweis: 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().
Hinweis: Remember to check if the mode is valid for the path requested.
- 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_PATH If path is relative, search for the resource using the include_path. STREAM_REPORT_ERRORS If 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 path is opened successfully, and STREAM_USE_PATH is set in options , opened_path should be set to the full path of the file/resource that was actually opened.
Rückgabewerte
Gibt bei Erfolg TRUE zurück, im Fehlerfall FALSE.
Fehler/Exceptions
Wirft E_WARNING, wenn der Aufruf dieser Methode fehlschlug (z.B. weil sie nicht implementiert ist).
Anmerkungen
Hinweis: Die streamWrapper->Kontext-Eigenschaft wird, wenn verfügbar, aktualisiert, wenn der aufrufenden Funktion ein gültiger Kontext übergeben wurde.
Siehe auch
- fopen() - Öffnet eine Datei oder URL
- parse_url() - Analysiert einen URL und gibt seine Bestandteile zurück
streamWrapper::stream_open
