1 檔案操作

1.1 touch

可以用來建立檔案。

(PHP 4, PHP 5, PHP 7, PHP 8)

touch—設定檔案的訪問和修改時間

1.1.1 說明

touch(string$filename,int$time= time(),int$atime= ?):bool

嘗試將由filename給出的檔案的訪問和修改時間設定為給出的time。 注意訪問時間總是會被修改的，不論有幾個引數。

如果檔案不存在，則會被建立。

1.1.2 引數

filename

要設定的檔名。

time

要設定的時間。如果沒有提供引數time則會使用當前系統的時間。

atime

如果給出了這個引數，則給定檔案的訪問時間會被設為atime

1.1.3 返回值

成功時返回true， 或者在失敗時返回false。

1.2 copy

(PHP 4, PHP 5, PHP 7, PHP 8)

copy—拷貝檔案

1.2.1 說明

copy(string$source,string$dest,resource$context= ?):bool

將檔案從source拷貝到dest。

如果要移動檔案的話，請使用rename()函式。

1.2.2 引數

source

原始檔路徑。

dest

目標路徑。如果dest是一個 URL，則如果封裝協議不支援覆蓋已有的檔案時拷貝操作會失敗。

警告

如果目標檔案已存在，將會被覆蓋。

context

A valid context resource created withstream_context_create().

1.2.3 返回值

成功時返回true， 或者在失敗時返回false。

1.3 rename

可用於移動檔案。

(PHP 4, PHP 5, PHP 7, PHP 8)

rename—重新命名一個檔案或目錄

1.3.1 說明

rename(string$oldname,string$newname,resource$context= ?):bool

嘗試把oldname重新命名為newname，必要時會在不同目錄間移動。 如果重新命名檔案時newname

1.3.2 引數

oldname

原名

注意:

用於oldname中的封裝協議必須和用於newname中的相匹配。

newname

新的名字。

注意:在 Windows 上，如果newname已經存在，它必須是可寫的。 否則rename()將失敗，並導致E_WARNING。

context

注意:在 PHP 5.0.0 中增加了對上下文（Context）的支援。有關上下文（Context）的說明參見Streams。

1.3.3 返回值

成功時返回true， 或者在失敗時返回false。

1.4 unlink

(PHP 4, PHP 5, PHP 7, PHP 8)

unlink—刪除檔案

1.4.1 說明

unlink(string$filename,resource$context= ?):bool

刪除filename。和 Unix C 的 unlink() 函式相似。 發生錯誤時會產生一個E_WARNING級別的錯誤。

1.4.2 引數

filename

檔案的路徑。

context

注意:在 PHP 5.0.0 中增加了對上下文（Context）的支援。有關上下文（Context）的說明參見Streams。

1.4.3 返回值

成功時返回true， 或者在失敗時返回false。

1.5 filesize

(PHP 4, PHP 5, PHP 7, PHP 8)

filesize—取得檔案大小

1.5.1 說明

filesize(string$filename):int

取得指定檔案的大小。

1.5.2 引數

filename

檔案的路徑。

1.5.3 返回值

返回檔案大小的位元組數，如果出錯返回false並生成一條E_WARNING級的錯誤。

注意:因為 PHP 的整數型別是有符號整型而且很多平臺使用 32 位整型，對 2GB 以上的檔案，一些檔案系統函式可能返回無法預期的結

1.6 is_file

(PHP 4, PHP 5, PHP 7, PHP 8)

is_file—判斷給定檔名是否為一個正常的檔案

1.6.1 說明

is_file(string$filename):bool

判斷給定檔名是否為一個正常的檔案。

1.6.2 引數

filename

檔案的路徑。

1.6.3 返回值

如果檔案存在且為正常的檔案則返回true，否則返回false。

注意:因為 PHP 的整數型別是有符號整型而且很多平臺使用 32 位整型，對 2GB 以上的檔案，一些檔案系統函式可能返回無法預期的結果。

1.7 file_exists

(PHP 4, PHP 5, PHP 7, PHP 8)

file_exists—檢查檔案或目錄是否存在

1.7.1 說明

file_exists(string$filename):bool

檢查檔案或目錄是否存在。

1.7.2 引數

filename

檔案或目錄的路徑。

在 Windows 中要用//computername/share/filename或者\\computername\share\filename來檢查網路中的共享檔案。

1.7.3 返回值

如果由filename指定的檔案或目錄存在則返回true，否則返回false。

注意:

This function will returnfalsefor symlinks pointing to non-existing files.

注意:

The check is done using the real UID/GID instead of the effective one.

注意:因為 PHP 的整數型別是有符號整型而且很多平臺使用 32 位整型，對 2GB 以上的檔案，一些檔案系統函式可能返回無法預期的結果。