big update's coming
authorMichael Wallner <mike@php.net>
Wed, 20 Nov 2013 12:29:05 +0000 (13:29 +0100)
committerMichael Wallner <mike@php.net>
Wed, 20 Nov 2013 12:29:05 +0000 (13:29 +0100)
121 files changed:
http/Client/Request.md
http/Client/Request/__construct.md
http/Client/Request/addQuery.md
http/Client/Request/addSslOptions.md
http/Client/Request/setContentType.md
http/Client/Request/setOptions.md
http/Client/Request/setQuery.md
http/Client/Request/setSslOptions.md
http/Client/Response/getCookies.md
http/Client/Response/getTransferInfo.md
http/Client/__construct.md
http/Client/addCookies.md
http/Client/addSslOptions.md
http/Client/attach.md
http/Client/dequeue.md
http/Client/detach.md
http/Client/enableEvents.md
http/Client/enablePipelining.md
http/Client/enqueue.md
http/Client/getHistory.md
http/Client/getObservers.md
http/Client/getProgressInfo.md
http/Client/getResponse.md
http/Client/getTransferInfo.md
http/Client/notify.md
http/Client/requeue.md
http/Client/send.md
http/Client/setCookies.md
http/Client/setOptions.md
http/Client/setSslOptions.md
http/Cookie.md
http/Cookie/.md [deleted file]
http/Cookie/__construct.md
http/Cookie/addCookie.md
http/Cookie/addCookies.md
http/Cookie/addExtra.md
http/Cookie/addExtras.md
http/Cookie/setCookie.md
http/Cookie/setCookies.md
http/Cookie/setDomain.md
http/Cookie/setExpires.md
http/Cookie/setExtra.md
http/Cookie/setExtras.md
http/Cookie/setFlags.md
http/Cookie/setMaxAge.md
http/Cookie/setPath.md
http/Encoding/Stream.md
http/Encoding/Stream/Dechunk/decode.md
http/Encoding/Stream/Deflate/encode.md
http/Encoding/Stream/Inflate/decode.md
http/Encoding/Stream/__construct.md
http/Encoding/Stream/finish.md
http/Encoding/Stream/flush.md
http/Encoding/Stream/update.md
http/Env.md
http/Env/Request/__construct.md
http/Env/Response/__construct.md
http/Env/Response/setCacheControl.md
http/Env/Response/setContentDisposition.md
http/Env/Response/setContentEncoding.md
http/Env/Response/setContentType.md
http/Env/Response/setEnvRequest.md
http/Env/Response/setEtag.md
http/Env/Response/setLastModified.md
http/Env/getRequestBody.md
http/Exception.md
http/Exception/BadConversionException.md [new file with mode: 0644]
http/Exception/BadHeaderException.md [new file with mode: 0644]
http/Exception/BadMessageException.md [new file with mode: 0644]
http/Exception/BadMethodCallException.md [new file with mode: 0644]
http/Exception/BadQueryStringException.md [new file with mode: 0644]
http/Exception/BadUrlException.md [new file with mode: 0644]
http/Exception/InvalidArgumentException.md [new file with mode: 0644]
http/Exception/RuntimeException.md [new file with mode: 0644]
http/Exception/UnexpectedValueException.md [new file with mode: 0644]
http/Header.md
http/Header/parse.md
http/Header/unserialize.md
http/Message.md
http/Message/Body.md
http/Message/Body/__construct.md
http/Message/Body/addForm.md
http/Message/Body/addPart.md
http/Message/Body/append.md
http/Message/__construct.md
http/Message/detach.md
http/Message/getBody.md
http/Message/getHeader.md
http/Message/getParentMessage.md
http/Message/getRequestMethod.md
http/Message/getRequestUrl.md
http/Message/getResponseCode.md
http/Message/getResponseStatus.md
http/Message/prepend.md
http/Message/reverse.md
http/Message/setBody.md
http/Message/setHttpVersion.md
http/Message/setInfo.md
http/Message/setRequestMethod.md
http/Message/setRequestUrl.md
http/Message/setResponseCode.md
http/Message/setResponseStatus.md
http/Message/splitMultipartBody.md
http/Message/unserialize.md
http/Object.md [deleted file]
http/Object/getDefaultErrorHandling.md [deleted file]
http/Object/getErrorHandling.md [deleted file]
http/Object/setDefaultErrorHandling.md [deleted file]
http/Object/setErrorHandling.md [deleted file]
http/Object/triggerError.md [deleted file]
http/Params.md
http/Params/__construct.md
http/QueryString.md
http/QueryString/__construct.md
http/QueryString/getGlobalInstance.md
http/QueryString/getIterator.md
http/QueryString/mod.md
http/QueryString/xlate.md
http/Url.md
http/Url/__construct.md
http/Url/mod.md

index a3845502a623941d6d1ee61f23f25180623fc551..16019cecb5f6abfca235b39838765741f929ab96 100644 (file)
@@ -10,6 +10,6 @@ None.
 
 ## Properties:
 
 
 ## Properties:
 
-* array $options = NULL  
-  Options for this request, which override client options.
+* protected $options = NULL  
+  Array of options for this request, which override client options.
 
 
index e14a7ad91afcddcf95b606c1ed3c77b4967265b4..d576bf6b6f6caeb47e3ef90d050429b6e10b6dd4 100644 (file)
@@ -15,7 +15,8 @@ Create a new client request message to be enqueued and sent by http\Client.
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
 
 ## Example:
 
 
 ## Example:
 
index 5ecd5abad401f980072708c9ce94171b008097b0..b34de24566c5c79a837ea6e2025efa6582323c43 100644 (file)
@@ -11,3 +11,8 @@ See http\Client\Request::setQuery() and http\Message::setRequestUrl().
 ## Returns:
 
 * http\Client\Request, self.
 ## Returns:
 
 * http\Client\Request, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\BadQueryStringException
index 40b4bd3aab55a0f01d31e5ba92b772ead0b302f0..f11e35c208949d04377dee19d6204d91b6202b92 100644 (file)
@@ -11,3 +11,7 @@ See http\Client\Request::setSslOptions(), http\Client\Request::setOptions() and
 ## Returns:
 
 * http\Client\Request, self.
 ## Returns:
 
 * http\Client\Request, self.
+
+## Throws:
+
+* http\Client\InvalidArgumentException
index 2ec6451040d88eaa6c66ec3eed7379a96dc2b03e..68636c7a95eda9c096be89c5c0e4151133d3ec07 100644 (file)
@@ -11,6 +11,7 @@ Set the MIME content type of the request message.
 
 * http\Client\Request, self.
 
 
 * http\Client\Request, self.
 
-## Warnings:
+## Throws:
 
 
-* HTTP_E_INVALID_PARAM, if $content_type does not follow the general "primary/secondary" notation.
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
index 4742d44fd0c3d585ca8318518ace686556163ccf..577095e9caf3b3a55a10982aa83857032c6e00b8 100644 (file)
@@ -14,3 +14,6 @@ See http\Client::setOptions() and http\Client\Curl.
 
 * http\Client\Request, self.
 
 
 * http\Client\Request, self.
 
