Merge pull request #45 from async-interop/single-on-error-handler

Changed onError() to setErrorHandler()

Author: WyriHaximus

src/Loop.php

@@ -144,18 +144,6 @@ public static function onSignal($signo, callable $callback, $data = null)
         return self::get()->onSignal($signo, $callback, $data);
     }
 
-    /**
-     * Execute a callback when an error occurs.
-     *
-     * @param callable(\Throwable|\Exception $exception) $callback The callback to execute.
-     *
-     * @return string An identifier that can be used to cancel, enable or disable the watcher.
-     */
-    public static function onError(callable $callback)
-    {
-        return self::get()->onError($callback);
-    }
-
     /**
      * Enable a watcher.
      *
@@ -222,6 +210,20 @@ public static function unreference($watcherId)
         self::get()->unreference($watcherId);
     }
 
+    /**
+     * Set a callback to be executed when an error occurs.
+     *
+     * Subsequent calls to this method will overwrite the previous handler.
+     *
+     * @param callable(\Throwable|\Exception $error)|null $callback The callback to execute; null will clear the current handler.
+     *
+     * @return void
+     */
+    public static function setErrorHandler(callable $callback = null)
+    {
+        self::get()->setErrorHandler($callback);
+    }
+
     /**
      * Check whether an optional feature is supported by the current event loop
      * driver.

src/LoopDriver.php

@@ -85,15 +85,6 @@ public function onWritable($stream, callable $callback, $data = null);
      */
     public function onSignal($signo, callable $callback, $data = null);
 
-    /**
-     * Execute a callback when an error occurs.
-     *
-     * @param callable(\Throwable|\Exception $exception) $callback The callback to execute.
-     *
-     * @return string An identifier that can be used to cancel, enable or disable the watcher.
-     */
-    public function onError(callable $callback);
-
     /**
      * Enable a watcher.
      *
@@ -144,6 +135,17 @@ public function reference($watcherId);
      */
     public function unreference($watcherId);
 
+    /**
+     * Set a callback to be executed when an error occurs.
+     *
+     * Subsequent calls to this method will overwrite the previous handler.
+     *
+     * @param callable(\Throwable|\Exception $error)|null $callback The callback to execute; null will clear the current handler.
+     *
+     * @return void
+     */
+    public function setErrorHandler(callable $callback = null);
+
     /**
      * Check whether an optional features is supported by this implementation
      * and system.