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