PHPC-1622: Use get_properties_for handler in ObjectId (prototype)

Replace the get_debug_info and get_properties handlers with a single
get_properties_for handler that dispatches by purpose:

- ZEND_PROP_PURPOSE_DEBUG, ARRAY_CAST, GET_OBJECT_VARS, VAR_EXPORT:
  return a fresh temporary HashTable (no caching)
- ZEND_PROP_PURPOSE_SERIALIZE, JSON: return NULL, deferring to the
  class's __serialize/__unserialize and JsonSerializable implementations

The get_properties handler is retained since foreach on non-Traversable
objects calls it directly, bypassing get_properties_for on all PHP
versions.

ZEND_PROP_PURPOSE_GET_OBJECT_VARS (added in PHP 8.4 as part of the
Property Hooks RFC) is guarded with #if PHP_VERSION_ID >= 80400; on
PHP 8.1-8.3 get_object_vars() reaches get_properties directly.

Add tests for the two previously untested purposes:
- bson-objectid-array_cast-001.phpt  (ZEND_PROP_PURPOSE_ARRAY_CAST)
- bson-objectid-var_export-001.phpt  (ZEND_PROP_PURPOSE_VAR_EXPORT)

Author: GromNaN

src/BSON/ObjectId.c

@@ -252,10 +252,19 @@ static int phongo_objectid_compare_objects(zval* o1, zval* o2)
 	return strcmp(intern1->oid, intern2->oid);
 }
 
-static HashTable* phongo_objectid_get_debug_info(zend_object* object, int* is_temp)
+static HashTable* phongo_objectid_get_properties_for(zend_object* object, zend_prop_purpose purpose)
 {
-	*is_temp = 1;
-	return phongo_objectid_get_properties_hash(object, true);
+	switch (purpose) {
+		case ZEND_PROP_PURPOSE_DEBUG:
+		case ZEND_PROP_PURPOSE_ARRAY_CAST:
+		#if PHP_VERSION_ID >= 80400
+		case ZEND_PROP_PURPOSE_GET_OBJECT_VARS:
+		#endif
+		case ZEND_PROP_PURPOSE_VAR_EXPORT:
+			return phongo_objectid_get_properties_hash(object, true);
+		default:
+			return NULL;
+	}
 }
 
 static HashTable* phongo_objectid_get_properties(zend_object* object)
@@ -271,8 +280,8 @@ void phongo_objectid_init_ce(INIT_FUNC_ARGS)
 	memcpy(&phongo_handler_objectid, phongo_get_std_object_handlers(), sizeof(zend_object_handlers));
 	phongo_handler_objectid.compare        = phongo_objectid_compare_objects;
 	phongo_handler_objectid.clone_obj      = phongo_objectid_clone_object;
-	phongo_handler_objectid.get_debug_info = phongo_objectid_get_debug_info;
-	phongo_handler_objectid.get_properties = phongo_objectid_get_properties;
+	phongo_handler_objectid.get_properties_for = phongo_objectid_get_properties_for;
+	phongo_handler_objectid.get_properties     = phongo_objectid_get_properties;
 	phongo_handler_objectid.free_obj       = phongo_objectid_free_object;
 	phongo_handler_objectid.offset         = XtOffsetOf(phongo_objectid_t, std);
 }

tests/bson/bson-objectid-array_cast-001.phpt

@@ -0,0 +1,18 @@
+--TEST--
+MongoDB\BSON\ObjectId array cast (ZEND_PROP_PURPOSE_ARRAY_CAST)
+--FILE--
+<?php
+
+$oid = new MongoDB\BSON\ObjectId('53e2a1c40640fd72175d4603');
+
+var_dump((array) $oid);
+
+?>
+===DONE===
+<?php exit(0); ?>
+--EXPECT--
+array(1) {
+  ["oid"]=>
+  string(24) "53e2a1c40640fd72175d4603"
+}
+===DONE===

tests/bson/bson-objectid-var_export-001.phpt

@@ -0,0 +1,18 @@
+--TEST--
+MongoDB\BSON\ObjectId var_export() (ZEND_PROP_PURPOSE_VAR_EXPORT)
+--FILE--
+<?php
+
+$oid = new MongoDB\BSON\ObjectId('53e2a1c40640fd72175d4603');
+
+var_export($oid);
+echo "\n";
+
+?>
+===DONE===
+<?php exit(0); ?>
+--EXPECTF--
+%r\\?%rMongoDB\BSON\ObjectId::__set_state(array(
+   'oid' => '53e2a1c40640fd72175d4603',
+))
+===DONE===