Merge pull request #60 from true-async/53-optimize-descriptor-registration-in-event-loop

53 optimize descriptor registration in event loop

Author: EdmondDantes

.github/workflows/build-alpine.yml

@@ -224,7 +224,6 @@ jobs:
         run: |
           /usr/local/bin/php ../../run-tests.php \
             ${{ matrix.asan && '--asan' || '' }} \
-            -d zend_extension=opcache.so \
             -d opcache.enable_cli=1 \
             -d opcache.jit_buffer_size=64M \
             -d opcache.jit=tracing \
@@ -241,7 +240,6 @@ jobs:
         run: |
           /usr/local/bin/php ../../run-tests.php \
             ${{ matrix.asan && '--asan' || '' }} \
-            -d zend_extension=opcache.so \
             -d opcache.enable_cli=1 \
             -P -q -x -j$(nproc) \
             -g FAIL,BORK,LEAK,XLEAK \

.github/workflows/build-freebsd.yml

@@ -167,7 +167,6 @@ jobs:
               --show-diff \
               --show-slow 4000 \
               --set-timeout 120 \
-              -d zend_extension=opcache.so \
               -d opcache.enable_cli=1 \
               ext/async/tests
 
@@ -180,7 +179,6 @@ jobs:
               --show-diff \
               --show-slow 4000 \
               --set-timeout 120 \
-              -d zend_extension=opcache.so \
               -d opcache.enable_cli=1 \
               -d opcache.jit_buffer_size=64M \
               -d opcache.jit=tracing \
@@ -195,7 +193,6 @@ jobs:
               --show-diff \
               --show-slow 4000 \
               --set-timeout 120 \
-              -d zend_extension=opcache.so \
               -d opcache.enable_cli=1 \
               -d opcache.jit_buffer_size=64M \
               -d opcache.jit=function \

.github/workflows/build-linux.yml

@@ -98,7 +98,7 @@ jobs:
             libxslt1-dev \
             libicu-dev
           
-          # Build LibUV from source (need >= 1.44.0)
+          # Build LibUV from source (need >= 1.45.0)
           sudo apt-get install -y cmake ninja-build
           
           # Download and build LibUV 1.48.0
@@ -270,7 +270,6 @@ jobs:
           
           /usr/local/bin/php ../../run-tests.php \
             $TEST_PARAMS \
-            -d zend_extension=opcache.so \
             -d opcache.enable_cli=1 \
             -P -q -j$PARALLEL_JOBS \
             -g FAIL,BORK,LEAK,XLEAK \
@@ -287,7 +286,6 @@ jobs:
         working-directory: php-src/ext/async
         run: |
           /usr/local/bin/php ../../run-tests.php \
-            -d zend_extension=opcache.so \
             -d opcache.enable_cli=1 \
             -d opcache.jit_buffer_size=64M \
             -d opcache.jit=tracing \
@@ -306,7 +304,6 @@ jobs:
         working-directory: php-src/ext/async
         run: |
           /usr/local/bin/php ../../run-tests.php \
-            -d zend_extension=opcache.so \
             -d opcache.enable_cli=1 \
             -d opcache.jit_buffer_size=64M \
             -d opcache.jit=function \

.github/workflows/build-macos.yml

@@ -159,7 +159,6 @@ jobs:
         working-directory: php-src/ext/async
         run: |
           /usr/local/bin/php ../../run-tests.php \
-            -d zend_extension=opcache.so \
             -d opcache.enable_cli=1 \
             -d opcache.jit_buffer_size=64M \
             -d opcache.jit=tracing \
@@ -175,7 +174,6 @@ jobs:
         working-directory: php-src/ext/async
         run: |
           /usr/local/bin/php ../../run-tests.php \
-            -d zend_extension=opcache.so \
             -d opcache.enable_cli=1 \
             -P -q -x -j$(sysctl -n hw.logicalcpu) \
             -g FAIL,BORK,LEAK,XLEAK \
@@ -191,7 +189,6 @@ jobs:
         working-directory: php-src/ext/async
         run: |
           /usr/local/bin/php ../../run-tests.php \
-            -d zend_extension=opcache.so \
             -d opcache.enable_cli=1 \
             -d opcache.jit_buffer_size=64M \
             -d opcache.jit=function \

.github/workflows/build.yml

@@ -70,40 +70,40 @@ jobs:
             firebird-dev \
             valgrind cmake
 
