PHP fopen() 函數 · W3School PHP 參考手冊

# PHP fopen() 函數 ## 定義和用法 fopen() 函數打開文件或者 URL。如果打開失敗，本函數返回 FALSE。 ### 語法 ``` fopen(filename,mode,include_path,context) ``` | 參數 | 描述 | | --- | --- | | filename | 必需。規定要打開的文件或 URL。 | | mode | 必需。規定要求到該文件/流的訪問類型。可能的值見下表。 | | include_path | 可選。如果也需要在 include_path 中檢索文件的話，可以將該參數設為 1 或 TRUE。 | | context | 可選。規定文件句柄的環境。Context 是可以修改流的行為的一套選項。 | ### mode 參數的可能的值 | mode | 說明 | | --- | --- | | "r" | 只讀方式打開，將文件指針指向文件頭。 | | "r+" | 讀寫方式打開，將文件指針指向文件頭。 | | "w" | 寫入方式打開，將文件指針指向文件頭并將文件大小截為零。如果文件不存在則嘗試創建之。 | | "w+" | 讀寫方式打開，將文件指針指向文件頭并將文件大小截為零。如果文件不存在則嘗試創建之。 | | "a" | 寫入方式打開，將文件指針指向文件末尾。如果文件不存在則嘗試創建之。 | | "a+" | 讀寫方式打開，將文件指針指向文件末尾。如果文件不存在則嘗試創建之。 | | "x" | 創建并以寫入方式打開，將文件指針指向文件頭。如果文件已存在，則 fopen() 調用失敗并返回 FALSE，并生成一條 E_WARNING 級別的錯誤信息。如果文件不存在則嘗試創建之。這和給底層的 open(2) 系統調用指定 O_EXCL|O_CREAT 標記是等價的。此選項被 PHP 4.3.2 以及以后的版本所支持，僅能用于本地文件。 | | "x+" | 創建并以讀寫方式打開，將文件指針指向文件頭。如果文件已存在，則 fopen() 調用失敗并返回 FALSE，并生成一條 E_WARNING 級別的錯誤信息。如果文件不存在則嘗試創建之。這和給底層的 open(2) 系統調用指定 O_EXCL|O_CREAT 標記是等價的。此選項被 PHP 4.3.2 以及以后的版本所支持，僅能用于本地文件。 | ### 說明 fopen() 將 _filename_ 指定的名字資源綁定到一個流上。如果 _filename_ 是 "_scheme://..._" 的格式，則被當成一個 URL，PHP 將搜索協議處理器（也被稱為封裝協議）來處理此模式。如果該協議尚未注冊封裝協議，PHP 將發出一條消息來幫助檢查腳本中潛在的問題并將 _filename_ 當成一個普通的文件名繼續執行下去。如果 PHP 認為 _filename_ 指定的是一個本地文件，將嘗試在該文件上打開一個流。該文件必須是 PHP 可以訪問的，因此需要確認文件訪問權限允許該訪問。如果激活了安全模式或者 open_basedir 則會應用進一步的限制。如果 PHP 認為 _filename_ 指定的是一個已注冊的協議，而該協議被注冊為一個網絡 URL，PHP 將檢查并確認 allow_url_fopen 已被激活。如果關閉了，PHP 將發出一個警告，而 fopen 的調用則失敗。對 _context_ 的支持是 PHP 5.0.0 添加的。 ## 提示和注釋注釋：不同的操作系統家族具有不同的行結束習慣。當寫入一個文本文件并想插入一個新行時，需要使用符合操作系統的行結束符號。基于 Unix 的系統使用 \n 作為行結束字符，基于 Windows 的系統使用 \r\n 作為行結束字符，基于 Macintosh 的系統使用 \r 作為行結束字符。如果寫入文件時使用了錯誤的行結束符號，則其它應用程序打開這些文件時可能會表現得很怪異。 Windows 下提供了一個文本轉換標記（"t"）可以透明地將 \n 轉換為 \r\n。與此對應還可以使用 "b" 來強制使用二進制模式，這樣就不會轉換數據。要使用這些標記，要么用 "b" 或者用 "t" 作為 mode 參數的最后一個字符。默認的轉換模式依賴于 SAPI 和所使用的 PHP 版本，因此為了便于移植鼓勵總是指定恰當的標記。如果是操作純文本文件并在腳本中使用了 \n 作為行結束符，但還要期望這些文件可以被其它應用程序例如 Notepad 讀取，則在 mode 中使用 "t"。在所有其它情況下使用 "b"。在操作二進制文件時如果沒有指定 "b" 標記，可能會碰到一些奇怪的問題，包括壞掉的圖片文件以及關于 \r\n 字符的奇怪問題。注釋：為移植性考慮，強烈建議在用 fopen() 打開文件時總是使用 "b" 標記。注釋：再一次，為移植性考慮，強烈建議你重寫那些依賴于 "t" 模式的代碼使其使用正確的行結束符并改成 "b" 模式。 ## 例子 ``` <?php $file = fopen("test.txt","r"); $file = fopen("/home/test/test.txt","r"); $file = fopen("/home/test/test.gif","wb"); $file = fopen("http://www.example.com/","r"); $file = fopen("ftp://user:password@example.com/test.txt","w"); ?> ```