Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:50249
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.161.42 as permitted sender)
DomainKey-Status: bad
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=mime-version:in-reply-to:references:date:message-id:subject:from:to
         :cc:content-type:content-transfer-encoding;
        b=CTCngB9KCI8ZeyFMdcRbxeUGAubZOe0HiPUcFayXxJLhcgvdDuQX8nCWfABXqzx6NR
         oxRJKByIYTDUR4FOxyCxUl8AUVcl3vKQk46RKG/SiR1EESH99ALAwWGMU6kOwjSpw9pv
         5G/V1wjyeYsGTreY5pWeF0qir7hwC3ekTOoUo=
MIME-Version: 1.0
In-Reply-To: <AANLkTi=AK38E6Poh+bUqQeK5V9ck=0T9PnYkdq5RY5-m@mail.gmail.com>
References: <AANLkTik703Bky+ZtjdzBMY8tr97m34jDSSMyoB9opJKR@mail.gmail.com>
	<887FE7CFF6F8DE4BB3A9535F53AFD06A2C59B588@il-ex2.zend.net>
	<AANLkTin9BQj4VhwBBBOYkhDV8uFrmgPvMTZ3L8LgdSBg@mail.gmail.com>
	<887FE7CFF6F8DE4BB3A9535F53AFD06A2C59B6A0@il-ex2.zend.net>
	<AANLkTikOsWcA5X_M2KuM-4L2YtTY-Y6VqV3X_b4zNeFM@mail.gmail.com>
	<887FE7CFF6F8DE4BB3A9535F53AFD06A2C59D788@il-ex2.zend.net>
	<AANLkTi=AK38E6Poh+bUqQeK5V9ck=0T9PnYkdq5RY5-m@mail.gmail.com>
Date: Tue, 16 Nov 2010 11:50:25 -0200
Message-ID: <AANLkTim6r08B9i+wDuCYzn1EaJvFt_mCUVPto=g1q5s_@mail.gmail.com>
To: RQuadling@googlemail.com
Cc: Zeev Suraski <zeev@zend.com>, Pierre Joye <pierre.php@gmail.com>, 
	PHP internals <internals@lists.php.net>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
Subject: Re: [PHP-DEV] PHP 5.4 - Meta attribute (aka. Annotations) support discussion
From: guilhermeblanco@gmail.com ("guilhermeblanco@gmail.com")

Hi Richard,

The first proposed patch has some performance impact, due to the
parsing time. And that's just it.
Instantiation of annotation classes is irrelevant because it only
happens when you explicitly request for it at runtime. The only
drawback is that it cannot be cached in APC.

Cheers,

On Tue, Nov 16, 2010 at 10:32 AM, Richard Quadling <rquadling@gmail.com> wr=
ote:
> On 16 November 2010 07:06, Zeev Suraski <zeev@zend.com> wrote:
>>> -----Original Message-----
>>> From: Pierre Joye [mailto:pierre.php@gmail.com]
>>> Sent: Tuesday, November 16, 2010 1:45 AM
>>> To: Zeev Suraski
>>> Cc: guilhermeblanco@gmail.com; PHP internals
>>> Subject: Re: [PHP-DEV] PHP 5.4 - Meta attribute (aka. Annotations) supp=
ort
>>> discussion
>>>
>>> On Tue, Nov 16, 2010 at 12:39 AM, Zeev Suraski <zeev@zend.com> wrote:
>>> > Suggesting phpdoc is used for the purposes mentioned does not mean we
>>> don't understand what we're talking about.
>>>
>>> I feel like you never used annotations in other languages, did you?
>>
>> You got me... =C2=A0But as an intelligent human being I'd like to think =
I can evaluate the merits of a feature without having to actually use it.
>>
>> I'm not saying that annotations don't give you any value. =C2=A0Sure the=
y do. =C2=A0I'm saying that they come at a great price of adding an obscure=
 branch of syntax into a language that's already grown significantly in com=
plexity, and the bang for the buck isn't worth it. =C2=A0Those advanced dev=
elopers needing that feature can make do with phpdoc.
>>
>> Zeev
>
> Hi all.
>
> I use PHPDoc. I develop SOAP services and use ZF to autocreate my WSDL
> files. I've used tools to create classes from a WSDL file. I don't
> know how this qualifies specifically as "annotations" - so I'm
> probably in the same camp as Zeev on this.
>
> An issue for me is the lack of ongoing development (it seems) of
> phpdoc. Yes, sure, it is for documentation. But that is just one sort
> of annotation. [1]
>
> I think having a mechanism which is easily understood in both human
> and machine terms and obeys a simple, expandable syntax, then this
> would seem to be extremely useful.
>
> I like the idea of JSON encoded annotations. JSON is very simple to
> understand (if you can manually create a nested associative array in
> PHP, you can create JSON encoded data).
>
> I think for more complex annotations, a simple @tag doesn't seem like
> it is going to be enough. There is no way to nest the tags in any
> meaningful and validatable way. At least not in a way that is obvious
> when you read it. Also, for every new @tag, you have to tell PHPDoc to
> ignore it as it will produces noise.
>
> But consider now the amount of PHPDoc blocks out there. A PHPDoc ->
> annotations converter would have to be developed. Theoretically, one
> _SHOULD_ be able to do that using a PHPDoc template - I think - not an
> area I know well.
>
>
> One issue mentioned is that having annotations will have a
> "performance hit" on PHP.
>
> I'm obviously missing something here. If the annotation is in a
> blockcomment, then that would seem to satisfy the performance issue.
> Reading the annotation for normal runtime execution would seem wrong.
> Only as part of reflection or annotation specific access should the
> block be "decoded" into whatever form is required.
>
> So, aren't annotations really just an extension to the docblock
> decoding aspects of reflection? Do we have a "performance hit" because
> of reflection?
>
>
> I know I know very little about the impact on PHP, but a simple syntax
> wrapped in a comment would really seem to be an ideal approach to me.
> So much so, I'm almost surprised we need anything in the core at all.
>
>
>
> Regards,
>
> Richard.
>
> [1] http://en.wikipedia.org/wiki/Annotation#Software_programming
>
> --
> Richard Quadling
> Twitter : EE : Zend
> @RQuadling : e-e.com/M_248814.html : bit.ly/9O8vFY
>



--=20
Guilherme Blanco
Mobile: +55 (16) 9215-8480
MSN: guilhermeblanco@hotmail.com
S=C3=A3o Paulo - SP/Brazil