-      # Cache LibUV 1.44.0 installation to avoid rebuilding
-      - name: Cache LibUV 1.44.0
+      # Cache LibUV 1.45.0 installation to avoid rebuilding
+      - name: Cache LibUV 1.45.0
         id: cache-libuv
         uses: actions/cache@v4
         with:
           path: |
             /usr/local/lib/libuv*
             /usr/local/include/uv*
             /usr/local/lib/pkgconfig/libuv.pc
-          key: ${{ runner.os }}-libuv-1.44.0-release
+          key: ${{ runner.os }}-libuv-1.45.0-release
 
-      - name: Install LibUV >= 1.44.0
+      - name: Install LibUV >= 1.45.0
         run: |
-          # Check if we have cached LibUV 1.44.0
+          # Check if we have cached LibUV 1.45.0
           if [ "${{ steps.cache-libuv.outputs.cache-hit }}" == "true" ]; then
-            echo "Using cached LibUV 1.44.0 installation"
+            echo "Using cached LibUV 1.45.0 installation"
             sudo ldconfig
             echo "LibUV version: $(pkg-config --modversion libuv)"
           # Check if system libuv meets requirements
-          elif pkg-config --exists libuv && pkg-config --atleast-version=1.44.0 libuv; then
+          elif pkg-config --exists libuv && pkg-config --atleast-version=1.45.0 libuv; then
             echo "System libuv version: $(pkg-config --modversion libuv)"
             sudo apt-get install -y libuv1-dev
           else
-            echo "Installing LibUV 1.44.0 from source"
-            wget https://github.com/libuv/libuv/archive/v1.44.0.tar.gz
-            tar -xzf v1.44.0.tar.gz
-            cd libuv-1.44.0
+            echo "Installing LibUV 1.45.0 from source"
+            wget https://github.com/libuv/libuv/archive/v1.45.0.tar.gz
+            tar -xzf v1.45.0.tar.gz
+            cd libuv-1.45.0
             mkdir build && cd build
             cmake .. -DCMAKE_BUILD_TYPE=Release
             make -j$(nproc)
             sudo make install
             sudo ldconfig
             cd ../..
-            echo "LibUV 1.44.0 compiled and installed"
+            echo "LibUV 1.45.0 compiled and installed"
           fi
 
       - name: Configure PHP
@@ -113,7 +113,6 @@ jobs:
           ./configure \
             --enable-zts \
             --enable-fpm \
-            --enable-opcache \
             --with-pdo-mysql=mysqlnd \
             --with-mysqli=mysqlnd \
             --with-pgsql \
@@ -178,7 +177,6 @@ jobs:
         run: |
           /usr/local/bin/php -v
           /usr/local/bin/php ../../run-tests.php \
-            -d zend_extension=opcache.so \
             -d opcache.enable_cli=1 \
             -d opcache.jit_buffer_size=64M \
             -d opcache.jit=tracing \

CHANGELOG.md

@@ -5,7 +5,36 @@ All notable changes to the Async extension for PHP will be documented in this fi
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.4.0] - 2025-09-31
+
+### Added
+- **UDP socket stream support for TrueAsync**
+- **SSL support for socket stream**
+- **Poll Proxy**: New `zend_async_poll_proxy_t` structure for optimized file descriptor management
+    - Efficient caching of event handlers to reduce EventLoop creation overhead
+    - Poll proxy event aggregation and improved lifecycle management
+
+### Fixed
+- **Fixing `ref_count` logic for the `zend_async_event_callback_t` structure**:
+    - The add/dispose methods correctly increment the counter
+    - Memory leaks fixed
+- Fixed await iterator logic for `awaitXXX` functions
+
+### Changed
+- **Memory Optimization**: Enhanced memory allocation for async structures
+    - Optimized waker trigger structures with improved memory layout
+    - Enhanced memory management for poll proxy events
+    - Better resource cleanup and lifecycle management
+- **Event Loop Performance**: Major scheduler optimizations
+    - **Automatic Event Cleanup**: Added automatic waker event cleanup when coroutines resume (see `ZEND_ASYNC_WAKER_CLEAN_EVENTS`)
+    - Separate queue implementation for resumed coroutines to improve stability
+    - Reduced unnecessary LibUV calls in scheduler tick processing
+- **Socket Performance**:
+    - Event handler caching for sockets to avoid constant EventLoop recreation
+    - Optimized `network_async_accept_incoming` to try `accept()` before waiting
+    - Enhanced stream_select functionality with event-driven architecture
+    - Improved blocking operation handling with boolean return values
+- Upgrade `LibUV` to version `1.45` due to a timer bug that causes the application to hang
 
 ## [0.3.0] - 2025-07-16
 

