streamWrapper::stream_open

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

streamWrapper::stream_open — 開啟檔案或 URL

public streamWrapper::stream_open(
    字串 $path,
    字串 $mode,
    整數 (int) $options,
    ?字串 (string) &$opened_path
): 布林值 (bool)

這個方法會在包裝器初始化後立即被呼叫（例如，透過 fopen() 和 file_get_contents()）。

path（路徑）

指定傳遞給原始函式的 URL。

注意事項:
可以使用 parse_url() 來拆解 URL。請注意，只有以 :// 分隔的 URL 才被支援。雖然 : 和 :/ 技術上是有效的 URL，但它們不被支援。

mode（模式）

用於開啟檔案的模式，詳情請參考 fopen()。

注意事項:
請記得檢查 mode 對於請求的 path 是否有效。

options（選項）

包含由串流 API 設定的額外旗標。它可以包含一個或多個以下的值，以 OR 運算子結合。

旗標	說明
`STREAM_USE_PATH`	如果 `path` 是相對路徑，則使用 include_path 搜尋資源。
`STREAM_REPORT_ERRORS`	如果設定了此旗標，您需要負責在開啟串流期間使用 trigger_error() 產生錯誤。如果未設定此旗標，則不應產生任何錯誤。

opened_path（已開啟的路徑）

如果 path 成功開啟，並且在 options 中設定了 STREAM_USE_PATH，則 opened_path 應設定為實際開啟的檔案/資源的完整路徑。

成功時回傳 true，失敗時回傳 false。

如果呼叫此方法失敗（例如未實作），則發出 E_WARNING。

注意事項:
如果將有效的上下文傳遞給呼叫者函式，則會更新 streamWrapper::$context 屬性。

此頁面沒有使用者貢獻的註釋。