On 12.06.2019 at 17:32, G. P. B. wrote:

> I've been going through the documentation again to remove mentions of PHP 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 your
> 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 being
>    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 obsolete 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

--
PHP Internals - PHP Runtime Development Mailing List
To unsubscribe, visit: http://www.php.net/unsub.php

Reply via email to