Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:105908
To: "G. P. B." <george.banyard@gmail.com>,
 PHP internals <internals@lists.php.net>
References: <CAFPFaMJ8DqBgALHLE26fu1H5eqmQuRKbUpyV_0i4_1WbtYX==Q@mail.gmail.com>
Message-ID: <2184c8cc-5a97-e280-fc6d-33efbbfcaeb0@gmx.de>
Date: Thu, 13 Jun 2019 16:33:43 +0200
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:60.0) Gecko/20100101
 Thunderbird/60.7.0
MIME-Version: 1.0
In-Reply-To: <CAFPFaMJ8DqBgALHLE26fu1H5eqmQuRKbUpyV_0i4_1WbtYX==Q@mail.gmail.com>
Content-Type: text/plain; charset=utf-8
Content-Language: de-DE
Content-Transfer-Encoding: quoted-printable
Subject: Re: Feedback on state of some PHP extensions, functions, etc.
From: cmbecker69@gmx.de ("Christoph M. Becker")

On 12.06.2019 at 17:32, G. P. B. wrote:

> I've been going through the documentation again to remove mentions of PH=
P 4
> and found some extensions, functions, etc. on which I'd like to know the
> state of them and if it would be wise to deprecate them.
>
> I know I've thrown in some function aliases again, but only those which =
I
> think wouldn't have widespread usage. If those should still be kept in y=
our
> opinion please let me know.
>
> The list are more rough notes that I took while reading the doc so if
> something seems unclear let me know.
>
>
>    - The FILE_USE_INCLUDE_PATH constant in the Filesystem extension bein=
g
>    an integer makes it unusable with strict types for file_get_contents(=
) [6]
>    however it is also used for a flag argument where it can be combined =
with
>    other constants with a binary OR [7] [8].
>    Should this be just considered a Doc Bug?

I don't think there's still a bug in the docs regarding
FILE_USE_INCLUDE_PATH.  See the respective note for the
$use_include_path parameter.

>    - Unbundle the NSAPI Extension (if this is already the case, there is
>    doc error in the membership state of the extension) as it seems obsol=
ete in
>    this day and age as it handles Sun/Netscape servers [24]

The NSAPI is removed as of PHP 7.0.0, so the docs should be fixed.

>    - Unbundle the XML-RPC extension as it is considered experimental [25=
]

I wouldn't unbundle ext/xmlrpc because it is documented as being
experimental, but rather because nobody really looks after it, we're
bundling a modified ancient version of libxmlrpc, and even the upstream
libxmlrpc-epi isn't maintained for years.

Thanks,
Christoph

> [6] https://www.php.net/manual/en/function.file-get-contents.php
> [7] https://www.php.net/manual/en/function.file-put-contents.php
> [8] https://www.php.net/manual/en/function.file.php
> [24] https://www.php.net/manual/en/book.nsapi.php
> [25] https://www.php.net/manual/en/intro.xmlrpc.php