Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:92933 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 46204 invoked from network); 29 Apr 2016 13:18:31 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 29 Apr 2016 13:18:31 -0000 Authentication-Results: pb1.pair.com header.from=lester@lsces.co.uk; sender-id=unknown Authentication-Results: pb1.pair.com smtp.mail=lester@lsces.co.uk; spf=permerror; sender-id=unknown Received-SPF: error (pb1.pair.com: domain lsces.co.uk from 217.147.176.214 cause and error) X-PHP-List-Original-Sender: lester@lsces.co.uk X-Host-Fingerprint: 217.147.176.214 mail4-2.serversure.net Linux 2.6 Received: from [217.147.176.214] ([217.147.176.214:39986] helo=mail4.serversure.net) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id D9/3A-26386-32F53275 for ; Fri, 29 Apr 2016 09:18:29 -0400 Received: (qmail 10970 invoked by uid 89); 29 Apr 2016 13:18:25 -0000 Received: by simscan 1.3.1 ppid: 10964, pid: 10967, t: 0.1443s scanners: attach: 1.3.1 clamav: 0.96/m:52/d:10677 Received: from unknown (HELO ?10.0.0.7?) (lester@rainbowdigitalmedia.org.uk@81.138.11.136) by mail4.serversure.net with ESMTPA; 29 Apr 2016 13:18:25 -0000 To: internals@lists.php.net References: <571E35D8.8080504@zend.com> <571E4A83.3080304@garfieldtech.com> <571E64A2.2040505@gmail.com> <5720A6B4.4000307@lsces.co.uk> <5721B9DD.3050300@lsces.co.uk> <57231ADD.9040006@lsces.co.uk> <572326A3.7000809@lsces.co.uk> <57234D3D.1070602@lsces.co.uk> <79c9df57-ee45-f415-3172-95f8229bbece@gmail.com> Message-ID: <57235F20.5080707@lsces.co.uk> Date: Fri, 29 Apr 2016 14:18:24 +0100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Thunderbird/38.7.0 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit Subject: Re: [PHP-DEV] PHP Attributes -> docBloc alternatives ... From: lester@lsces.co.uk (Lester Caine) On 29/04/16 13:49, Benjamin Eberlei wrote: > Lester, nobody wants to move phpdoc out of the *doc* comment. Its still > documentation. It will stay,. > > We want to move the "annotations" out of the docblocks that are evaluated > at runtime for configuration. Thats two different things. That is what the > attributes RFC is for. But where will annotations like @range(0,110) fit in the new model? Along with the likes of '@notnull' and similar annotations that are also currently being planned to be spread around the rest of the code? If a variable is defined via the metadata as 'not null', then assigning null to it is an error, but I'm not convinced that people accept attributes like that in the current roadmap for PHP. It's fundamental to the original model where an 'object' was essentially simply an array of variables each with it's own set of attributes. Adding 'set and get' messes up the annotation model while still requiring the BC cases, but these 'magic' new functions do not understand the legacy attribute metadata? phpDocumentor2 now enforces the setter/getter model but without the flexibility to add the data validation attributes/annotation, and simply adding a type tag elsewhere only muddies the water further where we HAD a tidy way to handle a lot of what currently is being claimed is missing. I never was missing ... -- Lester Caine - G8HFL ----------------------------- Contact - http://lsces.co.uk/wiki/?page=contact L.S.Caine Electronic Services - http://lsces.co.uk EnquirySolve - http://enquirysolve.com/ Model Engineers Digital Workshop - http://medw.co.uk Rainbow Digital Media - http://rainbowdigitalmedia.co.uk