feat(types): expose IsPacked to help dealing with hashmaps and lists in Go code

Author: alexandre-daubois

docs/extensions.md

@@ -211,6 +211,7 @@ func process_data_packed(arr *C.zval) unsafe.Pointer {
 - `frankenphp.GoAssociativeArray(arr unsafe.Pointer, ordered bool) frankenphp.AssociativeArray` - Convert a PHP array to an ordered Go `AssociativeArray` (map with order)
 - `frankenphp.GoMap(arr unsafe.Pointer) map[string]any` - Convert a PHP array to an unordered Go map
 - `frankenphp.GoPackedArray(arr unsafe.Pointer) []any` - Convert a PHP array to a Go slice
+- `frankenphp.IsPacked(ht *C.HashTable) bool` - Check if a PHP array is packed (indexed only) or associative (key-value pairs)
 
 ### Declaring a Native PHP Class
 

types.go

@@ -401,6 +401,26 @@ func createNewArray(size uint32) *C.HashTable {
 	return (*C.HashTable)(unsafe.Pointer(arr))
 }
 
+// IsPacked determines if the given zval pointer represents a packed array (list).
+// Returns false if the zval is nil, not an array, or not packed.
+func IsPacked(zval unsafe.Pointer) bool {
+	if zval == nil {
+		return false
+	}
+
+	v, err := extractZvalValue((*C.zval)(zval), C.IS_ARRAY)
+	if err != nil {
+		return false
+	}
+
+	ht := (*C.HashTable)(v)
+	if ht == nil {
+		return false
+	}
+
+	return htIsPacked(ht)
+}
+
 // htIsPacked checks if a HashTable is a list (packed) or hashmap (not packed).
 func htIsPacked(ht *C.HashTable) bool {
 	flags := *(*C.uint32_t)(unsafe.Pointer(&ht.u[0]))