PHP RFC: Fix inconsistent behavior of $this variable

• Version: 0.9
• Date: 2016-05-23
• Author: Dmitry Stogov, dmitry@zend.com
• Status: Under Discussion
• First Published at: https://wiki.php.net/rfc/this_var

Historically PHP implementation accessed special $this variable using two different methods. In some cases this might lead to significant inconsistency, when $this accessed through different methods might have different values.

class C {
  function foo() {
    var_dump($this);
  }
  function bar() {
    $a="this";
    $$a=42;
    var_dump($this); // prints int(42)
    $this->foo();    // prints object(C)#1 (0) {}
  }
}
$x = new C;
$x->bar();

This RFC proposes disabling modification of $this variable using “magic code” and make $this always behave in the same way.

The following code worked in PHP 7, but will emit compilation error in PHP 7.1

function foo($this) { // Fatal error: Cannot use $this as parameter
}

The following code worked in PHP 7, but will emit compilation error in PHP 7.1

static $this; // Fatal error: Cannot use $this as static variable

The following code worked in PHP 7, but will emit compilation error in PHP 7.1

global $this; // Fatal error: Cannot use $this as global variable

The following code worked in PHP 7, but will emit compilation error in PHP 7.1

try {
  ...
} catch (Exception $this) { // Fatal error: Cannot re-assign $this
}

The following code worked in PHP 7, but will emit compilation error in PHP 7.1

foreach ($a as $this) { // Fatal error: Cannot re-assign $this
}

It's not allowed to re-assign $this, so why it should be allowed to unset() it. The following code worked in PHP 7, but will emit compilation error in PHP 7.1

unset($this); // Fatal error: Cannot unset $this

An attempt to re-assign $this through $$ assignment will lead to throwing of Error exception.

$a = "this";
$$a = 42; // throw new Error("Cannot re-assign $this")

It's still possible to read $this value through $$.

Indirect re-assign $this through reference won't make effect in PHP 7.1

class C {
  function foo(){
    $a =& $this;
    $a = 42;
    var_dump($this); // prints object(C)#1 (0) {}, php-7.0 printed int(42)
  }
}
$x = new C;
$x->foo();

In PHP 7.0 and below $this in static magic method __call() had value NULL. However it was possible to access properties and call object methods.

class C {
  static function __call($name, $args) {
    var_dump($this); // prints object(C)#1 (0) {}, php-7.0 printed NULL
    $this->test();   // prints "ops"
  }
  funcriont test() {
    echo "ops\n"; 
  }
}
$x = new C;
$x->foo();

All the BC breaks are intentional and they are described in the proposal section.

PHP 7.1

none

none

The proposed implementation is compatible with opcache

none

The vote is a straight Yes/No vote, that requires a 2/3 majority. The voting will begin on Jun 6 and will close on Jun 16.

PR 1918

After the project is implemented, this section should contain

1. the version(s) it was merged to
2. a link to the git commit(s)
3. a link to the PHP manual entry for the feature

Keep this updated with features that were discussed on the mail lists.