Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:51673
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.216.42 as permitted sender)
DomainKey-Status: bad
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=mime-version:date:message-id:subject:from:to:content-type
         :content-transfer-encoding;
        b=We6voy/at6vg5UwDC7/JoGYZ/lHmCiqgo4I3Br9C2L9ZJTdWph1i0DWZANfvMNVgbD
         8YD7A2/MReGOjqppYjClx2EUmF6gej/wCR+AqGLwbp8QTwY5ydLXSM0lMxxUGROxIXy3
         GYdcuy+K35E36kHqdwRZMIoaL+IHdULj92oPc=
MIME-Version: 1.0
Date: Sun, 13 Mar 2011 17:50:33 -0300
Message-ID: <AANLkTimkwFTD+Da2FhORfqJvT2WAXBni=SY5QLFZ+8Y8@mail.gmail.com>
To: internals@lists.php.net
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
Subject: native php annotations
From: marcelog@gmail.com (Marcelo Gornstein)

Hello All,

I'm new to this list, so please excuse me if this subject was already
discussed, or proposed.

I've made an experimental patch to ZendEngine/PHP (5.3.5) to allow
native annotations (without doc comments), using the token @@ (the @
was already taken). It allows 0 or more annotations (with 0 or more
arguments each one) for classes, properties, methods, and arguments
for methods, like:

@@Annotation(key=3D"value1")
class A {
    @@Annotation(key=3D"value1")
    private $property;

    @@Annotation(key=3D"value1")
    private function aMethod(@@Annotation(key=3D"value1") @@Annotation2 $a,=
 $b) {
        ...
    }
}

The patch can be found at: https://github.com/marcelog/AnoForPHP.

The annotations and their optional arguments can be retrieved via the
getAnnotations() method of ReflectionClass, ReflectionMethod,
ReflectionParameter, and ReflectionProperty.

I plan to extend this patch with some extended functionality, like
having PHP instantiate a given class for the given annotation. By
using convention instead of configuration, the name of the annotation
is the name of the class, which should also extend some PHP base
class, like "Annotation".

I'm basically looking for comments on the patch and the functionality,
since I'm new to the ZendEngine as well.

Again, I'm sorry if this post should not go here or there is not
interest in such a feature in the language itself. Also, if I missed
something in the code of the patch, because it's more like a
proof-of-concept than a final formal proposal.

Regards!


--
// I don't sleep. I coffee.
"Make everything as simple as possible, but not simpler." -- Albert Einstei=
n
"The class object inherits from Chuck Norris."
"Chuck Norris can divide by zero and can unit test an entire
application with a single assert."
"There=E2=80=99s a lot of work happening behind the scenes, courtesy of the
Spring AOP framework"
"Why do I have this nagging hunch that you have no idea what you're doing?"
"Any society that would give up a little liberty to gain a little
security will deserve neither and lose both" - Benjamin Franklin