首頁 > 文章 > 後端開發 > 總結PHP檔案函數和目錄函數

總結PHP檔案函數和目錄函數

巴扎黑原創: 2017-08-18 13:24:501528瀏覽

下面小編就為大家帶來一篇基於PHP常用檔案函數和目錄函數整理。小編覺得蠻不錯的，現在就分享給大家，也給大家做個參考。一起跟著小編過來看看吧

一、常用檔案函式庫

1、basename(); -- 返迴路徑中的檔案名稱部分。

string basename ( string $path [, string $suffix ] )
//给出一个包含有指向一个文件的全路径的字符串，本函数返回基本的文件名。

參數：path 一個路徑。在 Windows 中，斜線（/）和反斜線（\）都可以用作目錄分隔符號。在其它環境下是斜線（/）

suffix 如果檔案名稱是以 suffix 結束的，那麼這一部分也會被去掉。

傳回值：傳回 path 的基本的檔名。

$path = &#39;d:/test/test.txt&#39;;

echo basename($path);
echo "<br>";
echo basename($path,&#39;.txt&#39;);

2、dirname(); -- 返迴路徑中目錄部分

string dirname ( string $path )
//给出一个包含有指向一个文件的全路径的字符串，本函数返回去掉文件名后的目录名。

參數：path，一條路徑。在 Windows 中，斜線（/）和反斜線（\）都可以用作目錄分隔符號。在其它環境下是斜線（/）。

傳回值：傳回 path 的父目錄。如果在 path 沒有斜線，則傳回一個點（'.'），表示目前目錄。否則回傳的是把path 中結尾的 /component（最後一個斜線以及後面部分）去掉之後的字串。

$path = &#39;d:/test/test.txt&#39;;

echo basename($path);
echo "<br>";
echo basename($path,&#39;.txt&#39;);
echo "
";
echo dirname($path);

3、pathinfo(); --傳回檔案路徑的資訊

mixed pathinfo ( string $path [, int $options = PATHINFO_DIRNAME | PATHINFO_BASENAME | PATHINFO_EXTENSION | PATHINFO_FILENAME ] )
//pathinfo() 返回一个关联数组包含有 path 的信息。返回关联数组还是字符串取决于 options。

參數： path 要解析的路徑。　　　　

options 如果指定了，將會傳回指定元素；它們包括：PATHINFO_DIRNAME，PATHINFO_BASENAME 和PATHINFO_EXTENSION 或 PATHINFO_FILENAME。如果沒有指定 options 預設是傳回全部的單元。　

傳回值：若沒有傳入 options ，將會傳回包含下列單元的陣列 array：dirname，basename 和 extension（如果有），以及filename。

$path = &#39;d:/test/test.txt&#39;;
var_dump(pathinfo($path));

4、filetype();--取得檔案類型

string filetype ( string $filename )
//返回文件的类型。

#參數： filename 檔案的路徑。　

傳回值：傳回檔案的型別。

可能的值有 fifo，char，dir，block，link，file 和 unknown。如果出錯則傳回 FALSE。如果 stat 呼叫失敗或檔案類型未知的話 filetype() 也會產生一個 E_NOTICE 訊息。

$path = &#39;d:/test/test.txt&#39;;
echo filetype($path);
//结果file

5、fstat()和stat();

⑴、fstat ()-透過已開啟的檔案指標取得檔案資訊

array fstat ( resource $handle )
//获取由文件指针 handle 所打开文件的统计信息。本函数和 stat() 函数相似，除了它是作用于已打开的文件指针而不是文件名。

參數： handle 檔案系統指針，是典型地由fopen() 所建立的resource(資源)。

傳回值：傳回一個陣列具有該檔案的統計信息，該陣列的格式詳細說明於手冊中 stat() 頁面。

⑵、stat() --給予檔案的資訊

array stat ( string $filename )
//获取由 filename 指定的文件的统计信息。如果 filename 是符号连接，则统计信息是关于被连接文件本身的，而不是符号连接。
//lstat() 和 stat() 相同，只除了它会返回符号连接的状态。

參數：filename 檔案的路徑.

$path = &#39;d:/test/test.txt&#39;;

$fp = fopen("d:/test/test.txt","r");
$fstat = fstat($fp);
fclose($fp);
var_dump($fstat);

6、filesize();--取得檔案大小

int filesize ( string $filename )
//取得指定文件的大小。

參數：filename 檔案的路徑。

傳回值：傳回檔案大小的位元組數，如果發生錯誤返回 FALSE 並產生一個 E_WARNING 等級的錯誤。

<?php

// 输出类似：test.txt:  bytes

$filename = &#39;d:/test/test.txt&#39;;
echo $filename . &#39;: &#39; . filesize($filename) . &#39; bytes&#39;;

?>
//结果：d:/test/test.txt: 12 bytes

7、disk_free_space(); -- 傳回目錄中的可用空間

float disk_free_space ( string $directory )
//给出一个包含有一个目录的字符串，本函数将根据相应的文件系统或磁盘分区返回可用的字节数。

參數：directory 檔案系統目錄或磁碟分割區。

header("Content-Type:Text/html;charset=utf8");
$path = &#39;d:/test/test.txt&#39;;
$df = disk_free_space("d:/");
echo $df."字节";

8、disk_total_space(); --傳回一個目錄的磁碟總大小

float disk_total_space ( string $directory )
//给出一个包含有一个目录的字符串，本函数将根据相应的文件系统或磁盘分区返回所有的字节数。 【译者注】本函数返回的是该目录所在的磁盘分区的总大小，因此在给出同一个磁盘分区的不同目录作为参数所得到的结果完全相同。 在 Unix 和 Windows 200x/XP 中都支持将一个磁盘分区加载为一个子目录，这时正确使用本函数就很有意义。

參數：directory 檔案系統的目錄或磁碟分割區

9、fopen( $filepath,$mode)　

resource fopen ( string $filename , string $mode [, bool $use_include_path = false [, resource $context ]] )
//fopen() 将 filename 指定的名字资源绑定到一个流上

参数：filename 如果 filename 是 "scheme://..." 的格式，则被当成一个 URL，PHP 将搜索协议处理器（也被称为封装协议）来处理此模式。如果该协议尚未注册封装协议，PHP 将发出一条消息来帮助检查脚本中潜在的问题并将 filename 当成一个普通的文件名继续执行下去。

**fopen()** 中 `<span style="font-family:NSimsun">mode</span>` 的可能值列表
`<span style="color:#000000;font-size:16px;font-family:NSimsun">mode</span>`	说明
'r'	只读方式打开，将文件指针指向文件头。
'r+'	读写方式打开，将文件指针指向文件头。
'w'	写入方式打开，将文件指针指向文件头并将文件大小截为零。如果文件不存在则尝试创建之。
'w+'	读写方式打开，将文件指针指向文件头并将文件大小截为零。如果文件不存在则尝试创建之。
'a'	写入方式打开，将文件指针指向文件末尾。如果文件不存在则尝试创建之。
'a+'	读写方式打开，将文件指针指向文件末尾。如果文件不存在则尝试创建之。
'x'	创建并以写入方式打开，将文件指针指向文件头。如果文件已存在，则 fopen() 调用失败并返回 `<span style="font-family:NSimsun">FALSE</span>`，并生成一条 `<span style="font-family:NSimsun">E_WARNING</span>` 级别的错误信息。如果文件不存在则尝试创建之。这和给底层的 open(2) 系统调用指定 O_EXCL\|O_CREAT 标记是等价的。
'x+'	创建并以读写方式打开，其他的行为和 'x' 一样。

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

10、file（）；--把整个文件读入一个数组中

array file ( string $filename [, int $flags = 0 [, resource $context ]] )
//把整个文件读入一个数组中。

参数：filename 文件的路径。

flags 可选参数 flags 可以是以下一个或多个常量：

1、FILE_USE_INCLUDE_PATH 在 include_path 中查找文件。

2、FILE_IGNORE_NEW_LINES 在数组每个元素的末尾不要添加换行符

3、FILE_SKIP_EMPTY_LINES 跳过空行。

context 一个上下文资源，创建stream_context_create()函数。

<?php
// 将一个文件读入数组。本例中通过 HTTP 从 URL 中取得 HTML 源文件。
$lines = file(&#39;http://www.example.com/&#39;);
// 在数组中循环，显示 HTML 的源文件并加上行号。
foreach ($lines as $line_num => $line) {
  echo "Line #<b>{$line_num}</b> : " . htmlspecialchars($line) . "<br />\n";
}
// 另一个例子将 web 页面读入字符串。参见 file_get_contents()。
$html = implode(&#39;&#39;, file(&#39;http://www.example.com/&#39;));
// 从 PHP 5 开始可以使用可选标记参数
$trimmed = file(&#39;somefile.txt&#39;, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
?>

11、file_get_contents();-- 将整个文件读入一个字符串

string file_get_contents ( string $filename [, bool $use_include_path = false [, resource $context [, int $offset = -1 [, int $maxlen ]]]] )
//和 file() 一样，只除了 file_get_contents() 把文件读入一个字符串。将在参数 offset 所指定的位置开始读取长度为 maxlen 的内容。如果失败，file_get_contents() 将返回 FALSE。

参数：filename：要读取的文件的名称。

use_include_path：As of PHP 5 the FILE_USE_INCLUDE_PATH can be used to trigger include path search.

context：A valid context resource created with stream_context_create(). 如果你不需要自定义 context，可以用 NULL 来忽略。

header("Content-Type:Text/html;charset=utf8");
// <= PHP 5
$file = file_get_contents(&#39;d:/test/test.txt&#39;, true);
echo $file.&#39;<br>&#39;;
// > PHP 5
$file = file_get_contents(&#39;d:/test/test.txt&#39;, FILE_USE_INCLUDE_PATH);
echo $file;
//结果
//this is test
//this is test

12、fgets();--从文件指针中读取一行

string fgets ( resource $handle [, int $length ] )
//从文件指针中读取一行。

参数：handle：文件指针必须是有效的，必须指向由 fopen() 或 fsockopen() 成功打开的文件(并还未由 fclose() 关闭)。

length：从 handle 指向的文件中读取一行并返回长度最多为 length - 1 字节的字符串。碰到换行符（包括在返回值中）、EOF 或者已经读取了 length - 1 字节后停止（看先碰到那一种情况）。如果没有指定length，则默认为 1K，或者说 1024 字节。

13、ftell()；-- 返回文件指针读/写的位置

int ftell ( resource $handle )
//返回由 handle 指定的文件指针的位置，也就是文件流中的偏移量。

参数：handle ：文件指针必须是有效的，且必须指向一个通过 fopen() 或 popen() 成功打开的文件。在附加模式（加参数 "a" 打开文件）中 ftell() 会返回未定义错误。

header("Content-Type:Text/html;charset=utf8");
// opens a file and read some data
$fp = fopen("d:/test/test.txt", "r");
$data = fgets($fp, 4);
// where are we ?
echo ftell($fp); // 结果3
fclose($fp);

14、fseek()；--在文件指针中定位

int fseek ( resource $handle , int $offset [, int $whence = SEEK_SET ] )
//在与 handle 关联的文件中设定文件指针位置。 新位置从文件头开始以字节数度量，是以 whence 指定的位置加上 offset。

参数：handle：文件系统指针，是典型地由 fopen() 创建的 resource(资源)。

offset：偏移量。要移动到文件尾之前的位置，需要给 offset 传递一个负值，并设置 whence 为 SEEK_END。

whence values are:

1、SEEK_SET - 设定位置等于 offset 字节。

2、SEEK_CUR - 设定位置为当前位置加上 offset。

3、SEEK_END - 设定位置为文件尾加上 offset。

header("Content-Type:Text/html;charset=utf8");
$fp = fopen(&#39;d:\test\test.txt&#39;, &#39;r&#39;);
// read some data
$data = fgets($fp, 4096);
// move back to the beginning of the file
// same as rewind($fp);
 fseek($fp, 0);

15、flock();--轻便的咨询文件锁定　

bool flock ( resource $handle , int $operation [, int &$wouldblock ] )
//flock() 允许执行一个简单的可以在任何平台中使用的读取/写入模型（包括大部分的 Unix 派生版和甚至是 Windows）。

参数：handle 文件系统指针，是典型地由 fopen() 创建的 resource(资源)。

operation 可以是以下值之一：

1、LOCK_SH取得共享锁定（读取的程序）。

2、LOCK_EX 取得独占锁定（写入的程序。

3、LOCK_UN 释放锁定（无论共享或独占）。

如果不希望 flock() 在锁定时堵塞，则是 LOCK_NB（Windows 上还不支持）。

wouldblock：如果锁定会堵塞的话（EWOULDBLOCK 错误码情况下），可选的第三个参数会被设置为 TRUE。（Windows 上不支持）

if (flock($fp, LOCK_EX)) { // 进行排它型锁定
  ftruncate($fp, 0);   // truncate file
  fwrite($fp, "Write something here\n");
  fflush($fp);      // flush output before releasing the lock
  flock($fp, LOCK_UN);  // 释放锁定
} else {
  echo "Couldn&#39;t get the lock!";
}

fclose($fp);

16、is_readable --判断给定文件名是否可读

bool is_readable ( string $filename )
//判断给定文件名是否存在并且可读。

参数：filename：文件的路径。

返回值：如果由 filename 指定的文件或目录存在并且可读则返回 TRUE，否则返回 FALSE。　

$filename = &#39;d:\test\test.txt&#39;;
if (is_readable($filename)) {
  echo &#39;The file is readable&#39;;
} else {
  echo &#39;The file is not readable&#39;;
}
//The file is readable

17、is_writeable -- 判断给定的文件名是否可写

bool is_writable ( string $filename )
//如果文件存在并且可写则返回 TRUE。filename 参数可以是一个允许进行是否可写检查的目录名。

参数：filename 要检查的文件名称。

$filename = &#39;d:\test\test.txt&#39;;
if (is_writeable($filename)) {
  echo &#39;The file is writeable&#39;;
} else {
  echo &#39;The file is not writeable&#39;;
}
//The file is writeable

18、chown(); -- 改变文件的所有者

bool chown ( string $filename , mixed $user )
//尝试将文件 filename 的所有者改成用户 user（由用户名或用户 ID 指定）。 只有超级用户可以改变文件的所有者。

参数：filename：文件路径。

user：用户名或数字。

二、目录函数

1、is_dir（）；--判断给定文件名是否是一个目录

bool is_dir ( string $filename )
//判断给定文件名是否是一个目录。

参数：filename：如果文件名存在并且为目录则返回 TRUE。如果 filename 是一个相对路径，则按照当前工作目录检查其相对路径。

$filename = &#39;d:\test\test.txt&#39;;
var_dump(is_dir(&#39;$filename&#39;));  //bool(false) 
var_dump(is_dir(&#39;d:\test&#39;));    //bool(true)

2、mkdir（）；--新建目录

bool mkdir ( string $pathname [, int $mode = 0777 [, bool $recursive = false [, resource $context ]]] )//尝试新建一个由 pathname 指定的目录。

参数：pathname：目录的路径。

mode：默认的 mode 是 0777，意味着最大可能的访问权。有关 mode 的更多信息请阅读 chmod() 页面。
mkdir("d:/test/test1", 0700);

3、opendir（）；--打开目录句柄

resource opendir ( string $path [, resource $context ] )
//打开一个目录句柄，可用于之后的 closedir()，readdir() 和 rewinddir() 调用中。

参数：path 要打开的目录路径

context 参数的说明见手册中的 Streams API 一章。

4、readdir（）；--从目录句柄中读取条目

string readdir ([ resource $dir_handle ] )
//返回目录中下一个文件的文件名。文件名以在文件系统中的排序返回。

参数：dir_handle 目录句柄的 resource，之前由 opendir() 打开

header("Content-Type:Text/html;charset=utf8");
if ($handle = opendir(&#39;d:/test&#39;)) {
  echo "Directory handle: $handle\n";
  echo "Files:\n";

  /* 这是正确地遍历目录方法 */
  while (false !== ($file = readdir($handle))) {
    echo "$file\n";
  }

  /* 这是错误地遍历目录的方法
  while ($file = readdir($handle)) {
    echo "$file\n";
  }
  */
  closedir($handle);
}

以上是總結PHP檔案函數和目錄函數的詳細內容。更多資訊請關注PHP中文網其他相關文章！

陳述：

本文內容由網友自願投稿，版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容，請聯絡admin@php.cn

上一篇：總結PHP編譯configure時常見錯誤下一篇：總結PHP編譯configure時常見錯誤

看更多