[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions file-get-contents.xml

[Aidan Lister]

aidan           Fri Jul 16 07:20:24 2004 EDT

  Modified files:              
    /phpdoc/en/reference/filesystem/functions   file-get-contents.xml 
  Log:
  Added an example for opening a URI
  
http://cvs.php.net/diff.php/phpdoc/en/reference/filesystem/functions/file-get-contents.xml?r1=1.15&r2=1.16&ty=u
Index: phpdoc/en/reference/filesystem/functions/file-get-contents.xml
diff -u phpdoc/en/reference/filesystem/functions/file-get-contents.xml:1.15 
phpdoc/en/reference/filesystem/functions/file-get-contents.xml:1.16
--- phpdoc/en/reference/filesystem/functions/file-get-contents.xml:1.15 Tue May 18 
10:23:19 2004
+++ phpdoc/en/reference/filesystem/functions/file-get-contents.xml      Fri Jul 16 
07:20:24 2004
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.15 $ -->
+<!-- $Revision: 1.16 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.130 -->
   <refentry id="function.file-get-contents">
    <refnamediv>
@@ -24,6 +24,22 @@
      contents of a file into a string.  It will use memory mapping techniques if
      supported by your OS to enhance performance.
     </para>
+    <example>
+     <title>Using <function>file_get_contents</function> with a URI</title>
+     <para>
+      If you're opening a URI with special characters, such as spaces, you need to 
encode
+      the URI with <function>urlencode</function>.
+     </para>
+     <programlisting role="php">
+<![CDATA[
+<?php
+$url = "http://foobar.com/with funny chars";
+list($protocol, $uri) = split("//", $url);
+$html = file_get_contents($proto . "//" . urlencode($uri));
+?>
+]]>
+     </programlisting>
+    </example>
     &note.bin-safe;
     &tip.fopen-wrapper;
     &note.context-support;