php readfile 函数

readfile
（ PHP 4中， PHP 5中）

readfile -输出一个文件

描述
国际readfile （字符串$文件名[ ，布尔$ use_include_path =虚假[ ，资源$背景] ] ）
读取文件并写入它的输出缓冲器。

参数

文件名
该文件被读取。

use_include_path
您可以使用可选的第二个参数设置为TRUE ，如果你想搜索该文件中的include_path中也。

背景
背景流资源。


返回值
返回的字节数读取文件。如果出现错误，虚假，除非返回的功能称为@ readfile （ ） ，错误信息打印。

实例

例如＃ 1强迫下载使用readfile （ ）

<?php
$file = 'monkey.gif';

if (file_exists($file)) {
    header('Content-Description: File Transfer');
    header('Content-Type: application/octet-stream');
    header('Content-Disposition: attachment; filename='.basename($file));
    header('Content-Transfer-Encoding: binary');
    header('Expires: 0');
    header('Cache-Control: must-revalidate, post-check=0, pre-check=0');
    header('Pragma: public');
    header('Content-Length: ' . filesize($file));
    ob_clean();
    flush();
    readfile($file);
    exit;
}
?>

is_writable
（ PHP 4中， PHP 5中）

is_writable -告诉是否filename是写

描述
布尔is_writable （字符串$文件名）
返回TRUE ，如果文件存在且可写。该文件名参数可能是一个目录名称，让您可以检查，如果是可写的目录。

请记住， PHP的可访问该文件的用户ID的Web服务器运行（通常是'谁' ） 。安全模式的限制是没有考虑到。

参数

文件名
正在检查的文件名。


返回值
返回TRUE ，如果文件存在且可写。

实例

例如＃ 1 is_writable （ ）的例子

<?php
$filename = 'test.txt';
if (is_writable($filename)) {
    echo 'The file is writable';
} else {
    echo 'The file is not writable';
}
?>

file
（ PHP 4中， PHP 5中）

file-读取整个file到一个数组

描述
一系列file（字符串$file[摘要$国旗= 0 [ ，资源$背景] ] ）
读取整个file到一个数组。

注：您可以使用file_get_contents （ ）返回file内容作为一个字符串。


参数

file名
file路径。

提示
网址可以用来作为file名与此功能，如果打开包装已启用。见fopen （ ）函数的更多细节关于如何指定file名和列表支持的协议/封装协议的列表，支持的URL协议。

旗帜
可选参数可以是一个标志，或以上，以下常数：

FILE_USE_INCLUDE_PATH
搜索该file中的include_path中。
FILE_IGNORE_NEW_LINES
不添加新行结束时，每个数组元素
FILE_SKIP_EMPTY_LINES
跳过空行
FILE_TEXT
返回的内容是在UTF - 8编码。您可以指定一个不同的编码，建立一个自定义的范围内。此标志不能用于FILE_BINARY 。此标志只适用于自PHP 6 。
FILE_BINARY
内容改为二进制数据。这是默认设置，并不能用于FILE_TEXT 。此标志只适用于自PHP 6 。

背景
背景资源创建的stream_context_create （ ）函数。


注：情况下，支持加用PHP 5.0.0 。为说明情况，请参阅流功能。



返回值
返回file中的数组。每个元素的数组对应行中的file，仍与换行符重视。一旦失败，file（ ）返回FALSE 。

注意：每行中所产生的阵列将包括行结尾，除非FILE_IGNORE_NEW_LINES使用，所以你仍然需要使用rtrim （ ）如果你不想结束本线。


注：如果PHP没有正确认识到行结尾时，无论是阅读file或创建的Macintosh电脑，使auto_detect_line_endings运行时配置选项可能有助于解决这个问题。

修改

版本说明
6.0.0新增了支援FILE_TEXT和FILE_BINARY旗帜。
5.0.0背景参数增加
5.0.0到PHP 5.0.0之前的旗帜参数只覆盖include_path中，并启用了1
4.3.0file（ ）成为二进制安全


实例

例如1号file（ ）的例子

<?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/'));

