From: bugs dot php dot net_nospam at adviesenzo dot nl
Operating system:
PHP version: 7.3.0
Package: Documentation problem
Bug Type: Documentation Problem
Bug description:PHP 7.3: Various info missing from changelog/migration guide
Description:
------------
I realize you all are probably still working on updating the docs for
PHP 7.3, but hopefully this list of findings will help <3
* The changelog for 7.3.0 -
github.com/php/php-src/blob/PHP-7.3.0/UPGRADING - is missing a number of
changelog entries which are included in the 7.3 changelog -
github.com/php/php-src/blob/PHP-7.3/UPGRADING - for changes which *have*
been shipped with 7.3.0.
Additionally, the migration guide makes no mention of the following:
* New functions:
- net_get_interfaces() (also missing from UPGRADING, but mentioned
in NEWS and php.net/ChangeLog-7.php#7.3.0)
- ldap_exop_refresh() (also missing from UPGRADING, but mentioned
in NEWS and php.net/ChangeLog-7.php#7.3.0)
* New constants:
- FILTER_SANITIZE_ADD_SLASHES (mentioned in
php.net/manual/en/migration73.other-changes.php#migration73.other-changes.filter,
but not on the new constants page)
- LDAP_CONTROL_ASSERT
- STREAM_CRYPTO_PROTO_TLSv1_0
- STREAM_CRYPTO_PROTO_TLSv1_1
- STREAM_CRYPTO_PROTO_TLSv1_2
Other remarks:
* Lightweight Directory Access Protocol:
php.net/manual/en/migration73.new-features.php#migration73.new-features.ldap
vs the documentation of the ldap_parse_result() function
php.net/manual/en/function.ldap-parse-result.php
The way it looks to me, the documentation on the
ldap_parse_result() function page is wrong. Not the $serverctrls
parameter, but an $out parameter has been added. This is also listed
wrong in the Changelog section of the page and the parameter is also
missing from the Parameters documentation for the function.
* Lightweight Directory Access Protocol:
php.net/manual/en/migration73.new-features.php#migration73.new-features.ldap
vs the documentation of the ldap_get_option() function
php.net/manual/en/function.ldap-get-option.php and the
ldap_set_option() function
php.net/manual/en/function.ldap-set-option.php
The way it looks to me, the documentation on the ldap_get_option()
and the ldap_set_option() function pages is missing the since 7.3
for the LDAP_OPT_SERVER_CONTROLS and LDAP_OPT_CLIENT_CONTROLS
options.
If those were previously already supported, then the entry (third
bullet) in the changelog probably needs improved wording.
* LDAP Constants php.net/manual/en/ldap.constants.php
Looks like the new constants were added, but without a since 7.3
mention.
* Continue Targeting Switch issues Warning: The second line of the error
message is missing a // before it in the code sample in
php.net/manual/en/migration73.incompatible.php#migration73.incompatible.core.continue-targeting-switch
* FastCGI Process Manager
php.net/manual/en/migration73.new-features.php#migration73.new-features.fpm
Looks like the new options aren't listed yet on
php.net/manual/en/install.fpm.configuration.php
And just to check my own comprehension: these are just to be used in
php-fpm.conf ? and cannot be accessed through ini_get() or
ini_set() ?
* Strip-Tags Streaming
php.net/manual/en/migration73.deprecated.php#migration73.deprecated.core.strip-tags-streaming
Looks like the affected functions has not been marked as deprecated
yet - php.net/manual/en/function.fgetss.php (and the others).
Looks like the deprecation of the string.strip_tags stream filter
has not be annotated yet: php.net/manual/en/filters.string.php
--
Edit bug report at https://bugs.php.net/bug.php?id=77271&edit=1
--
Try a snapshot (PHP 5.4): https://bugs.php.net/fix.php?id=77271&r=trysnapshot54
Try a snapshot (PHP 5.5): https://bugs.php.net/fix.php?id=77271&r=trysnapshot55
Try a snapshot (trunk): https://bugs.php.net/fix.php?id=77271&r=trysnapshottrunk
Fixed in SVN: https://bugs.php.net/fix.php?id=77271&r=fixed
Fixed in release: https://bugs.php.net/fix.php?id=77271&r=alreadyfixed
Need backtrace: https://bugs.php.net/fix.php?id=77271&r=needtrace
Need Reproduce Script: https://bugs.php.net/fix.php?id=77271&r=needscript
Try newer version: https://bugs.php.net/fix.php?id=77271&r=oldversion
Not developer issue: https://bugs.php.net/fix.php?id=77271&r=support
Expected behavior: https://bugs.php.net/fix.php?id=77271&r=notwrong
Not enough info: https://bugs.php.net/fix.php?id=77271&r=notenoughinfo
Submitted twice: https://bugs.php.net/fix.php?id=77271&r=submittedtwice
register_globals: https://bugs.php.net/fix.php?id=77271&r=globals
PHP 4 support discontinued: https://bugs.php.net/fix.php?id=77271&r=php4
Daylight Savings: https://bugs.php.net/fix.php?id=77271&r=dst
IIS Stability: https://bugs.php.net/fix.php?id=77271&r=isapi
Install GNU Sed: https://bugs.php.net/fix.php?id=77271&r=gnused
Floating point limitations: https://bugs.php.net/fix.php?id=77271&r=float
No Zend Extensions: https://bugs.php.net/fix.php?id=77271&r=nozend
MySQL Configuration Error: https://bugs.php.net/fix.php?id=77271&r=mysqlcfg