flush

[mdref/mdref-http] / http.md

diff --git a/http.md b/http.md
index 6175e26c14ad76f980ed602ba08a95527161d260..bf651e2003b9de25efad5113eab990764002e2d1 100644 (file)
--- a/http.md
+++ b/http.md
@@ -1,5 +1,20 @@
-# namespace http
+# pecl/http v2
 
-This is pecl_http-v2.
+> **Note:** This documentation is work-in-progress.
+
+## About:
+
+Extended HTTP support. Again. Keep in mind that it's got the major version 2, because it's incompatible with pecl_http v1.
+
+* Introduces the http namespace.
+* Message bodies have been remodeled to use PHP temporary streams instead of in-memory buffers.
+* The utterly misunderstood HttpResponse class has been reimplemented as http\Env\Response inheriting http\Message.
+* Currently, there's only one Exception class left, http\Exception.
+* Errors triggered by the extension can be configured statically by http\Object::$defaultErrorHandling or inherited http\Object->errorHandling.
+* The request ecosystem has been modularized to support different libraries, though for the moment only libcurl is supported.
+
+## INI Directives:
+
+* http.etag.mode = "crc32b"  
+  Default hash method for dynamic response payloads to generate an ETag.
 
-This documentation is work-in-progress.