From ab6b36e10424a6a79fd5af8a2b1f4c476dfff65e Mon Sep 17 00:00:00 2001 From: Nuno Lopes Date: Wed, 9 Feb 2005 17:06:38 +0000 Subject: [PATCH] document more PHP 5.1 changes git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@179348 c90b9560-bf6c-de11-be94-00142212c4b1 --- .../functions/file-get-contents.xml | 70 ++++++++++++++----- .../functions/file-put-contents.xml | 8 ++- 2 files changed, 61 insertions(+), 17 deletions(-) diff --git a/reference/filesystem/functions/file-get-contents.xml b/reference/filesystem/functions/file-get-contents.xml index 7888583250..879d3de199 100644 --- a/reference/filesystem/functions/file-get-contents.xml +++ b/reference/filesystem/functions/file-get-contents.xml @@ -1,24 +1,26 @@ - + file_get_contents Reads entire file into a string - - Description + + &reftitle.description; stringfile_get_contents stringfilename booluse_include_path resourcecontext intoffset + intmaxlen Identical to file, except that file_get_contents returns the file in a string, - starting at the specified offset. + starting at the specified offset up to + maxlen bytes. On failure, file_get_contents will return &false;. @@ -26,27 +28,63 @@ contents of a file into a string. It will use memory mapping techniques if supported by your OS to enhance performance. - - - The offset parameter was added in PHP 5.1.0. - - If you're opening a URI with special characters, such as spaces, you need to encode the URI with urlencode. + + + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + 5.0.0 + + Added the context support. + + + + 5.1.0 + + Added the offset and + maxlen parameters. + + + + + + + + + + &reftitle.notes; ¬e.bin-safe; &tip.fopen-wrapper; - ¬e.context-support; &warn.ssl-non-standard; - - See also fgets, file, - fread, include, - readfile &listendand; - file_put_contents - + + + + &reftitle.seealso; + + + file + fgets + fread + readfile + file_put_contents + + diff --git a/reference/filesystem/functions/file-put-contents.xml b/reference/filesystem/functions/file-put-contents.xml index 0d715c1f59..64fff59c65 100644 --- a/reference/filesystem/functions/file-put-contents.xml +++ b/reference/filesystem/functions/file-put-contents.xml @@ -1,5 +1,5 @@ - + file_put_contents @@ -29,6 +29,12 @@ (not multi-dimension arrays). This is equivalent to file_put_contents($filename, join('', $array)). + + As of PHP 5.1.0, you may also pass a stream resource to the + data parameter. In result, the remaining buffer of + that stream will be copied to the specified file. This is similar with + using stream_copy_to_stream. + ¬e.bin-safe; &tip.fopen-wrapper;