From 0852df0fcc4afe5755aa9a957ab26f0340e4f1b0 Mon Sep 17 00:00:00 2001
From: Aidan Lister <aidan@php.net>
Date: Fri, 16 Jul 2004 11:20:24 +0000
Subject: [PATCH] Added an example for opening a URI

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@163442 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../filesystem/functions/file-get-contents.xml | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/reference/filesystem/functions/file-get-contents.xml b/reference/filesystem/functions/file-get-contents.xml
index c65bed05c2..6e52d54f81 100644
--- a/reference/filesystem/functions/file-get-contents.xml
+++ b/reference/filesystem/functions/file-get-contents.xml
@@ -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;