PHP 手冊
上一頁 |  | 下一頁

# file_get_contents

(PHP 4 >= 4.3.0, PHP 5)

file_get_contents -- Reads entire file into a string

## Description

string file_get_contents ( string filename [, bool use_include_path [, resource context]])

Identical to file(), except that file_get_contents() returns the file in a string. On failure, file_get_contents() will return `FALSE`.

file_get_contents() is the preferred way to read the contents of a file into a string. It will use memory mapping techniques if supported by your OS to enhance performance.

示範 1.Using file_get_contents() with a URI

If you're opening a URI with special characters, such as spaces, you need to encode the URI with urlencode().

`<?php $url = "http://foobar.com/with funny chars"; list($protocol, $uri) = split("//", $url); $html = file_get_contents($proto . "//" . urlencode($uri)); ?>`

> 備注:這個函數可安全的使用於二進位。

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

> 備注: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 fgets(), file(), fread(), include(), and readfile().

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