+## Throws:
+
+* http\Client\InvalidArgumentException
index 009acbda70f39077d381e831e917ff27fc9f1568..68deb3d91be985a911f3b8e62c8f1a11840925d4 100644 (file)
@@ -11,6 +11,11 @@ See http\Client\Request::addQuery() and http\Message::setRequestUrl().
 
 * http\Client\Request, self.
 
 
 * http\Client\Request, self.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\BadQueryStringException
+
 ## Example:
 
     <?php
 ## Example:
 
     <?php
index dce1008babfd7e708fc286c9d8f4a94962b602dd..36bdcbc77abc62e2a106c47050008b8108f866b4 100644 (file)
@@ -11,3 +11,7 @@ See http\Client\Request::setOptions() and http\Client\Curl::$ssl options.
 ## Returns:
 
 * http\Client\Request, self.
 ## Returns:
 
 * http\Client\Request, self.
+
+## Throws:
+
+* http\Client\InvalidArgumentException
index 15539b92f7b42f6cf86dc8c6803a235f9349fec4..7ac1fddddc29851f4f7ba8b2a73ce44229d10b8c 100644 (file)
@@ -14,7 +14,6 @@ Parses any "Set-Cookie" response headers into an http\Cookie list. See http\Cook
 
 * array, list of http\Cookie instances.
 
 
 * array, list of http\Cookie instances.
 
-
 ## Example:
 
     <?php
 ## Example:
 
     <?php
index 94eaf4356e401f1904102e73ac4171133e8f873b..94368ed4fdcf691a6c1cc9be7ae8f1c064f4e2bf 100644 (file)
@@ -10,6 +10,11 @@ See http\Client::getTransferInfo().
 
 ## Returns:
 
 
 ## Returns:
 
-* array, all transfer info if $name was not given.
+* object, stdClass instance with all transfer info if $name was not given.
 * mixed, the specific transfer info for $name.
 * mixed, the specific transfer info for $name.
-* false, if the request was not complete or $name was not found.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\BadMethodCallException
+* http\Exception\UnexpectedValueException
index adc62998e76b7c49d78f8f2054bb352254671c3d..d50178acaf5cf19e20177659f38ad7d7075ab4c3 100644 (file)
@@ -14,4 +14,6 @@ Persisted resources identified by $persistent_handle_id will be re-used if avail
 
 # Throws:
 
 
 # Throws:
 
-* http\Exception
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
+* http\Exception\RuntimeException
index 69b34db5fa9ca5413264a03c8ba13659778a2e30..dd4a17b926a146dd07ae322b026bd824c37b8a28 100644 (file)
@@ -11,3 +11,7 @@ See http\Client::setCookies().
 ## Returns:
 
 * http\Client, self.
 ## Returns:
 
 * http\Client, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index b31f2cf73c0c6b799f7337145964ef28fccad353..639ae6529fc07a8702e6ebbcdefa0069ffb7fe01 100644 (file)
@@ -11,3 +11,7 @@ See http\Client::setSslOptions(), http\Client::setOptions() and http\Client\Curl
 ## Returns:
 
 * http\Client, self.
 ## Returns:
 
 * http\Client, self.
+
+## Throws:
+
+* http\Exceptionc\InvalidArgumentException
index 8048a3ec329678313adb5229274c7582ca8361dd..3ea99fcc39ac9c6cde7120371bd88f69f5c9c0d8 100644 (file)
@@ -11,3 +11,8 @@ Attached observers will be notified with progress of each transfer.
 ## Returns:
 
 * http\Client, self.
 ## Returns:
 
 * http\Client, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
index 1b3fd2705684428e557f9ad6b4149fe42bbd5cad..a0d8ef71f9754db26afaf91120ed9a9489e10d0b 100644 (file)
@@ -15,4 +15,6 @@ See http\Client::requeue(), if you want to requeue the request, instead of calli
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\BadMethodCallException
+* http\Exception\RuntimeException
index a4c70e6e01d0d781635aaa89a00fccc09022953a..d24490ffc2340e415f36e98a40c88f9e3d7db306 100644 (file)
@@ -10,3 +10,8 @@ Implements SplSubject. Detach $observer, which has been previously attached.
 ## Returns:
 
 * http\Client, self.
 ## Returns:
 
 * http\Client, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
index de3889304fa2e53ee33587fb61eb40f1565d1a54..96bfd77e4bb2f4545644220ed1658ce9e65befdf 100644 (file)
@@ -11,3 +11,7 @@ Enable usage of an event library like libevent, which might improve performance
 
 * http\Client, self.
 
 
 * http\Client, self.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
index 6f1920696d8c32753eaaa12367b519ad15488a2f..1f4c225133f8ccadcd99af931a96f89767f28025 100644 (file)
@@ -10,3 +10,8 @@ Enable sending pipelined requests to the same host if the driver supports it.
 ## Returns:
 
 * http\Client, self.
 ## Returns:
 
 * http\Client, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
index 24ba8fa949158a9b792e2c63b2e224109c89d942..b5a6d756cee268fdc37a7ac82d910b90ec29abfb 100644 (file)
@@ -18,7 +18,9 @@ See http\Client::dequeue() and http\Client::send().
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\BadMethodCallException
+* http\Exception\RuntimeException
 
 ## Example:
 
 
 ## Example:
 
index 55beb658a6d5eb35ec8c8337a96f4221d60d4871..60d3ecff62d15b37a9ff120e55fc43ebe01c74b5 100644 (file)
@@ -12,6 +12,10 @@ None.
 
 * http\Message, the request/response message chain representing the client's history.
 
 
 * http\Message, the request/response message chain representing the client's history.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+
 ## Example:
 
     <?php
 ## Example:
 
     <?php
index fe7d0fb07ca5315c474e87b935eae75b3bce175e..a579f4a5f30253103ea1923de02b37105ccdaf31 100644 (file)
@@ -12,4 +12,5 @@ None.
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
index ca7a5e9810e0958e967a5aafb15cf34b6a7ba096..edcc394acc5b8a262c43dfc0afab230edc88f2af 100644 (file)
@@ -14,7 +14,8 @@ Retrieve the progress information for $request.
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
 
 ## Example:
 
 
 ## Example:
 
index e2dc7ca2e6836dc4978613511e37814fe5679979..00d3d95e5b2d06d23056887aec88915b02d530b1 100644 (file)
@@ -12,7 +12,12 @@ Retrieve the corresponding reponse of an already finished request, or the last r
 ## Returns:
 
 * http\Client\Response, the stored response for the request, or the last that was received.
 ## Returns:
 
 * http\Client\Response, the stored response for the request, or the last that was received.
-* NULL, if no response was found.
+* NULL, if no more response was available to pop, when no $request was given.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
 
 ## Example:
 
 
 ## Example:
 
