is_file

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

is_file判斷給定文件名是否為一個正常的文件

說明

is_file(string $filename): bool

判斷給定文件名是否為一個正常的文件。

參數(shù)

filename

文件的路徑。

返回值

如果文件存在且為正常的文件則返回 true,否則返回 false

注意: 因為 PHP 的整數(shù)類型是有符號整型而且很多平臺使用 32 位整型,對 2GB 以上的文件,一些文件系統(tǒng)函數(shù)可能返回無法預(yù)期的結(jié)果。

范例

示例 #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警告。

注釋

注意: 此函數(shù)的結(jié)果會被緩存。參見 clearstatcache() 以獲得更多細節(jié)。

小技巧

自 PHP 5.0.0 起, 此函數(shù)也用于某些 URL 包裝器。請參見 支持的協(xié)議和封裝協(xié)議以獲得支持 stat() 系列函數(shù)功能的包裝器列表。

參見

  • is_dir() - 判斷給定文件名是否是一個目錄
  • is_link() - 判斷給定文件名是否為一個符號連接