[ 永遠的UNIX > PHP4手冊:函數庫及函數(十六) 文件系統函式庫-2 ]

[ 永遠的UNIX::UNIX技術資料的寶庫 ] GB | BIG5

首頁 > 編程技術 > Php > 正文

PHP4手冊:函數庫及函數(十六) 文件系統函式庫-2

http://netleader.126.com 星空浪子 (2001-04-18 12:23:42)

--------------------------------------------------------------------------------
函式:file()
--------------------------------------------------------------------------------

檔案系統函式庫

file
將檔案全部讀入陣列變數中。

語法: array file(string filename);

傳回值: 陣列

函式種類: 檔案存取

內容說明

本函式與 readfile() 類似，不同的地方為本函式將檔案全部讀出，並輸出到陣列的變數中，每行都是單獨的陣列元素。

參考

fopen()  popen()  readfile()

--------------------------------------------------------------------------------
函式:file_exists()
--------------------------------------------------------------------------------

檔案系統函式庫

file_exists
檢查檔案是否存在。

語法: int file_exists(string filename);

傳回值: 整數

函式種類: 檔案存取

內容說明

本函式用來測試檢查檔案是否存在，傳回 true 表示檔案存在。傳回值放在快取緩沖區中，可以參考 clearstatcache()。

--------------------------------------------------------------------------------
函式:fileatime()
--------------------------------------------------------------------------------

檔案系統函式庫

fileatime
取得檔案最的存取時間。

語法: int fileatime(string filename);

傳回值: 整數

函式種類: 檔案存取

內容說明

本函式傳回指定檔案 filename 的最存取時間。傳回 false 表示發生錯誤。傳回值放在快取緩沖區中，可以參考 clearstatcache()。

--------------------------------------------------------------------------------
函式:filectime()
--------------------------------------------------------------------------------

檔案系統函式庫

filectime
取得檔案最的改變時間。

語法: int filectime(string filename);

傳回值: 整數

函式種類: 檔案存取

內容說明

本函式傳回指定檔案 filename 的 inode 最改變時間。傳回 false 表示發生錯誤。傳回值放在快取緩沖區中，可以參考 clearstatcache()。

--------------------------------------------------------------------------------
函式:filegroup()
--------------------------------------------------------------------------------

檔案系統函式庫

filegroup
取得檔案所屬的群組。

語法: int filegroup(string filename);

傳回值: 整數

函式種類: 檔案存取

內容說明

本函式傳回指定檔案的群組使用者 GID 值。傳回 false 表示發生錯誤。傳回值放在快取緩沖區中，可以參考 clearstatcache()。

--------------------------------------------------------------------------------
函式:fileinode()
--------------------------------------------------------------------------------

檔案系統函式庫

fileinode
取得檔案的 inode 值。

語法: int fileinode(string filename);

傳回值: 整數

函式種類: 檔案存取

內容說明

本函式傳回指定檔案的 inode 值。傳回 false 表示發生錯誤。傳回值放在快取緩沖區中，可以參考 clearstatcache()。

--------------------------------------------------------------------------------
函式:filemtime()
--------------------------------------------------------------------------------

檔案系統函式庫

filemtime
取得檔案最的修改時間。

語法: int filemtime(string filename);

傳回值: 整數

函式種類: 檔案存取

內容說明

本函式傳回指定檔案 filename 的最修改時間。傳回 false 表示發生錯誤。傳回值放在快取緩沖區中，可以參考 clearstatcache()。

使用范例

以下是 benbatten@home.com (29-Apr-1999) 在 Win95 上的實作范例，例中傳回當頁 Homepage 的最修改時間並將 filemtime() 傳回的 UNIX 格式的時間字串轉換成 12 小時制的字串。

(注：由本例的檔案為 __FILE__ 表示目前的檔案，其實和使用 getlastmod() 函式有相同的效果。)

$filemod = filemtime(__FILE__);
$filemodtime = date("F j Y h:i:s A", $filemod);
print("本頁最修改時間: $filemodtime");
?>

--------------------------------------------------------------------------------
函式:fileowner()
--------------------------------------------------------------------------------

檔案系統函式庫

fileowner
取得檔案的擁有者。

語法: int fileowner(string filename);

傳回值: 整數

函式種類: 檔案存取

內容說明

本函式傳回指定檔案擁有者的 UID 值。傳回 false 表示發生錯誤。傳回值放在快取緩沖區中，可以參考 clearstatcache()。

--------------------------------------------------------------------------------
函式:fileperms()
--------------------------------------------------------------------------------

檔案系統函式庫

fileperms
取得檔案的權限設定。

語法: int fileperms(string filename);

傳回值: 整數

函式種類: 檔案存取

