php#66: Add ZEND_ASYNC_SCHEDULER_LAUNCH() to TrueAsync public API

       Expose async_scheduler_launch() function through the TrueAsync API to allow
       extensions to explicitly initialize and start the scheduler before creating
       coroutines. This is particularly useful for extensions that need deterministic
       scheduler initialization timing.

       Changes:
       - Add zend_async_scheduler_launch_t function pointer type
       - Add ZEND_ASYNC_SCHEDULER_LAUNCH() macro for scheduler initialization
       - Register scheduler_launch_fn as first parameter in zend_async_scheduler_register()
       - Update CHANGELOG.md with API addition in version 0.5.0

Author: EdmondDantes

Zend/zend_async_API.c

@@ -151,6 +151,7 @@ zend_async_new_future_t zend_async_new_future_fn = new_future_stub;
 zend_async_new_channel_t zend_async_new_channel_fn = new_channel_stub;
 zend_async_new_future_obj_t zend_async_new_future_obj_fn = new_future_obj_stub;
 zend_async_new_channel_obj_t zend_async_new_channel_obj_fn = new_channel_obj_stub;
+zend_async_scheduler_launch_t zend_async_scheduler_launch_fn = bool_stub;
 
 /* GROUP API */
 zend_async_new_group_t zend_async_new_group_fn = new_group_stub;
@@ -261,6 +262,7 @@ ZEND_API int zend_async_get_api_version_number(void)
 }
 
 ZEND_API bool zend_async_scheduler_register(char *module, bool allow_override,
+		zend_async_scheduler_launch_t scheduler_launch_fn,
 		zend_async_new_coroutine_t new_coroutine_fn, zend_async_new_scope_t new_scope_fn,
 		zend_async_new_context_t new_context_fn, zend_async_spawn_t spawn_fn,
 		zend_async_suspend_t suspend_fn, zend_async_enqueue_coroutine_t enqueue_coroutine_fn,
@@ -293,6 +295,7 @@ ZEND_API bool zend_async_scheduler_register(char *module, bool allow_override,
 
 	scheduler_module_name = module;
 
+	zend_async_scheduler_launch_fn = scheduler_launch_fn;
 	zend_async_new_coroutine_fn = new_coroutine_fn;
 	zend_async_new_scope_fn = new_scope_fn;
 	zend_async_new_context_fn = new_context_fn;

Zend/zend_async_API.h

@@ -19,9 +19,9 @@
 #include "zend_fibers.h"
 #include "zend_globals.h"
 
-#define ZEND_ASYNC_API "TrueAsync API v0.6.0"
+#define ZEND_ASYNC_API "TrueAsync API v0.7.0"
 #define ZEND_ASYNC_API_VERSION_MAJOR 0
-#define ZEND_ASYNC_API_VERSION_MINOR 6
+#define ZEND_ASYNC_API_VERSION_MINOR 7
 #define ZEND_ASYNC_API_VERSION_PATCH 0
 
 #define ZEND_ASYNC_API_VERSION_NUMBER \
@@ -250,6 +250,8 @@ typedef zend_async_group_t *(*zend_async_new_group_t)(size_t extra_size);
 typedef zend_object *(*zend_async_new_future_obj_t)(zend_future_t *future);
 typedef zend_object *(*zend_async_new_channel_obj_t)(zend_async_channel_t *channel);
 
+typedef bool (*zend_async_scheduler_launch_t)(void);
+
 typedef bool (*zend_async_reactor_startup_t)(void);
 typedef bool (*zend_async_reactor_shutdown_t)(void);
 typedef bool (*zend_async_reactor_execute_t)(bool no_wait);
@@ -1347,6 +1349,7 @@ ZEND_API extern zend_async_new_future_t zend_async_new_future_fn;
 ZEND_API extern zend_async_new_channel_t zend_async_new_channel_fn;
 ZEND_API extern zend_async_new_future_obj_t zend_async_new_future_obj_fn;
 ZEND_API extern zend_async_new_channel_obj_t zend_async_new_channel_obj_fn;
+ZEND_API extern zend_async_scheduler_launch_t zend_async_scheduler_launch_fn;
 
 /* GROUP API */
 ZEND_API extern zend_async_new_group_t zend_async_new_group_fn;
@@ -1409,6 +1412,7 @@ ZEND_API extern zend_async_queue_task_t zend_async_queue_task_fn;
 ZEND_API extern zend_async_new_trigger_event_t zend_async_new_trigger_event_fn;
 
 ZEND_API bool zend_async_scheduler_register(char *module, bool allow_override,
+		zend_async_scheduler_launch_t scheduler_launch_fn,
 		zend_async_new_coroutine_t new_coroutine_fn, zend_async_new_scope_t new_scope_fn,
 		zend_async_new_context_t new_context_fn, zend_async_spawn_t spawn_fn,
 		zend_async_suspend_t suspend_fn, zend_async_enqueue_coroutine_t enqueue_coroutine_fn,
@@ -1596,6 +1600,8 @@ END_EXTERN_C()
 #define ZEND_ASYNC_GET_CE(type) zend_async_get_class_ce_fn(type)
 #define ZEND_ASYNC_GET_EXCEPTION_CE(type) zend_async_get_class_ce_fn(type)
 
+#define ZEND_ASYNC_SCHEDULER_LAUNCH() zend_async_scheduler_launch_fn()
+
 #define ZEND_ASYNC_REACTOR_IS_ENABLED() zend_async_reactor_is_enabled()
 #define ZEND_ASYNC_REACTOR_STARTUP() zend_async_reactor_startup_fn()
 #define ZEND_ASYNC_REACTOR_SHUTDOWN() zend_async_reactor_shutdown_fn()