--- /dev/null
+# pecl/raphf
+
+## About:
+
+The **"Resource and Persistent Handle Factory"** extension provides facilities to manage those in a convenient manner.
+
+> **Note:** This extension mostly only provides infrastructure for other extensions.
+
+## Installation:
+
+This extension is hosted at PECL (<http://pecl.php.net>) and can be installed eith PEAR's pecl command:
+
+ # pecl install raphf
+
+## INI Directives:
+
+* raphf.persistent_handle.limit = -1
+ The per process/thread persistent handle limit.
--- /dev/null
+# void raphf\clean_persistent_handles([string name = NULL[, string $ident]])
+
+Clean persistent handles whith id $name->$ident.
+
+## Params
+
+* Optional string $name = NULL
+ The persistent handle id.
+* Optional string $ident = NULL
+ The unique identifier within the persistent handle id.
+
+## Example:
+
+ raphf\clean_persistent_handles("http\\Client\\Curl\\Request", "php.net:80");
--- /dev/null
+# object raphf\stat_persistent_handles()
+
+Retrieve statistics about current process'/thread's persistent handles.
+
+## Params:
+
+None.
+
+## Returns:
+
+* object, stdClass instance
+
+
+## Example:
+
+ var_dump(raphf\stat_persistent_handles());
+
+Yields:
+
+ object(stdClass)#6 (3) {
+ ["http\Client\Curl"]=>
+ array(0) {
+ }
+ ["http\Client\Curl\Request"]=>
+ array(1) {
+ ["php.net:80"]=>
+ array(2) {
+ ["used"]=>
+ int(2)
+ ["free"]=>
+ int(1)
+ }
+ }
+ ["pq\Connection"]=>
+ array(0) {
+ }
+ }