preliminary 2.3.0 docs
[mdref/mdref-http] / http / Client / getAvailableConfiguration.md
diff --git a/http/Client/getAvailableConfiguration.md b/http/Client/getAvailableConfiguration.md
new file mode 100644 (file)
index 0000000..d9d7c76
--- /dev/null
@@ -0,0 +1,52 @@
+# array http\Client::getAvailableConfiguration()
+
+Get a list of available configuration options and their default values.
+
+See f.e. the [configuration options for the Curl driver](http/Client/Curl#Configuration:).
+
+## Params:
+
+None.
+
+## Returns:
+
+* array, list of key/value pairs of available configuarion options and their default values.
+
+## Throws:
+
+* http\Exception\InvalidArgumentException
+
+## Example:
+
+       <?php
+       
+       $client = new http\Client("curl");
+       var_dump($client->getAvailableConfiguration());
+       
+       ?>
+
+Yields:
+
+       array(10) {
+         ["maxconnects"]=>
+         int(-1)
+         ["max_host_connections"]=>
+         int(0)
+         ["max_pipeline_length"]=>
+         int(5)
+         ["max_total_connections"]=>
+         int(0)
+         ["pipelining"]=>
+         bool(false)
+         ["chunk_length_penalty_size"]=>
+         int(0)
+         ["content_length_penalty_size"]=>
+         int(0)
+         ["pipelining_server_bl"]=>
+         NULL
+         ["pipelining_site_bl"]=>
+         NULL
+         ["use_eventloop"]=>
+         bool(false)
+       }
+