內容說明

本函式傳回指定檔案的權限設定值。傳回 false 表示發生錯誤。傳回值放在快取緩沖區中，可以參考 clearstatcache()。

--------------------------------------------------------------------------------
函式:filesize()
--------------------------------------------------------------------------------

檔案系統函式庫

filesize
獲得檔案的大小。

語法: int filesize(string filename);

傳回值: 整數

函式種類: 檔案存取

內容說明

本函式傳回指定檔案的檔案大小。傳回 false 表示發生錯誤。傳回值放在快取緩沖區中，可以參考 clearstatcache()。

函式:filetype()
--------------------------------------------------------------------------------

檔案系統函式庫

filetype
獲得檔案的型態。

語法: string filetype(string filename);

傳回值: 字串

函式種類: 檔案存取

內容說明

本函式傳回指定檔案的檔案型態。可能的傳回型態有 fifo、char、dir、block、link、file 及 unknown 等等。傳回 false 表示發生錯誤。傳回值放在快取緩沖區中，可以參考 clearstatcache()。

--------------------------------------------------------------------------------
函式:flock()
--------------------------------------------------------------------------------

檔案系統函式庫

flock
鎖住檔案。

語法: boolean flock(int fp, int operation);

傳回值: 布林值

函式種類: 檔案存取

內容說明

本函式用來鎖住檔案，使別的行程無法存取。傳入的參數 fp 為檔案的指標。參數 operation 的值為下列的數字之一：1 表示設定鎖住檔案可以允許別的行程讀取；2 表示只有該行程可以寫入檔案；3 表示讀寫均鎖住；4 則不鎖住區塊 (block)。而本函式無論在 UNIX 或是 Windows 系列中的鎖住效果都相近。執行成功則傳回 true 值，否則傳回 false 值。

--------------------------------------------------------------------------------
函式:fopen()
--------------------------------------------------------------------------------

檔案系統函式庫

fopen
開啟檔案或者 URL。

語法: int fopen(string filename, string mode);

傳回值: 整數

函式種類: 檔案存取

內容說明

說明: 本函式可用來開啟本地或者遠端的檔案。若參數 filename 為 "http://......" 則本函數利用 HTTP 1.0 協定與伺服器連線，檔案指標則指到伺服器傳回文件的起始處。若參數 filename 為 "ftp://......." 則本函數會與伺服器連線，檔案指標指到指定的檔案處。若 FTP 伺服器沒有支援被動模式 (passive mode ftp) 則傳回失敗值。開啟的 FTP 檔案可以是讀取或寫入其中之一，但不能讀或寫二種同時使用。其它的情形，本函式開啟本地的檔案，檔案的指標則指向開啟的檔案。若開檔失敗，則傳回 false 值。

字串參數 mode 可以是下列的情形：

'r' 開檔方式為唯讀，檔案指標指到開始處。
'r+' 開檔方式為可讀寫，檔案指標指到開始處。
'w' 開檔方式為寫入，檔案指標指到開始處，並將原檔的長度設為 0。若檔案不存在，則建立新檔。
'w+' 開檔方式為可讀寫，檔案指標指到開始處，並將原檔的長度設為 0。若檔案不存在，則建立新檔。
'a' 開檔方式為寫入，檔案指標指到檔案最。若檔案不存在，則建立新檔。
'a+' 開檔方式為可讀寫，檔案指標指到檔案最。若檔案不存在，則建立新檔。
'b' 若作業系統的文字及二進位檔不同，則可以用此參數，UNIX 系統不需要使用本參數。

使用范例

第一行為 UNIX 系統使用；第二行是 Windows 系列系統的用法；第三、四行則為 URL 的使用范例。

$fp = fopen("/home/rasmus/file.txt", "r");
$fp = fopen("c:\\mydata\\info.txt", "r");
$fp = fopen("http://www.php.net/", "r");
$fp = fopen("ftp://user:password@my.com/", "w");
?>

參考

fclose()  popen()  fsockopen()

--------------------------------------------------------------------------------
函式:fpassthru()
--------------------------------------------------------------------------------

檔案系統函式庫

fpassthru
輸出所有剩余資料。

語法: int fpassthru(int fp);

傳回值: 整數

函式種類: 檔案存取

內容說明

本函式讀取檔案 fp 直到檔尾 (End of file, EOF)，並將資料輸出到標準輸出 (standard output)。若有錯誤發生，則傳回 false 值。而檔案 fp 必須由 fopen()、popen() 或 fsockopen() 開啟成功的指標。當本函式讀完檔案，會自動將檔案關閉，即 fp 變無效。如果只是要將檔案輸出到標準輸出，可以使用 readfile() 會比用 fopen() 更好。

