(PHP 4, PHP 5, PHP 7, PHP 8)
fopen — 打開文件或者 URL
$filename,$mode,$use_include_path = false,$context = ?
fopen() 將
filename
指定的名字資源綁定到一個(gè)流上。
filename
如果
filename
是 "scheme://..." 的格式，則被當(dāng)成一個(gè)
URL，PHP 將搜索協(xié)議處理器（也被稱為封裝協(xié)議）來(lái)處理此模式。如果該協(xié)議尚未注冊(cè)封裝協(xié)議，PHP
將發(fā)出一條消息來(lái)幫助檢查腳本中潛在的問(wèn)題并將
filename
當(dāng)成一個(gè)普通的文件名繼續(xù)執(zhí)行下去。
如果 PHP 認(rèn)為
filename
指定的是一個(gè)本地文件，將嘗試在該文件上打開一個(gè)流。該文件必須是
PHP 可以訪問(wèn)的，因此需要確認(rèn)文件訪問(wèn)權(quán)限允許該訪問(wèn)。如果激活了
open_basedir
則會(huì)應(yīng)用進(jìn)一步的限制。
如果 PHP 認(rèn)為
filename
指定的是一個(gè)已注冊(cè)的協(xié)議，而該協(xié)議被注冊(cè)為一個(gè)網(wǎng)絡(luò)
URL，PHP 將檢查并確認(rèn)
allow_url_fopen
已被激活。如果關(guān)閉了，PHP 將發(fā)出一個(gè)警告，而 fopen 的調(diào)用則失敗。
注意:
所支持的協(xié)議列表見(jiàn)支持的協(xié)議和封裝協(xié)議。某些協(xié)議（也被稱為
wrappers）支持context和／或 php.ini 選項(xiàng)。參見(jiàn)相應(yīng)的頁(yè)面哪些選項(xiàng)可以被設(shè)定（例如 php.ini 中用于httpwrapper 的user_agent值）。
On the Windows platform, be careful to escape any backslashes used in the path to the file, or use forward slashes.
<?php
$handle = fopen("c:\\folder\\resource.txt", "r");
?>
mode
mode
參數(shù)指定了所要求到該流的訪問(wèn)類型?？梢允且韵拢?
mode |
說(shuō)明 |
|---|---|
'r' |
只讀方式打開，將文件指針指向文件頭。 |
'r+' |
讀寫方式打開，將文件指針指向文件頭。 |
'w' |
寫入方式打開，將文件指針指向文件頭并將文件大小截為零。如果文件不存在則嘗試創(chuàng)建之。 |
'w+' |
讀寫方式打開，將文件指針指向文件頭并將文件大小截為零。如果文件不存在則嘗試創(chuàng)建之。 |
'a' |
寫入方式打開，將文件指針指向文件末尾。如果文件不存在則嘗試創(chuàng)建之。 |
'a+' |
讀寫方式打開，將文件指針指向文件末尾。如果文件不存在則嘗試創(chuàng)建之。 |
'x' |
創(chuàng)建并以寫入方式打開，將文件指針指向文件頭。如果文件已存在，則
fopen() 調(diào)用失敗并返回 false，并生成一條
E_WARNING 級(jí)別的錯(cuò)誤信息。如果文件不存在則嘗試創(chuàng)建之。這和給
底層的 open(2) 系統(tǒng)調(diào)用指定
O_EXCL|O_CREAT 標(biāo)記是等價(jià)的。
|
'x+' |
創(chuàng)建并以讀寫方式打開，其他的行為和 'x' 一樣。
|
'c' |
Open the file for writing only. If the file does not exist, it is
created. If it exists, it is neither truncated (as opposed to
'w'), nor the call to this function fails (as is
the case with 'x'). The file pointer is
positioned on the beginning of the file. This may be useful if it's
desired to get an advisory lock (see flock())
before attempting to modify the file, as using
'w' could truncate the file before the lock
was obtained (if truncation is desired,
ftruncate() can be used after the lock is
requested).
|
'c+' |
Open the file for reading and writing; otherwise it has the same
behavior as 'c'.
|
注意:
不同的操作系統(tǒng)家族具有不同的行結(jié)束習(xí)慣。當(dāng)寫入一個(gè)文本文件并想插入一個(gè)新行時(shí)，需要使用符合操作系統(tǒng)的行結(jié)束符號(hào)?；? Unix 的系統(tǒng)使用
\n作為行結(jié)束字符，基于 Windows 的系統(tǒng)使用\r\n作為行結(jié)束字符，基于 Macintosh 的系統(tǒng)使用\r作為行結(jié)束字符。如果寫入文件時(shí)使用了錯(cuò)誤的行結(jié)束符號(hào)，則其它應(yīng)用程序打開這些文件時(shí)可能會(huì)表現(xiàn)得很怪異。
Windows 下提供了一個(gè)文本轉(zhuǎn)換標(biāo)記（
't'）可以透明地將\n轉(zhuǎn)換為\r\n。與此對(duì)應(yīng)還可以使用'b'來(lái)強(qiáng)制使用二進(jìn)制模式，這樣就不會(huì)轉(zhuǎn)換數(shù)據(jù)。要使用這些標(biāo)記，要么用'b'或者用't'作為mode參數(shù)的最后一個(gè)字符。默認(rèn)的轉(zhuǎn)換模式依賴于 SAPI 和所使用的 PHP 版本，因此為了便于移植鼓勵(lì)總是指定恰當(dāng)?shù)臉?biāo)記。如果是操作純文本文件并在腳本中使用了
\n作為行結(jié)束符，但還要期望這些文件可以被其它應(yīng)用程序例如 Notepad 讀取，則在 mode 中使用't'。在所有其它情況下使用'b'。在操作二進(jìn)制文件時(shí)如果沒(méi)有指定
'b'標(biāo)記，可能會(huì)碰到一些奇怪的問(wèn)題，包括壞掉的圖片文件以及關(guān)于\r\n字符的奇怪問(wèn)題。
注意:
為移植性考慮，強(qiáng)烈建議在用 fopen() 打開文件時(shí)總是使用
'b'標(biāo)記。
注意:
再一次，為移植性考慮，強(qiáng)烈建議你重寫那些依賴于
't'模式的代碼使其使用正確的行結(jié)束符并改成'b'模式。
use_include_path
如果也需要在
include_path
中搜尋文件的話，可以將可選的第三個(gè)參數(shù)
use_include_path
設(shè)為 '1' 或 true。
context上下文流（context stream） resource。
成功時(shí)返回文件指針資源，如果打開失敗，本函數(shù)返回 false。
如果打開失敗，會(huì)產(chǎn)生一個(gè) E_WARNING 錯(cuò)誤。可以通過(guò) @ 來(lái)屏蔽錯(cuò)誤。
| 版本 | 說(shuō)明 |
|---|---|
| 4.3.2 |
自 PHP 4.3.2
起，對(duì)所有區(qū)別二進(jìn)制和文本模式的平臺(tái)默認(rèn)模式都被設(shè)為二進(jìn)制模式。如果在升級(jí)后腳本碰到問(wèn)題，嘗試暫時(shí)使用
't' 標(biāo)記，直到所有的腳本都照以下所說(shuō)的改為更具移植性以后。
|
| 4.3.2 |
增加了選項(xiàng) 'x' 和 'x+'
|
| 5.2.6 |
增加了選項(xiàng) 'c' 和 'c+'
|
示例 #1 fopen() 例子
<?php
$handle = fopen("/home/rasmus/file.txt", "r");
$handle = fopen("/home/rasmus/file.gif", "wb");
$handle = fopen("http://www.example.com/", "r");
$handle = fopen("ftp://user:password@example.com/somefile.txt", "w");
?>
使用 SSL 時(shí)，Microsoft IIS
會(huì)違反協(xié)議不發(fā)送close_notify標(biāo)記就關(guān)閉連接。PHP 會(huì)在到達(dá)數(shù)據(jù)尾端時(shí)報(bào)告“SSL: Fatal Protocol Error”。
要解決此問(wèn)題，error_reporting 應(yīng)設(shè)定為降低級(jí)別至不包含警告。
PHP 4.3.7 及更高版本可以在使用 https:// 包裝器打開流時(shí)檢測(cè)出有問(wèn)題的 IIS 服務(wù)器軟件 并抑制警告。在使用
fsockopen() 創(chuàng)建 ssl:// 套接字時(shí), 開發(fā)者需檢測(cè)并抑制此警告。
注意:
如果在用服務(wù)器模塊版本的 PHP 時(shí)在打開和寫入文件上遇到問(wèn)題，記住要確保所使用的文件和目錄是服務(wù)器進(jìn)程所能夠訪問(wèn)的。
注意:
This function may also succeed when
filenameis a directory. If you are unsure whetherfilenameis a file or a directory, you may need to use the is_dir() function before calling fopen().