// Using the optional flags parameter since PHP 5
$trimmed = file('somefile.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
?>

file_get_contents
（ PHP 4中“ = 4.3.0 ， PHP 5中）

file_get_contents -读取整个文件转换成字符串

描述
字符串file_get_contents （字符串$文件[摘要$国旗= 0 [ ，资源$背景[摘要$抵消= -1 [摘要$ maxlen = -1 ] ] ] ] ）
这个功能类似文件（ ） ，但file_get_contents （ ）返回的字符串中的文件，开始在指定的抵消最多maxlen字节。如果失败， file_get_contents （ ）将返回FALSE 。

file_get_contents （ ）是首选的方式读取文件内容为一个字符串。它将使用内存映射技术的支持下，如果您的操作系统，以提高性能。

注：如果您打开的URI的特殊字符，如空格，你需要的URI的编码进行urlencode （ ） 。


参数

文件名
文件名改为。

旗帜
警告
所有之前的版本的PHP 6 ，此参数被称为use_include_path是布尔。国旗参数只适用于自PHP 6 。如果您使用的是旧版本，并希望搜索的文件名中包含路径，这个参数必须是真实的。自PHP 6 ，您必须使用FILE_USE_INCLUDE_PATH国旗代替。

国旗的价值可任意组合下列旗帜（与一些限制） ，加入的二进位或（ | ）操作符。


可悬挂国旗描述
FILE_USE_INCLUDE_PATH搜索文件名中包含目录。见include_path中获取更多信息。
FILE_TEXT自PHP 6 ，默认编码的读取数据是UTF - 8的。您可以指定一个不同的编码，建立一个自定义的范围内，或通过改变默认使用stream_default_encoding （ ） 。此标志不能用于FILE_BINARY 。
FILE_BINARY有了这个标志，该文件是只读二进制模式。这是默认设置，并不能用于FILE_TEXT 。


背景
资源的有效范围内建立stream_context_create （ ） 。如果你不需要使用自定义的情况下，可以跳过此参数为null 。

抵消
抵销在读启动。

maxlen
最大长度的数据读取。


返回值
该函数返回读取数据或FALSE的失败。

实例

例如＃ 1 Get和输出源的网页，网站

<?php
$homepage = file_get_contents('http://www.example.com/');
echo $homepage;
?>

Example #2 Searching within the include_path

<?php
// <= PHP 5
$file = file_get_contents('./people.txt', true);
// > PHP 5
$file = file_get_contents('./people.txt', FILE_USE_INCLUDE_PATH);
?>

file_put_contents
（ PHP 5中）

file_put_contents -写一个字符串到一个文件

描述
国际file_put_contents （字符串$文件名，混合$数据[摘要$国旗= 0 [ ，资源$背景] ] ）
这一功能是相同的要求fopen （ ）函数， fwrite （ ）和fclose （ ）先后将数据写入一个文件。

如果文件不存在，该文件的创建。否则，现有的文件被覆盖，除非FILE_APPEND旗帜设置。

参数

文件名
文件路径在哪里写的数据。

数据
这些数据给我们写信。可以是一个字符串，数组或流资源（上面解释） 。

如果数据流的资源，剩下的缓冲区的流将被复制到指定的文件。这是类似使用stream_copy_to_stream （ ） 。

您还可以指定数据参数作为一个单一的层面阵列。这相当于file_put_contents （ $文件名，爆（ '' ， $阵列） ） 。

旗帜
国旗的价值可任意组合下列旗帜（与一些限制） ，加入的二进位或（ | ）操作符。


可悬挂国旗描述
FILE_USE_INCLUDE_PATH搜索文件名中包含目录。见include_path中获取更多信息。
FILE_APPEND如果档案filename已经存在，附加数据的文件，而不是覆盖它。
LOCK_EX获得独占锁定的文件，同时着手写作。
FILE_TEXT数据写入的文字模式。如果已启用的Unicode语义，默认字符编码是UTF - 8 。您可以指定一个不同的编码，建立一个自定义的范围内或使用stream_default_encoding （ ）来更改默认的。此标志不能用于FILE_BINARY 。此标志只适用于自PHP 6 。
FILE_BINARY数据将被写入二进制模式。这是默认设置，并不能用于FILE_TEXT 。此标志只适用于自PHP 6 。


背景
资源的有效范围内建立stream_context_create （ ） 。


返回值
该函数返回的字节数是写入文件，或FALSE的失败。

实例

例如＃ 1使用简单的例子

<?php
$file = 'people.txt';
// Open the file to get existing content
$current = file_get_contents($file);
// Append a new person to the file
$current .= "John Smithn";
// Write the contents back to the file
file_put_contents($file, $current);
?>

<?php
$file = 'people.txt';
// The new person to add to the file
$person = "John Smithn";
// Write the contents to the file,
// using the FILE_APPEND flag to append the content to the end of the file
// and the LOCK_EX flag to prevent anyone else writing to the file at the same time
file_put_contents($file, $person, FILE_APPEND | LOCK_EX);
?>