Annotation of embedaddon/php/Zend/RFCs/001.txt, revision 1.1

1.1     ! misho       1: Revamped object model using object handles
        !             2: ===========================================
        !             3: 
        !             4: Background
        !             5: ----------
        !             6: 
        !             7: In the Zend Engine 1.0 (and its predecessor the PHP 3 scripting
        !             8: engine) the object model's design is that instantiated objects are
        !             9: language values. This means that when programmers are performing
        !            10: operations, such variable assignment and passing parameters to
        !            11: functions, objects are handled very similarly to the way other
        !            12: primitive types are handled such as integers and strings.
        !            13: Semantically this means that the whole object is being copied. The
        !            14: approach Java takes is different where one refers to objects by handle
        !            15: and not by value (one can think of a handle as an objects' ID).
        !            16: 
        !            17: Need
        !            18: ----
        !            19: 
        !            20: Unfortunately, the approach taken up to now has severely limited the
        !            21: Zend Engine's object oriented model, both feature and simplicity
        !            22: wise. One of the main problems with the former approach is that object
        !            23: instantiation and duplication is very hard to control, a problem which
        !            24: can not only lead to inefficient development but also often to strange
        !            25: run-time behavior. Changing the object model to a handle oriented
        !            26: model will allow the addressing of many needs such as destructors,
        !            27: de-referencing method return values, tight control of object
        !            28: duplication and more.
        !            29: 
        !            30: Overview
        !            31: --------
        !            32: 
        !            33: The proposed object model is very much influenced by the Java
        !            34: model. In general, when you create a new object you will be getting a
        !            35: handle to the object instead of the object itself. When this handle is
        !            36: sent to functions, assigned and copied it is only the handle which is
        !            37: copied/sent/assigned. The object itself is never copied nor
        !            38: duplicated. This results in all handles of this object to always point
        !            39: at the same object making it a very consistent solution and saving
        !            40: unnecessary duplication and confusing behavior.
        !            41: 
        !            42: Functionality
        !            43: -------------
        !            44: 
        !            45: After this change the basic use of objects will be almost identical to
        !            46: previous versions of the scripting engine.  However, you won't bump
        !            47: into awkward and confusing copying & destructing of objects.  In order
        !            48: to create and use a new object instance you will do the following:
        !            49: $object = new MyClass(); $object->method();
        !            50: 
        !            51: The previous code will assign $object the handle of a new instance of
        !            52: the class MyClass and call one of its methods.
        !            53: 
        !            54:  
        !            55: Consider the following code:
        !            56: 
        !            57: 1      class MyClass
        !            58: 2      {
        !            59: 3              function setMember($value)
        !            60: 4              {
        !            61: 5                      $this->member = $value;
        !            62: 6              }
        !            63: 7      
        !            64: 8              function getMember()
        !            65: 9              {
        !            66: 10                     return $this->member;
        !            67: 11             }
        !            68: 12     }
        !            69: 13     
        !            70: 14     function foo($obj)
        !            71: 15     {
        !            72: 16             $obj->setMember("foo");
        !            73: 17     }
        !            74: 18     
        !            75: 19     $object = new MyClass();
        !            76: 20     $object->setMember("bar");
        !            77: 21     foo($object);
        !            78: 22     print $object->getMember();
        !            79: 
        !            80: Without the new Java-like handles, at line 20 the objects' data member
        !            81: member is set to the string value of "bar".  Because of the internal
        !            82: representation of objects in the Zend Engine 1.0, the object is marked
        !            83: as a reference, and when it is sent by value to the function foo, it
        !            84: is duplicated (!).  Therefore, the call to foo() on line 21 will
        !            85: result in the $obj->setMember("foo") call being called on a duplicate
        !            86: of $object. Line 22 will then result in "bar" being printed.
        !            87: 
        !            88: This is how the scripting engine has worked until today. Most
        !            89: developers are probably unaware of the fact that they aren't always
        !            90: talking to the same object but often duplicates; others may have
        !            91: realized this can usually be solved by always passing objects by
        !            92: reference (unless a replica is actually desired, which is uncommon).
        !            93: 
        !            94: The new object model will allow for a much more intuitive
        !            95: implementation of the code.  On line 21, the object's handle (ID) is
        !            96: passed to foo() by value. Inside foo(), the object is fetched
        !            97: according to this handle and, therefore, the setMember() method is
        !            98: called on the originally instantiated object and not a copy.  Line 22
        !            99: will therefore result in "foo" being printed.  This approach gives
        !           100: developers tighter control of when objects are created and duplicated.
        !           101: An additional not-as-important benefit is that the object handle will
        !           102: be passed to foo() by value, which most probably will also save
        !           103: unnecessary duplication of the value containing the ID itself and thus
        !           104: additionally improving run-time performance.
        !           105: 
        !           106: This was just a simple description of why the new object model solves
        !           107: awkward behavior and makes object handling much easier, intuitive and
        !           108: efficient.  The importance of this change goes far beyond what is
        !           109: mentioned in this section as you will see in further sections which
        !           110: describe new features with a majority of them being based on this
        !           111: change.
        !           112: 
        !           113: Compatibility Notes
        !           114: --------------------
        !           115: 
        !           116: Many PHP programmers aren't even aware of the copying quirks of the
        !           117: current object model and, therefore, there is a relatively good chance
        !           118: that the amount of PHP applications that will work out of the box or
        !           119: after a very small amount of modifications would be high.
        !           120: 
        !           121: To simplify migration, version 2.0 will support an optional
        !           122: 'auto-clone' feature, which will perform a cloning of the object
        !           123: whenever it would have been copied in version 1.0.  Optionally, it
        !           124: will also be possible to request that the engine will emit an E_NOTICE
        !           125: message whenever such an automatic clone occurs, in order to allow
        !           126: developers to gradually migrate to the version 2.0-style behavior
        !           127: (without automatic clones).
        !           128: 
        !           129: Dependencies
        !           130: ------------
        !           131: 
        !           132: The new object model is not dependent on other features.  Many of the
        !           133: other Zend Engine 2.0 features, such as the $foo->bar()->barbara()
        !           134: syntax, destructors and others completely rely on this new object
        !           135: model.
        !           136: 

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>