PHPC-2443: Deprecate passing string values to UTCDateTime constructor

Author: alcaeus

src/BSON/UTCDateTime.c

@@ -204,6 +204,8 @@ static PHP_METHOD(MongoDB_BSON_UTCDateTime, __construct)
 			return;
 
 		case IS_STRING:
+			php_error_docref(NULL, E_DEPRECATED, "Creating a %s instance with a string is deprecated and be removed in ext-mongodb 2.0", ZSTR_VAL(php_phongo_utcdatetime_ce->name));
+
 			php_phongo_utcdatetime_init_from_string(intern, Z_STRVAL_P(milliseconds), Z_STRLEN_P(milliseconds));
 			return;
 	}

tests/bson/bson-utcdatetime-008.phpt

@@ -0,0 +1,21 @@
+--TEST--
+MongoDB\BSON\UTCDateTime construction from 64-bit integer as string
+--FILE--
+<?php
+
+require_once __DIR__ . '/../utils/basic.inc';
+
+$utcdatetime = new MongoDB\BSON\UTCDateTime('1416445411987');
+
+var_dump($utcdatetime);
+
+?>
+===DONE===
+<?php exit(0); ?>
+--EXPECTF--
+Deprecated: MongoDB\BSON\UTCDateTime::__construct(): Creating a MongoDB\BSON\UTCDateTime instance with a string is deprecated and be removed in ext-mongodb 2.0 %S
+object(MongoDB\BSON\UTCDateTime)#%d (%d) {
+  ["milliseconds"]=>
+  string(13) "1416445411987"
+}
+===DONE===