X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2Ffunctions.html;h=d2ceb4f1856686caafa4c6f18eaddafe91e56ad0;hb=1a0dbb96fbe46a2edec1c813798cef7b0898eebe;hp=880df1014cbd51aeeacb64069c845a85423e0f6e;hpb=1f5a1441ed2a2a655f1bdcbf962c59b6e6c311a8;p=m6w6%2Fext-http diff --git a/docs/functions.html b/docs/functions.html index 880df10..d2ceb4f 100644 --- a/docs/functions.html +++ b/docs/functions.html @@ -70,14 +70,41 @@

http_functions.c

string http_date([int timestamp])

Compose a valid HTTP date regarding RFC 822/1123
+

Compose a valid HTTP date regarding RFC 1123
looking like: "Wed, 22 Dec 2004 11:34:47 GMT"

Accepts an optional unix timestamp as parameter.

Returns the HTTP date as string.

string http_build_url(mixed url[, mixed parts[, int flags = HTTP_URL_REPLACE[, array &new_url]]])

Returns the new URL as string on success or FALSE on failure.

Build an URL.

Expexts (part(s) of) an URL as first parameter in form of a string or assoziative array
+like parse_url() returns. Accepts an optional second parameter in the same way as the
+first argument. Accepts an optional third integer parameter, which is a bitmask of
+binary or'ed HTTP_URL_* constants. The optional fourth parameter will be filled
+with the results as associative array like parse_url() would return.

The parts of the second URL will be merged into the first according to the flags argument.
+The following flags are recognized:

	- HTTP_URL_REPLACE:        (default) set parts of the second url will replace the parts in the first

+	- HTTP_URL_JOIN_PATH:      the path of the second url will be merged into the one of the first

+	- HTTP_URL_JOIN_QUERY:     the two querystrings will be merged naivly; no replacements are done

+	- HTTP_URL_STRIP_USER:     the user part will not appear in the result

+	- HTTP_URL_STRIP_PASS:     the password part will not appear in the result

+	- HTTP_URL_STRIP_AUTH:     neither the user nor the password part will appear in the result

+	- HTTP_URL_STRIP_PORT:     no explicit port will be set in the result

+	- HTTP_URL_STRIP_PATH:     the path part will not appear in the result

+	- HTTP_URL_STRIP_QUERY:    no query string will be present in the result

+	- HTTP_URL_STRIP_FRAGMENT: no fragment will be present in the result

+

Example:



+<?php
        // ftp://ftp.example.com/pub/files/current/?a=b&a=c
        echo http_build_url("http://user@www.example.com/pub/index.php?a=b#files",
            array(
                "scheme" => "ftp",
                "host"   => "ftp.example.com",
                "path"   => "files/current/",
                "query"  => "a=c"
            ),
            HTTP_URL_STRIP_AUTH | HTTP_URL_JOIN_PATH | HTTP_URL_JOIN_QUERY | HTTP_URL_STRIP_FRAGMENT
        );
?>

+

+

+Returns the new URL as string on success or FALSE on failure.

string http_build_str(array query [, string prefix[, string arg_separator]])

Opponent to parse_str().

Expects an array as first argument which represents the parts of the query string to build.
+Accepts a string as optional second parameter containing a top-level prefix to use.
+The optional third parameter should specify an argument separator to use (by default the
+INI setting arg_separator.output will be used, or "&" if neither is set).

Returns the built query as string on success or FALSE on failure.

string http_negotiate_language(array supported[, array &result])

This function negotiates the clients preferred language based on its
Accept-Language HTTP header. The qualifier is recognized and languages
@@ -1328,7 +1355,7 @@ http.cache_log is set.

Generated at: Mon, 06 Feb 2006 13:45:38 +0100

Generated at: Mon, 06 Feb 2006 16:10:01 +0100