參考

readfile()  fopen()  fclose()  popen()  fsockopen()

--------------------------------------------------------------------------------
函式:fputs()
--------------------------------------------------------------------------------

檔案系統函式庫

fputs
寫到檔案指標。

語法: int fputs(int fp, string str, int [length]);

傳回值: 整數

函式種類: 檔案存取

內容說明

本函式即 fwrite()，只是一個別名。用來將字串 str 寫到檔案指標。

函式:fread()
--------------------------------------------------------------------------------

檔案系統函式庫

fread
位元組的方式讀取檔案。

語法: string fread(int fp, int length);

傳回值: 字串

函式種類: 檔案存取

內容說明

本函式讀到指定長度的位元組或到檔尾 EOF。

使用范例

$filename = "/usr/local/myfile.txt";
$fd = fopen( $filename, "r" );
$contents = fread($fd, filesize($filename));
fclose( $fd );
?>

參考

readfile()  fopen()  fclose()  fwrite()  fgets()  fgetss()  file()  fpassthru()  popen()  fsockopen()

--------------------------------------------------------------------------------
函式:fseek()
--------------------------------------------------------------------------------

檔案系統函式庫

fseek
移動檔案指標。

語法: int fseek(int fp, int offset);

傳回值: 整數

函式種類: 檔案存取

內容說明

本函式將檔案 fp 的指標移到指定的偏移位元 (offset) 上。使用本函式就像 C 語言中的 fseek(fp, offset, SEEK_SET) 函式。成功則傳回 0，失敗則傳回 -1 值。當 fp 由 fopen() 開啟 "http://...." 或是 "ftp://...." 等 URL 檔案時，本函式無法作用。

參考

ftell()  rewind()

--------------------------------------------------------------------------------
函式:ftell()
--------------------------------------------------------------------------------

檔案系統函式庫

ftell
取得檔案讀寫指標位置。

語法: int ftell(int fp);

傳回值: 整數

函式種類: 檔案存取

內容說明

本函式傳回檔案 fp 的指標偏移位元 (offset) 值。當發生錯誤時，傳回 false 值。檔案指標 fp 必須是有效的，且使用 fopen() 或者 popen() 二個函式開啟方可作用。

參考

fopen()  popen()  fseek()  rewind()

--------------------------------------------------------------------------------
函式:fwrite()
--------------------------------------------------------------------------------

檔案系統函式庫

fwrite
二進位位元方式寫入檔案。

語法: int fwrite(int fp, string string, int [length]);

傳回值: 整數

函式種類: 檔案存取

內容說明

本函式將字串 string 寫入檔案資料流的指標 fp 上。若有指定長度 length，則會寫入指定長度字串，或是寫到字串結束。值得注意的是若指定了長度，則在 PHP 環境設定值 magic_quotes_runtime 的設定將被忽略，同時字串中的斜線不會被刪除。

參考

fread()  fopen()  popen()  fsockopen()  fputs()

--------------------------------------------------------------------------------
函式:set_file_buffer()
--------------------------------------------------------------------------------

檔案系統函式庫

set_file_buffer
設定檔案緩沖區大小。

語法: int set_file_buffer(int fp, int buffer);

傳回值: 整數

函式種類: 檔案存取

內容說明

本函式設定檔案的緩沖區大小供寫入檔案使用。若 buffer 值設為 0，則在寫入操作時無緩沖區。成功則傳回 0 值。值得注意的是當檔案開啟 (fopen) 時，會使用本函式將內定的緩沖區設為 8k。

參考

fopen()

--------------------------------------------------------------------------------
函式:is_dir()
--------------------------------------------------------------------------------

檔案系統函式庫

is_dir
測試檔案是否為目錄。

語法: boolean is_dir(string filename);

傳回值: 布林值

函式種類: 檔案存取

內容說明

本函式傳回 true 值則表示指定的 filename 為目錄名稱。傳回值放在快取緩沖區中，可以參考 clearstatcache()。

注意: php@wastelan.com (11-Jun-1999) 指出若用 is_dir("..");
的方式，傳回的也是 true。

參考

is_file()  is_link()

--------------------------------------------------------------------------------
函式:is_executable()
--------------------------------------------------------------------------------

檔案系統函式庫

is_executable
測試檔案是否為可執行檔。

語法: boolean is_executable(string filename);

傳回值: 布林值

函式種類: 檔案存取

內容說明

本函式傳回 true 值則表示指定的 filename 存在並為可執行檔。傳回值放在快取緩沖區中，可以參考 clearstatcache()。

參考

is_file()  is_link()

(http://www.fanqiang.com)     進入【UNIX論壇】

===更多相關===

★ 樊強制作歡迎分享 ★