#53: * Upgrade LibUV to version 1.45 due to a timer bug that causes the application to hang

Author: EdmondDantes

.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

.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

CHANGELOG.md

@@ -34,6 +34,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
     - 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)

config.m4

@@ -26,14 +26,14 @@ if test "$PHP_ASYNC" = "yes"; then
     AC_MSG_CHECKING(for libuv)
 
     if test -x "$PKG_CONFIG" && $PKG_CONFIG --exists libuv; then
-      dnl Require libuv >= 1.44.0 for UV_RUN_ONCE busy loop fix
-      if $PKG_CONFIG libuv --atleast-version 1.44.0; then
+      dnl Require libuv >= 1.45.0 for UV_RUN_ONCE busy loop fix
+      if $PKG_CONFIG libuv --atleast-version 1.45.0; then
         LIBUV_INCLINE=`$PKG_CONFIG libuv --cflags`
         LIBUV_LIBLINE=`$PKG_CONFIG libuv --libs`
         LIBUV_VERSION=`$PKG_CONFIG libuv --modversion`
         AC_MSG_RESULT(from pkgconfig: found version $LIBUV_VERSION)
       else
-        AC_MSG_ERROR(system libuv must be upgraded to version >= 1.44.0 (fixes UV_RUN_ONCE busy loop issue))
+        AC_MSG_ERROR(system libuv must be upgraded to version >= 1.45.0 (fixes UV_RUN_ONCE busy loop issue))
       fi
       PHP_EVAL_LIBLINE($LIBUV_LIBLINE, UV_SHARED_LIBADD)
       PHP_EVAL_INCLINE($LIBUV_INCLINE)

config.w32

@@ -23,7 +23,7 @@ if (PHP_ASYNC == "yes") {
     if (CHECK_HEADER_ADD_INCLUDE("libuv/uv.h", "CFLAGS_UV", PHP_PHP_BUILD + "\\include")
         && CHECK_LIB("libuv.lib", "libuv")) {
 
-        // Note: libuv >= 1.44.0 is required for UV_RUN_ONCE busy loop fix
+        // Note: libuv >= 1.45.0 is required for UV_RUN_ONCE busy loop fix
         // For Windows builds, manually verify libuv version meets requirements
 
         ADD_FLAG("LIBS", "libuv.lib Dbghelp.lib Userenv.lib");
@@ -32,6 +32,6 @@ if (PHP_ASYNC == "yes") {
               "'.\nTo compile PHP TRUE ASYNC with LibUV:\n" +
               "1. Copy files from 'libuv\\include' to '" + PHP_PHP_BUILD + "\\include\\libuv\\'\n" +
               "2. Build libuv.lib and copy it to '" + PHP_PHP_BUILD + "\\lib\\'\n" +
-              "3. IMPORTANT: Use libuv >= 1.44.0 (fixes UV_RUN_ONCE busy loop issue)");
+              "3. IMPORTANT: Use libuv >= 1.45.0 (fixes UV_RUN_ONCE busy loop issue)");
     }
 }