Event socket bug fix and more docs (#6823)

* Add documentation to methods. Use is_resource for added type detection

* Allow connect to specify timeout in microseconds with default 30,000

* Update calling mechanism for event sockets

* Update project for new singleton event sockets

* remove unused variable

* catch errors on closing the socket

app/gateways/gateway_copy.php

@@ -143,8 +143,8 @@
 			save_gateway_xml();
 
 		//clear the cache
-			$fp = event_socket_create();
-			$hostname = trim(event_socket_request($fp, 'api switchname'));
+			$esl = event_socket::create();
+			$hostname = trim(event_socket::api('switchname'));
 			$cache = new cache;
 			$cache->delete("configuration:sofia.conf:".$hostname);