Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:84594
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.218.46 as permitted sender)
MIME-Version: 1.0
Sender: yohgaki@gmail.com
In-Reply-To: <550035F0.10703@gmail.com>
References: <CAGa2bXYa5Lz0JqySVSQ+hGfCW-WxxKWvqFtWaZo=OVf+LLsV8A@mail.gmail.com>
 <CEF2AD42-3CE1-489F-8192-D1DC3D8D8698@gmail.com> <CAGa2bXZDnuE3mKQYD+Sq2=kH=YDXuRQA3o+9wg4v81ZS+h3rLw@mail.gmail.com>
 <54F83C4D.1020206@gmail.com> <CAEZPtU6ni038E+b0ziAC1b0w=t3gsmBwMjAui4e0sXd8EgbyXQ@mail.gmail.com>
 <CAL0xaBF7u2h9A5UnVB+-z6SwDtLOVY_qL7B9UGj7w_Lecwct6A@mail.gmail.com>
 <CAGa2bXa5zER03VrMrtD9aUQ38LK9C_UWU-jbGjzEZUoxbUsSQQ@mail.gmail.com>
 <54F8BF67.6080600@gmail.com> <CAGa2bXbvZbMb5C0RnaDAVTAMK_+9x-BzidXcm9MgoaGmtWK+Zg@mail.gmail.com>
 <848D3C19-DE29-4E5F-9B23-D87D3F4A9365@gmail.com> <CAGa2bXZgx4JCv3e5a94SXwYOnLMXjYcXdMizdQ9bpqZz7oYGzQ@mail.gmail.com>
 <54FB45D6.3040803@gmail.com> <CAGa2bXYU_DRuo3T8WRuq=3Xih79BZ7vHqYOnry2AvxgVx8g0WA@mail.gmail.com>
 <54FCD063.4040300@gmail.com> <CAGa2bXYt_zHfLgKEXP+uzTH0KbeAqRmxxEAcCtsMYgyW4ptfSA@mail.gmail.com>
 <54FEB910.5000608@lsces.co.uk> <CAGa2bXbLVoBM+d0VVqwm8-tKaFWRE1WpMnLMaFWVHMjH4hRvDA@mail.gmail.com>
 <54FF5E39.7000507@lsces.co.uk> <550035F0.10703@gmail.com>
Date: Thu, 12 Mar 2015 07:44:15 +0900
Message-ID: <CAGa2bXZ=ukPSLp3woZsuHo+s37VnV3XJ1izFvzRwnNjuARh+PA@mail.gmail.com>
To: Rowan Collins <rowan.collins@gmail.com>
Cc: "internals@lists.php.net" <internals@lists.php.net>
Content-Type: multipart/alternative; boundary=001a113334342610e405110b0445
Subject: Re: [PHP-DEV] Consistent function names
From: yohgaki@ohgaki.net (Yasuo Ohgaki)

--001a113334342610e405110b0445
Content-Type: text/plain; charset=UTF-8

Hi Rowan,

On Wed, Mar 11, 2015 at 9:32 PM, Rowan Collins <rowan.collins@gmail.com>
wrote:

> Lester Caine wrote on 10/03/2015 21:12:
>
>> On 10/03/15 20:44, Yasuo Ohgaki wrote:
>>
>>> YES there is room to create a more consistent procedural interface, but
>>>>> my original question still applies "consistent with what rules?"
>>>>>
>>>> It's possible choice.
>>> I agree that names without "_" looks more consistent.
>>> Personally, I don't care much about having "_" or not for procedural
>>> API. My
>>> only concern is naming consistency.
>>>
>>> Names without "_" changes basic coding rule.
>>> Problem is how to make a choice and how to define exceptions. e.g.
>>> nl_langinfo()
>>>
>>> I wonder how many of us prefer names without "_".
>>>
>> The one thing that your RFC demonstrates perfectly is just how much has
>> to change to match that rule. Change the rule and the number of names
>> that need alternatives is considerably less. I know a case was made at
>> the time for adding underscores to the guidelines but it's quite clear
>> that this was the mistake?
>>
>
> PHP function names are case insensitive, and conventionally written in
> lower-case (a convention that nothing decided on this list will change), so
> underscores are important for readability.
>
> To take an example Yasuo has mentioned a couple of times, pg_lo_open()
> without any underscores at all would be pgloopen(), which is very hard to
> read: it could be pGloopen(), pgLoopEn(), pGlooPen(), pgLoOpen(), etc.
>
> For whatever reason, PHP's users decided to go with camelCase identifiers
> for methods, rather than underscores. I don't think that was a decision
> that originated in the core distribution (which for a long time had very
> few object APIs), and I don't think it's one that can be changed by the
> core distribution (or, at this stage, anyone).
>
> If PHP had had namespaces from day 1, and camel-case conventions, it would
> have been pg\loOpen(), but we can't change history.
>

We cannot change history, so we have to make choice that is feasible.
I think use of "_" wasn't too bad. PHP stores function names as lower cased
names.
Therefore, error message says "Warning some error in
imagecolorclosesthwb()", etc.
It's hard to read, indeed. It also encourage users to use
"imagecolorclosesthwb" as
official name...

It may be better to consider how namespace for internals should be used.
Otherwise,
we may have to rename functions/namespaces again in the future. It may be
for PHP8.
It may be for PHP7.x if changes are not destructive at all.

Having namespace for internals would bring much flexibility for API
changes, both
OO and procedural API. I may try my best to have consensus.

I think you also like to have OO style API for basic
variables(int/float/array) as I am.
Unless we have good/proper procedural API names, it would be an obstacle to
have
OO style API for basic variables. I wish you agree to do something for it.

Regards,

--
Yasuo Ohgaki
yohgaki@ohgaki.net

--001a113334342610e405110b0445--