定義和用法

fopen() 函數(shù)打開文件或者 URL。

如果打開失敗，本函數(shù)返回 FALSE。

語法

fopen(filename,mode,include_path,context)

參數(shù)	描述
filename	必需。規(guī)定要打開的文件或 URL。
mode	必需。規(guī)定要求到該文件/流的訪問類型�？赡艿闹狄娤卤�。
include_path	可選。如果也需要在 include_path 中檢索文件的話，可以將該參數(shù)設(shè)為 1 或 TRUE。
context	可選。規(guī)定文件句柄的環(huán)境。Context 是可以修改流的行為的一套選項(xiàng)。

mode 參數(shù)的可能的值

mode	說明
"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à)的。 此選項(xiàng)被 PHP 4.3.2 以及以后的版本所支持，僅能用于本地文件。
"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à)的。 此選項(xiàng)被 PHP 4.3.2 以及以后的版本所支持，僅能用于本地文件。

說明

fopen() 將 filename 指定的名字資源綁定到一個(gè)流上。如果 filename 是 "scheme://..." 的格式，則被當(dāng)成一個(gè) URL，PHP 將搜索協(xié)議處理器（也被稱為封裝協(xié)議）來處理此模式。如果該協(xié)議尚未注冊(cè)封裝協(xié)議，PHP 將發(fā)出一條消息來幫助檢查腳本中潛在的問題并將 filename 當(dāng)成一個(gè)普通的文件名繼續(xù)執(zhí)行下去。

如果 PHP 認(rèn)為 filename 指定的是一個(gè)本地文件，將嘗試在該文件上打開一個(gè)流。該文件必須是 PHP 可以訪問的，因此需要確認(rèn)文件訪問權(quá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)用則失敗。

對(duì) context 的支持是 PHP 5.0.0 添加的。

提示和注釋

注釋：不同的操作系統(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" 來強(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í)如果沒有指定 "b" 標(biāo)記，可能會(huì)碰到一些奇怪的問題，包括壞掉的圖片文件以及關(guān)于 \r\n 字符的奇怪問題。

注釋：為移植性考慮，強(qiáng)烈建議在用 fopen() 打開文件時(shí)總是使用 "b" 標(biāo)記。

注釋：再一次，為移植性考慮，強(qiáng)烈建議你重寫那些依賴于 "t" 模式的代碼使其使用正確的行結(jié)束符并改成 "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");
?>