From e91f0dc8823aa12c9acce65144e81d986b4482f5 Mon Sep 17 00:00:00 2001
From: Markus Fischer <mfischer@php.net>
Date: Sun, 9 Jun 2002 23:37:41 +0000
Subject: [PATCH] - Document that parse_url does NOT validate the url in
 anyway, e.g. invalid   hostnames containg _ are still parsed (closes #12706,
 #17533).

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@85221 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/url/functions/parse-url.xml | 32 ++++++++++++++++++++++++++-
 1 file changed, 31 insertions(+), 1 deletion(-)

diff --git a/reference/url/functions/parse-url.xml b/reference/url/functions/parse-url.xml
index 2077270f3a..4feb277c92 100644
--- a/reference/url/functions/parse-url.xml
+++ b/reference/url/functions/parse-url.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/url.xml, last change in rev 1.2 -->
   <refentry id="function.parse-url">
    <refnamediv>
@@ -58,6 +58,36 @@
      </listitem>
     </itemizedlist>
    </para>
+    <para>
+     This function is <emphasis role="strong">not</emphasis> meant to validate
+     the given URL, it only breaks it up into the above listed parts. Partial
+     urls are also accepted, <function>parse_url</function> tries its best to
+     parse them correctly.
+    </para>
+    <example>
+     <title>Using <function>parse_url</function></title>
+     <screen>
+$ php -r 'print_r( parse_url("http://username:password@hostname/path?arg=value#anchor"));'
+Array
+(
+    [scheme] => http
+    [host] => hostname
+    [user] => username
+    [pass] => password
+    [path] => /path
+    [query] => arg=value
+    [fragment] => anchor
+)
+
+$ php -r 'print_r( parse_url("http://invalid_host..name/"));'
+Array
+(
+    [scheme] => http
+    [host] => invalid_host..name
+    [path] => /
+)
+     </screen>
+    </example>
     <para>
      See also <function>pathinfo</function>.
     </para>