PHP 手冊
上一頁 |  | 下一頁

# file

(PHP 3, PHP 4 , PHP 5)

file -- Reads entire file into an array

## Description

array file ( string filename [, int use_include_path [, resource context]])

Identical to readfile(), except that file() returns the file in an array. Each element of the array corresponds to a line in the file, with the newline still attached. Upon failure, file() returns `FALSE`.

You can use the optional use_include_path parameter and set it to "1", if you want to search for the file in the include_path, too.

`<?php
// Get a file into an array. In this example we'll go through HTTP to get
// the HTML source of a URL.
$lines = file('http://www.example.com/');
// Loop through our array, show HTML source as HTML source; and line numbers too.
foreach ($lines as $line_num => $line) {
echo "Line #<b>{$line_num}</b> : " . htmlspecialchars($line) . "<br />\n";
}
// Another example, let's get a web page into a string. See also file_get_contents().
$html = implode('', file('http://www.example.com/'));
?>`

> 心得:如果 fopen wrappers 已啟動，則可藉此函數把檔名當成URL使用。參考 fopen() 有更多關於如何指定檔名的細節和附錄 L支援URL協定的列表。

> 備注: Each line in the resulting array will include the line ending, so you still need to use rtrim() if you do not want the line ending present.

> 備注:如果遇到PHP讀取麥金塔電腦格式檔案時無法辨識行結束的問題，可能可以試著起動執行時期組態選項的auto_detect_line_endings。

> 備注: As of PHP 4.3.0 you can use file_get_contents() to return the contents of a file as a string.

> In PHP 4.3.0 file() became binary safe.

> 備注:Context support was added with PHP 5.0.0.

切記!

When using SSL, Microsoft IIS will violate the protocol by closing the connection without sending a close_notify indicator. PHP will report this as "SSL: Fatal Protocol Error" when you reach the end of the data. To workaround this, you should lower your error_reporting level not to include warnings. PHP 4.3.7 and higher can detect buggy IIS server software when you open the stream using the https:// wrapper and will suppress the warning for you. If you are using fsockopen() to create an ssl:// socket, you are responsible for detecting and suppressing the warning yourself.

See also readfile(), fopen(), fsockopen(), popen(), file_get_contents(), and include().

上一頁 | 最開頭 | 下一頁
file_put_contents | 上一層 | fileatime