is_file
(PHP 4, PHP 5, PHP 7, PHP 8)
is_file — 判斷給定檔名是否為一個正常的檔案
說明
is_file(string
$filename): bool判斷給定檔名是否為一個正常的檔案。
參數
-
filename -
檔案的路徑。
返回值
如果檔案存在且為正常的檔案則返回 true，否則返回 false。
注意: 因為 PHP 的整數型別是有符號整型而且很多平臺使用 32 位整型，對 2GB 以上的檔案，一些檔案系統函式可能返回無法預期的結果。
範例
示例 #1 is_file() 例子
<?php
var_dump(is_file('a_file.txt')) . "\n";
var_dump(is_file('/usr/bin/')) . "\n";
?>
以上例程會輸出：
bool(true) bool(false)
錯誤／異常
失敗時拋出E_WARNING警告。
註釋
注意: 此函式的結果會被快取。參見 clearstatcache() 以獲得更多細節。
小技巧
自 PHP 5.0.0 起, 此函式也用於某些 URL 包裝器。請參見 支援的協議和封裝協議以獲得支援 stat() 系列函式功能的包裝器列表。