Implement Coroutine::getTrace() method with parameters

Co-authored-by: EdmondDantes <1571649+EdmondDantes@users.noreply.github.com>

Author: Copilot

coroutine.c

@@ -32,6 +32,7 @@
 #include "zend_exceptions.h"
 #include "zend_generators.h"
 #include "zend_ini.h"
+#include "zend_builtin_functions.h"
 
 #define METHOD(name) PHP_METHOD(Async_Coroutine, name)
 #define THIS_COROUTINE ((async_coroutine_t *) ZEND_ASYNC_OBJECT_TO_EVENT(Z_OBJ_P(ZEND_THIS)))
@@ -1333,9 +1334,40 @@ METHOD(getException)
 
 METHOD(getTrace)
 {
-	// TODO: Implement debug trace collection
-	// This would require fiber stack trace functionality
-	array_init(return_value);
+	zend_long options = DEBUG_BACKTRACE_PROVIDE_OBJECT;
+	zend_long limit = 0;
+
+	ZEND_PARSE_PARAMETERS_START(0, 2)
+	Z_PARAM_OPTIONAL
+	Z_PARAM_LONG(options)
+	Z_PARAM_LONG(limit)
+	ZEND_PARSE_PARAMETERS_END();
+
+	async_coroutine_t *coroutine = THIS_COROUTINE;
+	async_fiber_context_t *fiber_context = coroutine->fiber_context;
+
+	// Return empty array if coroutine is not suspended or has no fiber context
+	if (fiber_context == NULL ||
+		fiber_context->context.status != ZEND_FIBER_STATUS_SUSPENDED ||
+		!fiber_context->execute_data) {
+		array_init(return_value);
+		return;
+	}
+
+	// Switch to the coroutine's VM stack to generate the backtrace
+	zend_vm_stack orig_vm_stack = EG(vm_stack);
+	zend_execute_data *orig_execute_data = EG(current_execute_data);
+
+	EG(vm_stack) = fiber_context->vm_stack;
+	EG(current_execute_data) = fiber_context->execute_data;
+
+	// Generate the backtrace using Zend's built-in function
+	// skip_last = 0 (don't skip any frames)
+	zend_fetch_debug_backtrace(return_value, 0, (int)options, (int)limit);
+
+	// Restore original VM stack and execute data
+	EG(vm_stack) = orig_vm_stack;
+	EG(current_execute_data) = orig_execute_data;
 }
 
 // Location Methods

coroutine.stub.php

@@ -42,8 +42,13 @@ public function getException(): mixed {}
 
     /**
      * Returns the Coroutine debug trace.
+     * If the coroutine is in the suspended state, returns a backtrace array.
+     * Otherwise, returns an empty array.
+     *
+     * @param int $options Options for the backtrace (DEBUG_BACKTRACE_PROVIDE_OBJECT, DEBUG_BACKTRACE_IGNORE_ARGS)
+     * @param int $limit Maximum number of stack frames to return (0 for no limit)
      */
-    public function getTrace(): array {}
+    public function getTrace(int $options = DEBUG_BACKTRACE_PROVIDE_OBJECT, int $limit = 0): array {}
 
     /**
      * Return spawn file and line.

coroutine_arginfo.h

@@ -1,5 +1,5 @@
 /* This is a generated file, edit the .stub.php file instead.
- * Stub hash: 866a851c4d87feafd6585532d622426dc453710f */
+ * Stub hash: 35d332163bf92ed3cad35c83017aaa67d650aa9d */
 
 ZEND_BEGIN_ARG_WITH_RETURN_TYPE_INFO_EX(arginfo_class_Async_Coroutine_getId, 0, 0, IS_LONG, 0)
 ZEND_END_ARG_INFO()
@@ -16,6 +16,8 @@ ZEND_END_ARG_INFO()
 #define arginfo_class_Async_Coroutine_getException arginfo_class_Async_Coroutine_getResult
 
 ZEND_BEGIN_ARG_WITH_RETURN_TYPE_INFO_EX(arginfo_class_Async_Coroutine_getTrace, 0, 0, IS_ARRAY, 0)
+	ZEND_ARG_TYPE_INFO_WITH_DEFAULT_VALUE(0, options, IS_LONG, 0, "DEBUG_BACKTRACE_PROVIDE_OBJECT")
+	ZEND_ARG_TYPE_INFO_WITH_DEFAULT_VALUE(0, limit, IS_LONG, 0, "0")
 ZEND_END_ARG_INFO()
 
 #define arginfo_class_Async_Coroutine_getSpawnFileAndLine arginfo_class_Async_Coroutine_getTrace