README.md

@@ -47,9 +47,9 @@ docker run --rm true-async-php php -m | grep true_async
 ### Requirements
 
 - **PHP 8.5.0+**
-- **LibUV ≥ 1.44.0** (required) - Fixes critical `UV_RUN_ONCE` busy loop issue that could cause high CPU usage
+- **LibUV ≥ 1.45.0** (required) - Fixes critical `UV_RUN_ONCE` busy loop issue that could cause high CPU usage
 
-### Why LibUV 1.44.0+ is Required
+### Why LibUV 1.45.0+ is Required
 
 Prior to libuv 1.44, there was a critical issue in `uv__io_poll()`/`uv__run_pending` logic that could cause the event loop to "stick" after the first callback when running in `UV_RUN_ONCE` mode, especially when new ready events appeared within callbacks. This resulted in:
 
@@ -95,17 +95,17 @@ The fix in libuv 1.44 ensures that `UV_RUN_ONCE` properly returns after processi
 
 4. **Install LibUV:**:
    
-**IMPORTANT:** LibUV version 1.44.0 or later is required.
+**IMPORTANT:** LibUV version 1.45.0 or later is required.
 
 For Debian/Ubuntu:
 ```bash
-# Check if system libuv meets requirements (≥1.44.0)
+# Check if system libuv meets requirements (≥1.45.0)
 pkg-config --modversion libuv
 
 # If version is too old, install from source:
-wget https://github.com/libuv/libuv/archive/v1.44.0.tar.gz
-tar -xzf v1.44.0.tar.gz
-cd libuv-1.44.0
+wget https://github.com/libuv/libuv/archive/v1.45.0.tar.gz
+tar -xzf v1.45.0.tar.gz
+cd libuv-1.45.0
 mkdir build && cd build
 cmake .. -DCMAKE_BUILD_TYPE=Release
 make -j$(nproc)

async.c

@@ -896,6 +896,9 @@ static PHP_GINIT_FUNCTION(async)
 	/* Maximum number of coroutines in the concurrent iterator */
 	async_globals->default_concurrency = 32;
 
+	/* Initialize reactor execution optimization */
+	async_globals->last_reactor_tick = 0;
+
 #ifdef PHP_WIN32
 	async_globals->watcherThread = NULL;
 	async_globals->ioCompletionPort = NULL;
@@ -907,7 +910,8 @@ static PHP_GINIT_FUNCTION(async)
 }
 
 /* {{{ PHP_GSHUTDOWN_FUNCTION */
-static PHP_GSHUTDOWN_FUNCTION(async){
+static PHP_GSHUTDOWN_FUNCTION(async)
+{
 #ifdef PHP_WIN32
 #endif
 } /* }}} */
@@ -959,6 +963,7 @@ PHP_RINIT_FUNCTION(async) /* {{{ */
 	ZEND_ASYNC_INITIALIZE;
 	circular_buffer_ctor(&ASYNC_G(microtasks), 64, sizeof(zend_async_microtask_t *), &zend_std_allocator);
 	circular_buffer_ctor(&ASYNC_G(coroutine_queue), 128, sizeof(zend_coroutine_t *), &zend_std_allocator);
+	circular_buffer_ctor(&ASYNC_G(resumed_coroutines), 64, sizeof(zend_coroutine_t *), &zend_std_allocator);
 	zend_hash_init(&ASYNC_G(coroutines), 128, NULL, NULL, 0);
 
 	ASYNC_G(reactor_started) = false;

async_API.c

@@ -208,6 +208,7 @@ static void engine_shutdown(void)
 
 	circular_buffer_dtor(&ASYNC_G(microtasks));
 	circular_buffer_dtor(&ASYNC_G(coroutine_queue));
+	circular_buffer_dtor(&ASYNC_G(resumed_coroutines));
 	zend_hash_destroy(&ASYNC_G(coroutines));
 
 	if (ASYNC_G(root_context) != NULL) {
@@ -609,7 +610,8 @@ static void await_iterator_dispose(async_await_iterator_t *iterator, async_itera
 		iterator->zend_iterator = NULL;
 
 		// When the iterator has finished, it’s now possible to specify the exact number of elements since it’s known.
-		iterator->await_context->total = iterator->await_context->futures_count;
+		iterator->await_context->total =
+				iterator->await_context->futures_count + iterator->await_context->resolved_count;
 
 		// Scenario: the iterator has already finished, and there’s nothing left to await.
 		// In that case, the coroutine needs to be terminated.