rfc:stack-frame-class
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
rfc:stack-frame-class [2020/07/07 20:20] – brzuchal | rfc:stack-frame-class [2020/07/21 11:50] – voting opened brzuchal | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== PHP RFC: StackFrame class ====== | ====== PHP RFC: StackFrame class ====== | ||
- | * Version: | + | * Version: |
* Date: 2020-07-07 | * Date: 2020-07-07 | ||
- | * Author: Michał Brzuchalski, | + | * Author: Michał |
- | * Status: | + | * Status: |
* Target Version: PHP 8.0 | * Target Version: PHP 8.0 | ||
* First Published at: http:// | * First Published at: http:// | ||
Line 12: | Line 12: | ||
===== Proposal ===== | ===== Proposal ===== | ||
- | Introduce new '' | + | Introduce new '' |
- | array of '' | + | |
- | '' | + | There are two places where this could be a replacement for retrieving trace in array of arrays way and these are '' |
+ | |||
+ | ==== StackFrame class ==== | ||
+ | |||
+ | '' | ||
+ | |||
+ | There are additional properties and methods which expose additional information: | ||
+ | |||
+ | * property '' | ||
+ | * property '' | ||
<code php> | <code php> | ||
final class StackFrame implements ArrayAccess | final class StackFrame implements ArrayAccess | ||
{ | { | ||
- | public | + | public |
| | ||
- | public | + | public |
| | ||
- | public | + | public ?string $function; |
| | ||
- | public | + | public ?string $class; |
| | ||
- | public | + | public ?object $object; |
- | + | ||
- | public readonly array $args; | + | |
- | + | ||
- | public static function getTrace(): array {} | + | |
- | public | + | public |
- | public | + | public |
- | public function | + | public |
+ | |||
+ | public array $args = []; | ||
+ | |||
+ | public static | ||
+ | } | ||
+ | </ | ||
- | public function getClass(): ?string {} | + | ==== Example ==== |
+ | An example below shows exactly the same portion of information as if it would call '' | ||
- | public | + | <code php> |
- | + | function | |
- | | + | |
- | + | ||
- | public function getArgs(): array {} | + | |
} | } | ||
+ | $frame = frames()[0]; | ||
+ | |||
+ | var_dump([ | ||
+ | ' | ||
+ | ' | ||
+ | ' | ||
+ | ' | ||
+ | ' | ||
+ | ' | ||
+ | ' | ||
+ | ]); | ||
</ | </ | ||
+ | |||
+ | ==== Performance ==== | ||
+ | On a test script with 1M recursions to produce huge result results were as above: | ||
+ | |||
+ | - '' | ||
+ | - '' | ||
===== Backward Incompatible Changes ===== | ===== Backward Incompatible Changes ===== | ||
Line 68: | Line 94: | ||
==== New Constants ==== | ==== New Constants ==== | ||
- | Not yet. | + | None. |
Line 75: | Line 101: | ||
The vote will be a simple Yes/No for '' | The vote will be a simple Yes/No for '' | ||
+ | |||
+ | ===== Vote ===== | ||
+ | Voting opened 2020-07-21 and closes 2020-08-04. | ||
+ | |||
+ | <doodle title=" | ||
+ | * Yes | ||
+ | * No | ||
+ | </ | ||
+ | |||
+ | '''' | ||
+ | |||
+ | <doodle title=" | ||
+ | * Yes | ||
+ | * No | ||
+ | </ | ||
===== Implementation ===== | ===== Implementation ===== | ||
- | ... | + | * [[https:// |
rfc/stack-frame-class.txt · Last modified: 2020/08/04 08:00 by brzuchal