PHP-163 - Disable hostname resolution if not supported

* Emit a warning if hostname resolution is not supported
* Updated documentation

Author: mpenick

ext/src/Cluster/Builder.c

@@ -29,6 +29,7 @@ zend_class_entry *php_driver_cluster_builder_ce = NULL;
 
 PHP_METHOD(ClusterBuilder, build)
 {
+  CassError rc;
   php_driver_cluster* cluster;
   php_driver_cluster_builder *self = PHP_DRIVER_GET_CLUSTER_BUILDER(getThis());
 
@@ -125,7 +126,16 @@ PHP_METHOD(ClusterBuilder, build)
   cass_cluster_set_tcp_nodelay(cluster->cluster, self->enable_tcp_nodelay);
   cass_cluster_set_tcp_keepalive(cluster->cluster, self->enable_tcp_keepalive, self->tcp_keepalive_delay);
   cass_cluster_set_use_schema(cluster->cluster, self->enable_schema);
-  ASSERT_SUCCESS(cass_cluster_set_use_hostname_resolution(cluster->cluster, self->enable_hostname_resolution));
+
+  rc = cass_cluster_set_use_hostname_resolution(cluster->cluster, self->enable_hostname_resolution);
+  if (rc == CASS_ERROR_LIB_NOT_IMPLEMENTED) {
+    if (self->enable_hostname_resolution) {
+      php_error_docref0(NULL, E_WARNING,
+                        "The underlying C/C++ driver does not implement hostname resolution it will be disabled");
+    }
+  } else {
+    ASSERT_SUCCESS(rc);
+  }
   ASSERT_SUCCESS(cass_cluster_set_use_randomized_contact_points(cluster->cluster, self->enable_randomized_contact_points));
   cass_cluster_set_connection_heartbeat_interval(cluster->cluster, self->connection_heartbeat_interval);
 

ext/src/Cluster/Builder.yaml

@@ -284,6 +284,10 @@ Cluster\Builder:
         If enabled the driver will resolve hostnames for IP addresses using
         reverse IP lookup. This is useful for authentication (Kerberos) or
         encryption SSL services that require a valid hostname for verification.
+
+        Important: It's possible that the underlying C/C++ driver does not
+        support hostname resolution. A PHP warning will be emitted if the driver
+        does not support hostname resolution.
       params:
         enabled:
           comment: whether the driver uses hostname resolution.