On 10/27/2012 09:38 PM, Larry Garfield wrote:
On 10/26/2012 05:37 AM, Clint Priest wrote:
I'm opening up several new threads to get discussion going on the remaining "being debated" categories referenced in this 1.1 -> 1.2 change spec: https://wiki.php.net/rfc/propertygetsetsyntax-as-implemented/change-requests

------------------------------------------------------------------------
Some people are in favor of the internal functions being generated by an accessor declaration should be invisible and non-callable directly. Others are in favor of leaving them visible and callable.

*Type 1 ( Userland Programmer )**
*
As a userland programmer, someone who cares nothing for "how" php works, only how their own code works. If they define an accessor they expect to see an accessor, reflection should reflect that there are accessors and no other "methods" they did not explicitly define. If they were to reflect on all of the methods of their class and see a number of __getHours() they may be confused as to why or where this function came from. From their perspective, they have defined an accessor and "how" that accessor works on the inside is of no importance to them and only seeks to complicate or confuse matters when they are exposed to these "implementation details" of the php language its-self. If you tried to set a value such as $obj?abc = 1 through an accessor which could not be set, you would probably want to see an error like: Warning, cannot set Class?abc, no setter defined.

*Type 2 ( Internals Programmer )**
*
As an internals programmer, you want nothing hidden from you. If an accessor implements special __getHours() methods to work its magic, then you want to see them, you want to call them directly if you so choose. In effect you want nothing hidden from you. In this case you probably don't even want Reflection to reflect accessors as anything different than specially formatted and called methods on the class. This can be understandable because you want all information available to you. You would probably not be confused if you wrote $obj?abc = 1 and got back an error like "Fatal Error: Class->__setAbc() function does not exist.

*Unfortunately 80 to 95% of all people who use PHP are of the first type.**
*
Revealing these internal matters to them would only leave them confused, possibly frustrated and likely asking about it to the internals mailing list to answer (repeatedly).
------------------------------------------------------------------------

Thoughts?


Speaking as a user-land programmer that's been following this thread, but hasn't been able to jump in yet due to the high volume of comments...

What's unclear to me is what my mental model should be for this new syntax. That's important for informing how it should be exposed to me.

1) Should I have a mental model of this being some syntax candy on top of existing properties? Vis, this is just a short-hand for bean-style classes? By Bean style, I mean Properties that would be public but aren't because Public Is Bad(tm), so instead we have getX()/setX() for every property, so that we can still use the object like a struct rather than an object but still say we're using methods even though we've just reimplemented public properties with more verbose syntax. (Note: Yes, I know that's a rather harsh and judgmental description. I happen to firmly dislike Bean-style objects.)

2) Should I have a mental model that these fancy-pants properties are some different third thingie on objects, distinct from traditional data members and methods?

Right now I'm not sure which mental model I'm supposed to use, and I get the sense that there's no clear consensus on that question yet. That, I think, is the key question, and will inform how things like Reflection should expose data about this new syntax.

For instance, if model 2 is how I'm supposed to be thinking, then I'd expect I'd need a third reflection object for getting things off of an object/class, separate from traditional data members and methods. Then it's consistently a third thingie. If, however, I'm supposed to think of it as just a short-hand syntax for writing a bean, then I'd expect it to be presented to me as if I'd hand-written all of the stuff that this syntax is emulating. Vis, methods show up as methods, and anything I'd be able to read/write directly without going through an intermediary method should show up as a property just as it does now.

Note: I'm speaking here of the mental model of the user, which does not necessarily have any relationship to the implementation details. If I'm "supposed" to think of it as a third thingie, it doesn't matter that it may be implemented internally as syntactic sugar. It should be presented to me as a third thingie, consistently, with the engine internal implementation details completely irrelevant. (Which means they can be changed later if needs be.)

I don't know which mental model is intended, nor which one would be better, but that is, I believe, the question that should inform the rest of these discussions.

--Larry Garfield

Addendum: If model 2 (third distinct thingie) is how I'm supposed to be thinking of them, then perhaps an additional keyword is needed to help drive that point home. Vis:

class Foo {
  // Data member, directly accessible.
  public $bar;

  // Clearly a different type of thingie than $bar.
  public property $baz {
    get() { return $this->baz; }
    set($value) { $this->baz = $value;}
  }

  // A method as we know and love them.
  public function beep() {}

}

Of course, that should only be used if the mental model is that they're a distinct thingie. If it's just syntactic sugar (again, mental model, not implementation), then a new keyword is a bad idea.

--Larry Garfield

--
PHP Internals - PHP Runtime Development Mailing List
To unsubscribe, visit: http://www.php.net/unsub.php

Reply via email to