index 30d5cc90fbaf7ffec3321a95d1eeb44bb4003ea9..6b623990529cd86042a6caa65765a605f51bb696 100644 (file)
@@ -13,7 +13,8 @@ Get transfer related informatioin for a running or finished request.
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
 
 ## Example:
 
 
 ## Example:
 
index d3f0b86efcaecf26770b4a1ed508e72170194c2b..517539fdf36e39f2040eb7efeae36556e967a919 100644 (file)
@@ -13,6 +13,11 @@ Implements SplSubject. Notify attached observers about progress with $request.
 
 * http\Client, self.
 
 
 * http\Client, self.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
+
 ## Example:
 
     <?php
 ## Example:
 
     <?php
index 1a3d6fe48d48cd0ccc923c57854feb1d48301644..08f77a24759d23d67bdc6d3375e5568e9b89e1ec 100644 (file)
@@ -13,3 +13,8 @@ The difference simply is, that this method, in contrast to http\Client::enqueue(
 ## Returns:
 
 * http\Client, self.
 ## Returns:
 
 * http\Client, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\RuntimeException
index 6ea8485b78c5387ab97e13c1e9782b8c9e765470..64e4d71044afcbc9a38586564a2686da72dbecc3 100644 (file)
@@ -13,4 +13,5 @@ None.
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\RuntimeException
index 415728e4f36e0ba642dda8f87aef8cd21e8585dd..641e1b73c989e9f09e2ed5387881f46585b0c5ff 100644 (file)
@@ -11,3 +11,7 @@ See http\Client::addCookies() and http\Client::getCookies().
 ## Returns:
 
 * http\Client, self.
 ## Returns:
 
 * http\Client, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 370441d310ba30291827ce80b2206f567d9f1fd4..50136fb05bdb5cf7994c7e1695383480b75c2139 100644 (file)
@@ -14,3 +14,6 @@ See http\Client\Curl.
 
 * http\Client, self.
 
 
 * http\Client, self.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
index d79f9926e1fdbc106b24000cccabe5db54addb33..9304c37447499ef220588e623b30d7457347798d 100644 (file)
@@ -11,3 +11,7 @@ See http\Client::setOptions() and http\Client\Curl::$ssl options.
 ## Returns:
 
 * http\Client, self.
 ## Returns:
 
 * http\Client, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index e0ca8cbcdaf34706f3833bc656d6104fdac723dd..75ce5917b80bc72c419d03d45942d0ab671c5cb0 100644 (file)
@@ -1,6 +1,6 @@
-# class http\Cookie extends http\Object
+# class http\Cookie
 
 
-A class representing a lisdt of cookies with specific attributes.
+A class representing a list of cookies with specific attributes.
 
 ## Constants:
 
 
 ## Constants:
 
diff --git a/http/Cookie/.md b/http/Cookie/.md
deleted file mode 100644 (file)
index e69de29..0000000
index ac0cf01b61e348d0065febc0bea4358c3ceabe7d..cb63600b35ad69af5cfb8c07ad75e5b62137e909 100644 (file)
@@ -13,7 +13,8 @@ Create a new cookie list.
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\RuntimeException
 
 ## Example:
 
 
 ## Example:
 
index e2c1396687f0bfe963d9a47c843a2dcb21211637..a32fc22a39926e035686f9cb3bb31ec6de264d07 100644 (file)
@@ -13,3 +13,7 @@ See http\Cookie::setCookie() and http\Cookie::addCookies().
 ## Returns:
 
 * http\Cookie, self.
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 70e727f151042794d1e0167bc914a1d16b71f7e8..a261f2fa63cd19ffedc3c81c2dc682c63c444ddd 100644 (file)
@@ -11,3 +11,7 @@ See http\Cookie::setCookies().
 ## Returns:
 
 * http\Cookie, self.
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 4d7716ef13e8aa3022d1b564058943a6c1225ce1..af399688fc90751baf4bb31957f99200c806e391 100644 (file)
@@ -13,3 +13,7 @@ See http\Cookie::setExtra().
 ## Returns:
 
 * http\Cookie, self.
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index be04741931daa8446aa4eb595d34d3bac316c1f4..0693b7761065c16465430998254833d997dead53 100644 (file)
@@ -11,3 +11,7 @@ See http\Cookie::addExtra().
 ## Returns:
 
 * http\Cookie, self.
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 5b26502d25e5e943de279a2ac78a616fb4f31954..15b88d09cf5fb0908a61bfb50bbca850952bde73 100644 (file)
@@ -15,3 +15,7 @@ See http\Cookie::addCookie() and http\Cookie::setCookies().
 ## Returns:
 
 * http\Cookie, self.
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index d518aa26c09055bc9909d24c3f14d9af0932bf3f..e3f4366ed1b47135e0a7e8805681c02ae29295ea 100644 (file)
@@ -11,3 +11,7 @@ See http\Cookie::addCookies().
 ## Returns:
 
 * http\Cookie, self.
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index ed7f8b9005e2b4f3081c104b7483cc694aa74a70..098104c7df7cefc02fe518dbf6dd3fe03d662087 100644 (file)
@@ -11,3 +11,7 @@ See http\Cookie::setPath().
 ## Returns:
 
 * http\Cookie, self.
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 9878e88e6329c186f2a21f032d5cad83a1186316..736ae3ed55293322690809133597dbac36f674ff 100644 (file)
@@ -11,3 +11,7 @@ See http\Cookie::setMaxAge() for a safer alternative.
 ## Returns:
 
 * http\Cookie, self.
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 6308f63f4f7563105a7e4e5e1818babce17d7cfb..ff40921cb65eb766979f039f9d3a4cdb97e3ff7c 100644 (file)
@@ -15,3 +15,7 @@ See http\Cookie::addExtra().
 ## Returns:
 
 * http\Cookie, self.
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index b77caee8a7fb63cab5c95e24ff5005ac820a2e38..4253de76e586ad62859f19d02be480b5a2127df3 100644 (file)
@@ -11,3 +11,7 @@ See http\Cookie::addExtras().
 ## Returns:
 
 * http\Cookie, self.
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 818eb423446026a222b6c13519bee346e99ed00d..e724750efdb99730972253e172357fc292b53ca7 100644 (file)
@@ -11,3 +11,7 @@ See http\Cookie::SECURE and http\Cookie::HTTPONLY constants.
 ## Returns:
 
 * http\Cookie, self.
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 724cc5416935c998d6bd84952866c321f907d423..0840338a9c17014b987e206ce43ee75cfb0cf26f 100644 (file)
@@ -12,3 +12,7 @@ See http\Cookie::setExpires().
 ## Returns:
 
 * http\Cookie, self.
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index fa046284d79bbf66f93ad647e406ef9321ca8eb7..216f1518d008516cf9f976236dbd595392388941 100644 (file)
@@ -11,3 +11,7 @@ See http\Cookie::setDomain().
 ## Returns:
 
 * http\Cookie, self.
 ## Returns:
 
 * http\Cookie, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 0656593f5e9ace9bd754b1eac781210f84765ca5..b63848f6e5a2fba93aab9b60bdb54ab79c695069 100644 (file)
@@ -1,4 +1,4 @@
-# abstract class http\Encoding\Stream extends http\Object
+# abstract class http\Encoding\Stream
 
 Base class for encoding stream implementations.
 
 
 Base class for encoding stream implementations.
 
index e87d79e3cae6dd53561f20419732d344ef0264f3..674510e5658fd83beed6d2fb7f104b8e217aaaf3 100644 (file)
@@ -1,4 +1,4 @@
-# static string http\Encoding\Stream\Dechunk::decode(string $data)
+# static string http\Encoding\Stream\Dechunk::decode(string $data[, int &$decoded_len = 0])
 
 Decode chunked encoded data.
 
 
 Decode chunked encoded data.
 
@@ -6,7 +6,21 @@ Decode chunked encoded data.
 
 * string $data  
   The data to decode.
 
 * string $data  
   The data to decode.
+* Optional reference int $decoded_len = 0  
+  Out parameter with the length of $data that's been decoded.
+  Should be ```strlen($data)``` if not truncated.
 
 ## Returns:
 
 * string, the decoded data.
 
 ## Returns:
 
 * string, the decoded data.
+* string, the unencoded data.
+* string, the truncated decoded data.
+* false, if $data cannot be decoded.
+
+## Notices:
+
+* If $data does not seem to be chunked encoded.
+
+## Warnings:
+
+* If $data cannot be decoded or is truncated.
index 7a8ff70854b74512c14dc3968b93f8338fd6572b..991feb76b316459f013d2272675326701ab5a092 100644 (file)
@@ -12,3 +12,6 @@ Encode data with deflate/zlib/gzip encoding.
 ## Returns:
 
 * string, the compressed data.
 ## Returns:
 
 * string, the compressed data.
+## Warnings:
+
+* If $data cannot be encoded.
index 74c504890ea2165ca89b8315779f2edebab4cbc0..2eaf7a1b0de51efa7e77b25e4a5ee4bc524ed33b 100644 (file)
@@ -10,3 +10,7 @@ Decode deflate/zlib/gzip encoded data.
 ## Returns:
 
 * string, the uncompressed data.
 ## Returns:
 
 * string, the uncompressed data.
+
+## Warnings:
+
+* If $data cannot be decoded.
index baf89232074ab1d9ee8c3a9242d490f34ab9e011..0ce9701a50472f0c7dae6912a2934067853d0e1d 100644 (file)
@@ -9,4 +9,5 @@ Base constructor for encoding stream implementations.
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\RuntimeException
index 3ec8e1239fcd7cdf9f1625f8bd20920b4b462576..e7ca08f47cbd64b76deaa83fb47e5adaf8868832 100644 (file)
@@ -10,3 +10,7 @@ None.
 ## Returns:
 
 * string, any pending data.
 ## Returns:
 
 * string, any pending data.
+
+## Warnings:
+
+* If the encoding stream is in an invalid state.
index 5daea861a54b8cb147230474315fd0ebd26f2144..620a04b4276868ae332b946cc56d09f61a7bb942 100644 (file)
@@ -10,3 +10,7 @@ None.
 ## Returns:
 
 * string, any pending data.
 ## Returns:
 
 * string, any pending data.
+
+## Warnings:
+
+* If the encoding stream is in an invalid state.
index 7bcdd9bbb22f450b47e6e9a4ad3a34be98d92bad..fd81eaf9cb19081a8e397e5d6819ca82d72f3c15 100644 (file)
@@ -10,3 +10,7 @@ Update the encoding stream with more input.
 ## Returns:
 
 * string, processed data.
 ## Returns:
 
 * string, processed data.
+
+## Warnings:
+
+* If the encoding stream is in an invalid state.
index e33774a845a2296ebf57602cc9b181d9074ea3ea..5571b9df34a286dffd63652feebf69ec42dfd8e4 100644 (file)
@@ -1,4 +1,4 @@
-# class http\Env extends http\Object
+# class http\Env
 
 The http\Env class provides static methods to manipulate and inspect the server's current request's HTTP environment.
 
 
 The http\Env class provides static methods to manipulate and inspect the server's current request's HTTP environment.
 
index 0e5707245e52476b458bc46d80b0e88be01e10c2..19ab5a1633d25d82d2323b2f89922f0d7a9a0ee1 100644 (file)
@@ -10,3 +10,7 @@ It also compiles an array of uploaded files ($\_FILES) more comprehensive than t
 
 None.
 
 
 None.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
index fc2e6d942c9eb13f0864fe82387508c8e161db5a..6c866442c4b0135887b6fb327b93e2daf1e39bb7 100644 (file)
@@ -8,7 +8,8 @@ None.
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
 
 ## Example:
 
 
 ## Example:
 
index 0ab810c287a08727dbf3fb6a941e3c84f222d26c..31e2dec1e8b2ddc937e1ba0fc7465d63c7497c1f 100644 (file)
@@ -10,3 +10,7 @@ Make suggestions to the client how it should cache the response.
 ## Returns:
 
 * http\Env\Response, self.
 ## Returns:
 
 * http\Env\Response, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 0b4a5514838920bd5a2012ff728c4153c19e377c..e03dd3c5dc48f560edaf7c97b5ca4cd9f88fadff 100644 (file)
@@ -11,6 +11,10 @@ Set the reponse's content disposition parameters.
 
 * http\Env\Response, self.
 
 
 * http\Env\Response, self.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+
 ## Example:
 
     <?php ob_end_Clean();chdir(__DIR__."/../../..");
 ## Example:
 
     <?php ob_end_Clean();chdir(__DIR__."/../../..");
index 3b3d612f8a0014a6c53e30b46ff09115ba5df16b..693e1a005f934e0262dd505f723ad1a165c62ee5 100644 (file)
@@ -11,3 +11,7 @@ The response will be compressed if the client indicates support and wishes that.
 ## Returns:
 
 * http\Env\Response, self.
 ## Returns:
 
 * http\Env\Response, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 78674dfa317a80f633876c41f36382d79c2acfe9..79ca97e92c1e4322c731150713bb00c5033b6429 100644 (file)
@@ -10,3 +10,7 @@ Set the MIME content type of the response.
 ## Returns:
 
 * http\Env\Response, self.
 ## Returns:
 
 * http\Env\Response, self.
+
+## Throws:
+
+* http\Env\InvalidArgumentException
index 83cb5bf1eace7eef5764c70b7eb410d881572928..8d4b937774dca0a006033b2aa59fce879a74c437 100644 (file)
@@ -11,6 +11,10 @@ Override the environment's request.
 
 * http\Env\Response, self.
 
 
 * http\Env\Response, self.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+
 ## Example:
 
     <?php
 ## Example:
 
     <?php
index b8d0e66bc291461861e0dd8dd92a755ee570febe..f71c80bdcd17b6a322a6d7b7746543122eec5f84 100644 (file)
@@ -12,3 +12,7 @@ Set a custom ETag.
 ## Returns:
 
 * http\Env\Response, self.
 ## Returns:
 
 * http\Env\Response, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 17f433756976e0f0f093a98d2579b2d3a55b914b..a057605d6bc20cfee9d964ffa982fa1b416ed39d 100644 (file)
@@ -12,3 +12,7 @@ Set a custom last modified time stamp.
 ## Returns:
 
 * http\Env\Response, self.
 ## Returns:
 
 * http\Env\Response, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index eaadc0d5058301155bd8d13ff4f9913c9f6e2d4a..4fcd24a3217b13b1aee6f9ef088e8e7a5ef152af 100644 (file)
@@ -13,4 +13,5 @@ Retreive the current HTTP request's body.
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
index 4f6609eb40d2743e1564301931d97a07d9df028a..e27b813185bbfc59de507031979b8718b61a8ec4 100644 (file)
@@ -1,27 +1,29 @@
-# class http\Exception extends Exception
+# interface http\Exception
 
 
-The http extension's Exception.
+The http extension's Exception interface.
 
 
-## Constants:
+Use it to catch any Exception thrown by pecl/http.
 
 
-* E_UNKNOWN  
-* E_RUNTIME  
-* E_INVALID_PARAM  
-* E_HEADER  
-* E_MALFORMED_HEADERS  
-* E_MESSAGE  
-* E_MESSAGE_TYPE  
-* E_MESSAGE_BODY  
-* E_ENCODING  
-* E_CLIENT  
-* E_CLIENT_POOL  
-* E_CLIENT_DATASHARE  
-* E_SOCKET  
-* E_RESPONSE  
-* E_URL  
-* E_QUERYSTRING  
-* E_COOKIE  
+The individual exception classes extend their equally named native PHP extensions, if such exist, and implement this empty interface. For example the http\Exception\BadMethodCallException extends SPL's BadMethodCallException.
 
 ## Properties:
 
 None.
 
 ## Properties:
 
 None.
+
+## Example:
+
+    <?php
+    $req = new http\Env\Request;
+    
+    try {
+        $messages = $req->splitMultipartBody();
+    } catch (http\Exception\BadMethodCallException $e) {
+        // doh, no multipart message
+    } catch (http\Exception\BadMessageException $e) {
+        // failure while parsing
+    } catch (http\Exception $e) {
+        // here we used the interface to catch any http\Exception
+    } catch (Exception $e) {
+        // catch any other exception (unlikely, though)
+    }
+    ?>
diff --git a/http/Exception/BadConversionException.md b/http/Exception/BadConversionException.md
new file mode 100644 (file)
index 0000000..506f62e
--- /dev/null
@@ -0,0 +1,3 @@
+# class http\Exception\BadConversionException extends DomainException implements http\Exception
+
+A bad conversion (e.g. character conversion) was encountered.
diff --git a/http/Exception/BadHeaderException.md b/http/Exception/BadHeaderException.md
new file mode 100644 (file)
index 0000000..a8faafc
--- /dev/null
@@ -0,0 +1,3 @@
+# class http\Exception\BadHeaderException extends DomainException implements http\Exception
+
+A bad HTTP header was encountered.
diff --git a/http/Exception/BadMessageException.md b/http/Exception/BadMessageException.md
new file mode 100644 (file)
index 0000000..8397c4d
--- /dev/null
@@ -0,0 +1,3 @@
+# class http\Exception\BadMessageException extends DomainException implements http\Exception
+
+A bad HTTP message was encountered.
diff --git a/http/Exception/BadMethodCallException.md b/http/Exception/BadMethodCallException.md
new file mode 100644 (file)
index 0000000..fcd7b90
--- /dev/null
@@ -0,0 +1,3 @@
+# class http\Exception\BadMethodCallException extends BadMethodCallException implements http\Exception
+
+A method was called on an object, which was in an invalid or unexpected state.
diff --git a/http/Exception/BadQueryStringException.md b/http/Exception/BadQueryStringException.md
new file mode 100644 (file)
index 0000000..359b4fd
--- /dev/null
@@ -0,0 +1,3 @@
+# class http\Exception\BadQueryStringException extends DomainException implements http\Exception
+
+A bad querystring was encountered.
diff --git a/http/Exception/BadUrlException.md b/http/Exception/BadUrlException.md
new file mode 100644 (file)
index 0000000..2305e68
--- /dev/null
@@ -0,0 +1,3 @@
+# class http\Exception\BadUrlException extends DomainException implements http\Exception
+
+A bad HTTP URL was encountered.
diff --git a/http/Exception/InvalidArgumentException.md b/http/Exception/InvalidArgumentException.md
new file mode 100644 (file)
index 0000000..9276c81
--- /dev/null
@@ -0,0 +1,3 @@
+# class http\Exception\InvalidArgumentException extends InvalidArgumentException implements http\Exception
+
+One or more invalid arguments were passed to a method.
diff --git a/http/Exception/RuntimeException.md b/http/Exception/RuntimeException.md
new file mode 100644 (file)
index 0000000..b41a4d5
--- /dev/null
@@ -0,0 +1,4 @@
+# class http\Exception\RuntimeException extends RuntimeException implements http\Exception
+
+A generic runtime exception.
+
diff --git a/http/Exception/UnexpectedValueException.md b/http/Exception/UnexpectedValueException.md
new file mode 100644 (file)
index 0000000..0da97fa
--- /dev/null
@@ -0,0 +1,3 @@
+# class http\Exception\UnexpectedValueException extends UnexpectedValueException implements http\Exception
+
+An unexpected value was encountered.
index 6261bae2b0ab949e46ddbc98686993f5a9d2f087..59ad426f1ba88801fea281b8c788fa2e573df0dc 100644 (file)
@@ -1,4 +1,4 @@
-# class http\Header extends http\Object implements Serializable
+# class http\Header implements Serializable
 
 The http\Header class provides methods to manipulate, match, negotiate and serialize HTTP headers.
 
 
 The http\Header class provides methods to manipulate, match, negotiate and serialize HTTP headers.
 
index 4e2c5a1620effd28bcec3a9f2cf2f62773c86def..84c7d82bdfde9eb048dc21f6603dd5c45a593379 100644 (file)
@@ -12,3 +12,8 @@ Parse HTTP headers.
 ## Returns:
 
 * array of parsed headers, where the elements are instances of $header_class if specified.
 ## Returns:
 
 * array of parsed headers, where the elements are instances of $header_class if specified.
+* false, if parsing fails.
+
+## Warnings:
+
+* If the header parser fails.
index 3a40de6425945ce4f4e633fc01238588ce35a007..91e356635fd93662e916442038aba5f8ca0b6178 100644 (file)
@@ -7,3 +7,6 @@ Implements Serializable.
 * string $serialized  
   The serialized HTTP header (i.e. "Name: value")
 
 * string $serialized  
   The serialized HTTP header (i.e. "Name: value")
 
+## Warnings:
+
+* If the header parser fails.
index cdb4c30e634965a6e934e3a9b4aa6007b938cb69..ca48ff2ae7d677511f429025f0e7f81f19e05cbd 100644 (file)
@@ -1,4 +1,4 @@
-# class http\Message extends http\Object implements Countable, Serializable, Iterator
+# class http\Message implements Countable, Serializable, Iterator
 
 The message class builds the foundation for any request and response message.
 See http\Client\Request and http\Client\Response, as well as http\Env\Request and http\Env\Response.
 
 The message class builds the foundation for any request and response message.
 See http\Client\Request and http\Client\Response, as well as http\Env\Request and http\Env\Response.
index 01c3479819a17685641995cbab04a85778d79d45..ef684ad3f8fc87145efc740d04145d36218ab815 100644 (file)
@@ -1,4 +1,4 @@
-# class http\Message\Body extends http\Object implements Serializable
+# class http\Message\Body implements Serializable
 
 The message body, represented as a PHP (temporary) stream.
 
 
 The message body, represented as a PHP (temporary) stream.
 
index 2ef43e011075cb257a8a015e8b564dc1b0fd808c..0a144c6c5f5ae49786c2cb2b636a612843f6347c 100644 (file)
@@ -9,7 +9,8 @@ Create a new message body, optionally referencing $stream.
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
 
 ## Example:
 
 
 ## Example:
 
index d71fda90b43b81103cc7a2cb23704c901b546fd0..19e3b6cda2d739943b905fe953c1dffc6402088a 100644 (file)
@@ -47,6 +47,11 @@ As you can see, a file structure must contain a "file" entry, which holds a file
 
 * http\Message\Body, self.
 
 
 * http\Message\Body, self.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\RuntimeException
+
 ## Example:
 
     <?php
 ## Example:
 
     <?php
index 8a2f8a743c2c71ed345c736641ec168e71efecc7..424a91b4537ce335be51421508f8315168734959 100644 (file)
@@ -11,6 +11,11 @@ Add a part to a multipart body.
 
 * http\Message\Body, self.
 
 
 * http\Message\Body, self.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\RuntimeException
+
 ## Example:
 
     <?php
 ## Example:
 
     <?php
index 5cf06010e461f6176984c95502c8efbe318bbf21..5503e4543038f0ddcc83e18e559fa9a40d7fed92 100644 (file)
@@ -12,6 +12,7 @@ Append plain bytes to the message body.
 * http\Message\Body, self.
 
 
 * http\Message\Body, self.
 
 
-## Warnings:
+## Throws:
 
 
-* E_MESSAGE_BODY, if writing to the body fails.
+* http\Exception\InvalidArgumentException
+* http\Exception\RuntimeException
index 61f7ef0f657af86d8f132546c2b8ff8d1d98ef67..f61f50d6ca9eefed887831330aea2535fec68f96 100644 (file)
@@ -11,4 +11,5 @@ Create a new HTTP message.
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\BadMessageException
index fa12d44fb7c7e9235d366d1cbc7c3971ad81d17a..965b54d42d47dbe9d37f46f4cfe627ace0058971 100644 (file)
@@ -12,4 +12,4 @@ None.
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException.
index 013f22a0b2a5c49504de6a1c3879fea89ecb2571..d95d9c26a5bd6814fd23131bb3baabc978b55861 100644 (file)
@@ -13,4 +13,5 @@ None.
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueEcxeption
index 08efe967a087e83d804bff9a89caefe78fedacfa..62bddc8142c019b0cdcad472118985d1976ca99e 100644 (file)
@@ -16,7 +16,7 @@ Retrieve a single header, optionally hydrated into a http\Header extending class
 
 ## Warnings:
 
 
 ## Warnings:
 
-* E_INVALID_PARAM, if $into_class is not a descendant of http\Header.
+* If $into_class is specified but is not a descendant of http\Header.
 
 ## Example:
 
 
 ## Example:
 
index ace45d5f1f167dc2217af67170cde79c30a8ab04..f1170d4f82782d606dc55b28f0ba9de6b06df3fb 100644 (file)
@@ -13,7 +13,8 @@ None.
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\BadMethodCallException
 
 
 ## Example:
 
 
 ## Example:
index 14c73b6fd7682cf043fd0ff9424f3e043f26f502..bae3345c24df5ffc74acd10419fb1939ead94084 100644 (file)
@@ -12,6 +12,6 @@ None.
 * string, the request method.
 * false, if the message was not of type request.
 
 * string, the request method.
 * false, if the message was not of type request.
 
-## Notices:
+## Warnings:
 
 
-* E_MESSAGE_TYPE, if the message is not of type request.
+* If the message is not of type request.
index 0c0069c32a52fc6184e6fc59252ae742b92f20b0..c4d0e3266c3a5ecdad63015415e1bdeea04da1f9 100644 (file)
@@ -12,6 +12,6 @@ None.
 * string, the request URL; usually the path and the querystring.
 * false, if the message was not of type request.
 
 * string, the request URL; usually the path and the querystring.
 * false, if the message was not of type request.
 
-## Notices:
+## Warnings:
 
 
-* E_MESSAGE_TYPE, if the message is not of type request.
+* If the message is not of type request.
index 83032036c7ec75e6a5743f94101872375da61f19..519c09d736b7e55cc842a8854aa5f8d1937b89a6 100644 (file)
@@ -12,6 +12,6 @@ None.
 * int, the response status code.
 * false, if the message is not of type response.
 
 * int, the response status code.
 * false, if the message is not of type response.
 
-## Notices:
+## Warnings:
 
 
-* E_MESSAGE_TYPE, if the message is not of type response.
+* If the message is not of type response.
index d90cee1b48e63fefd477c34471c3aecd09d9dfdc..7717eaf24683af7bda32eb307a65e45b2bc7a87e 100644 (file)
@@ -12,6 +12,6 @@ None.
 * string, the response status phrase.
 * false, if the message is not of type response.
 
 * string, the response status phrase.
 * false, if the message is not of type response.
 
-## Notices:
+## Warnings:
 
 
-* E_MESSAGE_TYPE, if the message is not of type response.
+* If the message is not of type response.
index e010901580399ad4001c94050b5f1d55f742ff74..7bc88df959f3833e90a1ef18fd1eb45136133884 100644 (file)
@@ -17,4 +17,5 @@ Prepend message(s) $message to this message, or the top most message of this mes
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception.
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
index 12030e906ad982debe28b51fa1de2fe482578c75..9189589b4ca2fcda68fe6301b07a290fb9105722 100644 (file)
@@ -13,3 +13,7 @@ None.
 ## Returns:
 
 * http\Message, the other end of the message chain.
 ## Returns:
 
 * http\Message, the other end of the message chain.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
index 9cd55f8aa3da3c044e844b0cbcbd2ed4d145f1d9..9baa0dc898823f705250e3c403563fe10c7fa8c7 100644 (file)
@@ -11,3 +11,8 @@ See http\Message::getBody() and http\Message::addBody().
 ## Returns:
 
 * http\Message, self.
 ## Returns:
 
 * http\Message, self.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\UnexpectedValueException
index ee9ab0ab685bf7dabf1b57d75eb43427b122061d..06bf2a7a685a9f4fc90ee71352e1a3ccd4067e03 100644 (file)
@@ -14,11 +14,12 @@ See http\Message::getHttpVersion().
 
 ## Notices:
 
 
 ## Notices:
 
-* E_MALFORMED_HEADERS, if the version separator is non-standard.
+* If a non-standard version separator is encounted.
 
 
-## Warnings:
+## Throws:
 
 
-* E_MALFORMED_HEADERS, if the version could not be parsed.
+* http\Exception\InvalidArgumentException
+* http\Exception\BadHeaderException
 
 ## Example:
 
 
 ## Example:
 
index 36e63fa5369a89388f0c51ed26fba60fe400869f..820de0262f9179d5cdf9461e329d96c7f7ad4a22 100644 (file)
@@ -12,9 +12,10 @@ See http\Message::getInfo().
 
 * http\Message, self.
 
 
 * http\Message, self.
 
-## Warnings:
+## Throws:
 
 
-* E_MALFORMED_HEADERS, if the message information could not be parsed.
+* http\Exception\InvalidArgumentException
+* http\Exception\BadHeaderException
 
 ## Format of the message info:
 
 
 ## Format of the message info:
 
index a15e9c12222ba21e3d4141ade8b7b523c8b13ccb..2ec295eef7c8ddad8d9505e740d08771a47d91d8 100644 (file)
@@ -11,12 +11,8 @@ See http\Message::getRequestMethod() and http\Message::setRequestUrl().
 ## Returns:
 
 * http\Message, self.
 ## Returns:
 
 * http\Message, self.
-* false, if the message was not of type request.
 
 
-## Notices:
+## Throws:
 
 
-* E_MESSAGE_TYPE, if the message is not of type request.
-
-## Warnings:
-
-* E_INVALID_PARAM, if the method is of zero length.
+* http\Exception\InvalidArgumentException
+* http\Exception\BadMethodCallException
index 9c6663debb05f87a9a45e179ebdc2252ab2087eb..30e4a7dccd097dc53d74bda8806f218a5465025d 100644 (file)
@@ -11,15 +11,11 @@ See http\Message::getRequestUrl() and http\Message::setRequestMethod().
 ## Returns:
 
 * http\Message, self.
 ## Returns:
 
 * http\Message, self.
-* false, if the message was not of type request.
 
 
-## Notices:
+## Throws:
 
 
-* E_MESSAGE_TYPE, if the message is not of type request.
-
-## Warnings:
-
-* E_INVALID_PARAM, if the url is of zero length.
+* http\Exception\InvalidArgumentException
+* http\Exception\BadMethodCallException
 
 ## Example:
 
 
 ## Example:
 
index 58c8d82272922dfb5a06235b316454ed861a3709..71ff8f05f1faa2148480eb8c7af26686088f4a90 100644 (file)
@@ -1,15 +1,22 @@
-# http\Message http\Message::setResponseCode(int $response_code)
+# http\Message http\Message::setResponseCode(int $response_code[, bool $strict = true])
 
 Set the response status code.
 See http\Message::getResponseCode() and http\Message::setResponseStatus().
 
 
 Set the response status code.
 See http\Message::getResponseCode() and http\Message::setResponseStatus().
 
+> **Note:** This method also resets the response status phrase to the default for that code.
+
 ## Params:
 
 * int $response_code  
   The response code.
 ## Params:
 
 * int $response_code  
   The response code.
+* Optional bool $strict = true  
+  Whether to check that the response code is between 100 and 599 inclusive.
 
 ## Returns:
 
 * http\Message, self.
 
 ## Returns:
 
 * http\Message, self.
-* false, if the message is not of type response.
 
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\BadMethodCallException
index b1ba28602d50dc18c8bc3705509c92df824f76b8..c67fa26044416d247d91dfba6f076eb7591e3c31 100644 (file)
@@ -11,12 +11,11 @@ See http\Message::getResponseStatus() and http\Message::setResponseCode().
 ## Returns:
 
 * http\Message, self.
 ## Returns:
 
 * http\Message, self.
-* false, if the message is not of type response.
 
 
-## Notice:
-
-* E_MESSAGE_TYPE, if the message is not of type response.
+## Throws:
 
 
+* http\Exception\InvalidArgumentException
+* http\Exception\BadMethodCallException
 
 ## Example:
 
 
 ## Example:
 
index 10f2ac63d3171e47f4c312b2084ef7705d772c44..8e59e4805a79d5b9fc95652cf9372fed2a38f500 100644 (file)
@@ -11,6 +11,12 @@ None.
 
 * http\Message, a message chain of all messages of the multipart body.
 
 
 * http\Message, a message chain of all messages of the multipart body.
 
+## Throws:
+
+* http\Exception\InvalidArgumentException
+* http\Exception\BadMethodCallException
+* http\Exception\BadMessageException
+
 ## Example:
 
     <?php
 ## Example:
 
     <?php
index 1648ced773fe537c13324d3d7f01f56908afde47..ff1e4e5ec43bb509ca4fd42acc2d999060f61dd2 100644 (file)
@@ -7,3 +7,6 @@ Implements Serializable.
 * string $data  
   The serialized message.
 
 * string $data  
   The serialized message.
 
+## Errors:
+
+* If the message could not be unserialized.
diff --git a/http/Object.md b/http/Object.md
deleted file mode 100644 (file)
index a04b873..0000000
+++ /dev/null
@@ -1,19 +0,0 @@
-# abstract class http\Object
-
-The http\Object class provides an error handling foundation for the rest of the http extension's framwework.
-
-## Constants:
-
-* EH_NORMAL  
-  Normal error handling.
-* EH_SUPPRESS  
-  Suppress errors.
-* EH_THROW  
-  Throw exceptions on errors.
-
-## Properties:
-
-* static protected $defaultErrorHandling = NULL  
-  Static default error handling.
-* protected $errorHandling = NULL  
-  Per instance error handling.
diff --git a/http/Object/getDefaultErrorHandling.md b/http/Object/getDefaultErrorHandling.md
deleted file mode 100644 (file)
index 936d36e..0000000
+++ /dev/null
@@ -1,8 +0,0 @@
-# static int http\Object::getDefaultErrorHandling()
-
-Retreive the http extension's global default error handling.
-
-## Returns:
-
-* int, the error handling. See http\Object::EH_* constants.
-* NULL, when error handling is not set.
diff --git a/http/Object/getErrorHandling.md b/http/Object/getErrorHandling.md
deleted file mode 100644 (file)
index c44dcfa..0000000
+++ /dev/null
@@ -1,12 +0,0 @@
-# int http\Object::getErrorHandling()
-
-Retrieve the currently set instance error handling.
-
-## Params:
-
-None.
-
-## Returns:
-
-* int, the current error handling. See http\Object::EH_* constants.
-
diff --git a/http/Object/setDefaultErrorHandling.md b/http/Object/setDefaultErrorHandling.md
deleted file mode 100644 (file)
index 950af94..0000000
+++ /dev/null
@@ -1,17 +0,0 @@
-# static void http\Object::setDefaultErrorHandling(int $eh)
-
-Set the http extension's global default error handling.
-
-## Params:
-
-* int $eh  
-  The error handling. See http\Object::EH_* constants.
-  
-## Throws:
-
-* http\Exception  
-  When http\Object::EH_THROW is in effect.
-  
-## Warnings:
-
-* E_RUNTIME, if $eh is an unknown error handling.
diff --git a/http/Object/setErrorHandling.md b/http/Object/setErrorHandling.md
deleted file mode 100644 (file)
index 09763ef..0000000
+++ /dev/null
@@ -1,21 +0,0 @@
-# http\Object http\Object::setErrorHandling(int $eh)
-
-Set instance error handling.
-
-## Params:
-
-* int $eh  
-  The error handling this instance should enforce.
-
-## Returns:
-
-* http/Object, self.
-
-## Throws:
-
-* http\Exception  
-  When http\Object::EH_THROW is in effect.
-
-## Warnings:
-
-* E_RUNTIME, if $eh is an unknown error handling code.
diff --git a/http/Object/triggerError.md b/http/Object/triggerError.md
deleted file mode 100644 (file)
index 72ba2f2..0000000
+++ /dev/null
@@ -1,13 +0,0 @@
-# void http\Object::triggerError(int $eh, int $code, string $error)
-
-Trigger an error with the specified error handling.
-
-## Params:
-
-* int $eh  
-  The error handling to use. See http\Object::EH_* constants.
-* int $code  
-  The error code.
-* string $error  
-  The error message.
-
index b45d0c64840f8bb55c640fa0a191ab2519fa5246..d8bf3b77b691e3a690cb18e937b70a78e297d2cf 100644 (file)
@@ -1,4 +1,4 @@
-# class http\Params extends http\Object implements ArrayAccess
+# class http\Params implements ArrayAccess
 
 Parse, interpret and compose HTTP (header) parameters.
 
 
 Parse, interpret and compose HTTP (header) parameters.
 
@@ -11,7 +11,7 @@ Parse, interpret and compose HTTP (header) parameters.
 * DEF_VAL_SEP  
   The default value separator ("=").
 * COOKIE_PARAM_SEP  
 * DEF_VAL_SEP  
   The default value separator ("=").
 * COOKIE_PARAM_SEP  
-  TBD
+  Empty param separator to parse cookies.
 * PARSE_RAW  
   Do not interpret the parsed parameters.
 * PARSE_DEFAULT  
 * PARSE_RAW  
   Do not interpret the parsed parameters.
 * PARSE_DEFAULT  
index ff2a296c3dbb845fc47e80efb7823c520eb90c9a..b1110c8b8f017e8d468dc81803cca1b344bd2302 100644 (file)
@@ -17,5 +17,6 @@ Instantiate a new HTTP (header) parameter set.
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception
+* http\Exception\InvalidArgumentException
+* http\Exception\RuntimeException
 
 
index 9541a35fd1857ce89ed7c486050a658a0cfeb6ab..9f4f0d198e02d0eb78217f1b287ceed1dc40e447 100644 (file)
@@ -1,4 +1,4 @@
-# class http\QueryString extends http\Object implements Serializable, ArrayAccess, IteratorAggregate
+# class http\QueryString implements Serializable, ArrayAccess, IteratorAggregate
 
 The http\QueryString class provides versatile facilities to retrieve, use and manipulate query strings and form data.
 
 
 The http\QueryString class provides versatile facilities to retrieve, use and manipulate query strings and form data.
 
index 8a1140b7844f2af81e9e729e7dc97b7d5529e8ee..90b42878ffbef6280a3df5cccdfb32a09de8c29a 100644 (file)
@@ -9,7 +9,7 @@ Create an independent querystring instance.
   
 ## Throws:
 
   
 ## Throws:
 
-* http\Exception
+* http\Exception\BadQueryStringException
 
 ## Example:
 
 
 ## Example:
 
index 1db996ae10eb89bf640e58154e6b0c9e4aea1ef2..24529d0573d66839987b155c1ff3f203bc629073 100644 (file)
@@ -12,4 +12,4 @@ None.
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception
+* http\Exception\UnexpectedValueException
index ab37865f720a24e2e8cdc97263ac880e206324c6..ac140a1f381db3751051c18f7eb2bf2094f8d74f 100644 (file)
@@ -12,4 +12,5 @@ None.
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception
+* http\Exception\InvalidArgumentException
+* InvalidArgumentException
index a1ba5b83016e63791c50ca878a540ac99c36ba6c..83068e94109446e71193d13415e11ae5644306fb 100644 (file)
@@ -3,14 +3,17 @@
 Set additional $params to a clone of this instance. 
 See http\QueryString::set().
 
 Set additional $params to a clone of this instance. 
 See http\QueryString::set().
 
-> **Note:** This method returns a clone (copy) of this instance
+> **Note:** This method returns a clone (copy) of this instance.
 
 ## Params:
 
 * mixed $params = NULL  
   Additional params as object, array or string to parse.
 
 
 ## Params:
 
 * mixed $params = NULL  
   Additional params as object, array or string to parse.
 
-
 ## Returns:
 
 * http\QueryString, clone.
 ## Returns:
 
 * http\QueryString, clone.
+
+## Throws:
+
+* http\Exception\BadQueryStringException
index baeb2f63c24db10cc1de5a6ceb0e7f47143be12b..4087b40dc92e31632907818aa3ab84cb3ee8b12a 100644 (file)
@@ -17,4 +17,5 @@ Translate character encodings of the querystring with ext/iconv.
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception
+* http\Exception\InvalidArgumentException
+* http\Exception\BadConversionException
index 8069c342da1c190e5b2c14d24236ebcf14d9b9d2..b9ef47f11586b36c53bcf9bfc7f048834a39efd9 100644 (file)
@@ -1,4 +1,4 @@
-# class http\Url extends http\Object
+# class http\Url
 
 The http\Url class provides versatile means to parse, construct and manipulate URLs.
 
 
 The http\Url class provides versatile means to parse, construct and manipulate URLs.
 
index 6d6730639644760f45600d9a02733f153065ffa8..bf6629660c44d20626cb62c58b47f2711008edec 100644 (file)
@@ -13,5 +13,6 @@ Create an instance of an http\URL.
 
 ## Throws:
 
 
 ## Throws:
 
-* http\Exception
+* http\Exception\InvalidArgumentException
+* http\Exception\BadUrlException
 
 
index 52b1f536c812f19e0855b2356a12f84a8ef71562..9fab9a879ead9d1cef2cffdeed03f1d2b994a8ba 100644 (file)
@@ -14,3 +14,9 @@ Clone this URL and apply $parts to the cloned URL.
 ## Returns:
 
 * http\Url, clone.
 ## Returns:
 
 * http\Url, clone.
+
+## Throws:
+
+
+* http\Exception\InvalidArgumentException
+* http\Exception\BadUrlException