rfc:fiber

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Next revisionBoth sides next revision
rfc:fiber [2018/04/13 00:06] – lvhtrfc:fiber [2018/04/17 23:00] – lvht
Line 2: Line 2:
   * Version: 0.1   * Version: 0.1
   * Date: 2017-09-13   * Date: 2017-09-13
-  * Author: Haitao Lv, i@lvht.net+  * Author: Haitao Lv<i@lvht.net>, Dmitry Stogov<dmitry@zend.com>
   * Status: Under Discussion   * Status: Under Discussion
   * First Published at: http://wiki.php.net/rfc/fiber   * First Published at: http://wiki.php.net/rfc/fiber
Line 16: Line 16:
 ===== Proposal ===== ===== Proposal =====
 ==== Why not make it as a Extension? ==== ==== Why not make it as a Extension? ====
 +Fiber is a major language feature, that allows significant benefits for asynchronous frameworks. Providing it as an optional extension, just doesn't make sense.
 +
 ==== Implementation ==== ==== Implementation ====
  
 +=== Proposed API ===
 <code php> <code php>
 final class Fiber { final class Fiber {
Line 25: Line 28:
   public const STATUS_DEAD      = 4;   public const STATUS_DEAD      = 4;
  
 +  /**
 +   * @param callable $callable any php callable to be paused
 +   * @param int $stack_size fiber stack init size
 +   */
   public function __construct(callable $callable = null, int stack_size = null) {}   public function __construct(callable $callable = null, int stack_size = null) {}
  
 +  /**
 +   * pause the current fiber and ~return~ the $arg1
 +   * as the Fiber::resume's return value.
 +   */
   public static function yield($arg1) {}   public static function yield($arg1) {}
 +  
 +  /**
 +   * Start or resume a fiber.
 +   * 
 +   * If the fiber is not started, call resume will init
 +   * the $callable with all args.
 +   *
 +   * If the fiber is paused, call resume will send the first arg
 +   * as the last Fiber::yield's return value.
 +   */
   public function resume($arg1...) {}   public function resume($arg1...) {}
 +  
 +  /**
 +   * Throw an exception into the fiber.
 +   * 
 +   * You code can use try/catch to process error in the
 +   * top level function call. Some framework make heavy
 +   * usage of this feature.
 +   */
   public function throw(Throwable $e) {}   public function throw(Throwable $e) {}
- 
-  /** @throws \UnexpectedValueException */ 
-  public function __wakeup(): void {} 
- 
-  /** @throws \Error */ 
-  private function __clone() {} 
 } }
 </code> </code>
  
 +=== Usage Demo ===
 +Here is the usage demo,
 <code php> <code php>
 function sub1() function sub1()
Line 55: Line 80:
 echo $fiber->resume("hello "); // echo "hello world" echo $fiber->resume("hello "); // echo "hello world"
 </code> </code>
 +
 +=== Implementation Detail ===
  
 ===== Backward Incompatible Changes ===== ===== Backward Incompatible Changes =====
Line 116: Line 143:
  
 ===== Proposed Voting Choices ===== ===== Proposed Voting Choices =====
-Simple 50%+1 majority vote.+2/3+1 voting majority
  
 ===== Patches and Tests ===== ===== Patches and Tests =====
Line 138: Line 165:
  
 ===== Rejected Features ===== ===== Rejected Features =====
-  * await/async keyword 
-  * dedicated Fiber::init API 
rfc/fiber.txt · Last modified: 2018/06/12 07:40 by krakjoe

Page Tools