PHP4使用者手冊:函數-fopen_PHP

手冊

H1>

(PHP 3, PHP 4 >= 4.0.0)

fopen -- 開啟檔案或URL

描述

int fopen (string filename, string mode [, int use_include_path])

如果filename 以"http://"開始 (大小寫不敏感), 則本函數用HTTP 1.0串連開啟指定的伺服器，這個頁面被使用HTTP　GET模式來請求，檔案指標指向被返回的伺服器回應檔的起始處。一個帶有請求虛擬機器主機的基本名字的'Host:'頭被發送。

注意，這個檔案指標允許你重新找迴響應的the body ：你不能使用這個函數存取 HTTP 回應標頭。

在PHP 4.0.5以下不能重新導向HTTP控制代碼。 Because of this, directories must include trailing slashes.

如果filename 以"ftp://"開始 (大小寫不敏感），一個指定的ftp串連伺服器被開啟，返回一個被請求檔案的指標。如果這個伺服器不支援被動ftp模式，將發失錯誤。你可以經過ftp任意的為讀或寫開啟檔案(但不能兩者不能同時)。

如果filename 是 "php://stdin", "php://stdout", 或 "php://stderr"其中之一，則相應的輸入輸出資料流將被開啟地。 (這是在PHP 3.0.13中引入的；在早期版本中，這個檔案名稱象 "/dev/stdin" 或 "/dev/fd/0"這樣去使用來訪問輸入輸出資料流)。

如果filename 是以別的方式開始的，這個檔案將被從檔案系統中開啟，返回一個開啟檔案的指標。

如果開啟失敗，則返回FALSE。

mode 可以為下面任何一個：

'r' - 唯讀開啟，指標指向檔案開始；

'r+' - 為讀寫開啟，指標指向檔案開始；

'w' - 唯寫開啟，指標指向檔案開始，檔案大小清零。如果檔案不存在，則建立；

'w+' - 為讀寫開啟，指標指向檔案開始，檔案大小清零。如果檔案不存在，則建立；

'a' - 為追加開啟，指標指向檔案結尾。如果檔案不存在，嘗試建立；

'a+' - 為讀寫開啟，指標指向檔案結尾。如果檔案不存在，嘗試建立。

注意: mode 可以包含字母 'b'。這僅僅在在系統區分二進位和文字檔才有用。 (i.e. Windows. 它在Unix中是無用的)。如果不需要，它將被忽略。

如果你想在include_path中搜尋檔案，你可以使用可選的第三個參數並把它設定為"1"。

例1. fopen() 例

$fp = fopen ("/home/rasmus/file.txt", "r");
$fp = fopen ("/home/rasmus/file.gif", "wb");
$fp = fopen ("http://www.php.net/", "r");
$fp = fopen ("ftp://user:password@example.com/", "w");

If you are experiencing problems with reading and writing to files and you're using the server module version of PHP, remember to make sure that the files and directories you're using are accessible to the server process.

On the Windows platform, be careful to escape any backslashes used in the path to the file, or use forward slashes.

$fp = fopen ("c:\\data\\info.txt", "r");

參見 fclose(), fsockopen(), socket_set_timeout(), 和 popen().

