Commit graph

19491 commits

Author SHA1 Message Date
Christoph M. Becker
3a2e96fcc0
Fix type of 2nd parameter of openssl_csr_export()
Cf. <https://github.com/php/php-src/pull/8362>.
2022-04-13 15:35:04 +02:00
Rowan Tommins
6105da168f
Rewrite SoapClient constructor documentation
This constructor takes a large number of options, most of which
were effectively undocumented, leading to a very high volume of
User Notes. Some examples and caveats from these notes have been
incorporated.

The descriptions here are largely based on reverse-engineering
the source code (which isn't particularly well commented) and
experimenting locally, so may not be 100% accurate, or capture
differences between versions.
2022-04-12 13:33:55 +02:00
Sergey Panteleev
764e22fefc
Update array_combine return values section (#1513)
Fix #1512
2022-04-12 13:24:42 +03:00
Yoshinari Takaoka
e3ac07c850
moved too long title to <para></para> contents. 2022-04-09 17:49:08 +09:00
Larry Garfield
706c7ac6ea
Usort updates based on comments (#1492)
* Use spaceship where appropriate.

* Add example of multi-axes sorting with spaceship.

* Don't acknowledge the existence of PHP < 7
Co-authored-by: George Peter Banyard <girgias@php.net>

* Minor updates
Co-authored-by: Christoph M. Becker <cmbecker69@gmx.de>

Co-authored-by: George Peter Banyard <girgias@php.net>
Co-authored-by: Christoph M. Becker <cmbecker69@gmx.de>
2022-04-08 11:24:38 -06:00
Larry Garfield
8d7f21b1c1
register_shutdown_function() updates based on comments (#1493)
* Note that shutdown functions may still register shutdown functions.

* Add note about max execution time.

* Add cross reference to fastcgi_finish_request.

* Correct grammar.
2022-04-08 11:19:19 -06:00
George Peter Banyard
fe5841adc7 Remove return value section for Intl constructors 2022-04-08 00:49:02 +01:00
George Peter Banyard
967b4787ba Remove return value section for Reflection constructors 2022-04-08 00:45:55 +01:00
George Peter Banyard
fda6c4efe2
Update SPL class construtor pages (#1466)
Add missing changelogs for changes in PHP 8
2022-04-07 12:40:48 +01:00
Derick Rethans
15244038c7 Updated to version 2022.1 (2022a) 2022-04-07 10:38:32 +01:00
George Peter Banyard
c44e9cb68b
Fix some (con|de)structor pages (#1507)
Co-authored-by: Christoph M. Becker <cmbecker69@gmx.de>
2022-04-06 18:55:35 +01:00
Christoph M. Becker
8a9c2ca098
Link to mb_encoding_aliases() from mb_list_encodings() 2022-04-06 12:51:55 +02:00
Martin Samesch
39752929cd
Typo 2022-04-06 12:04:02 +02:00
Rowan Tommins
5065e44c26
Add closure versions of all create_function examples
Basically the only reason people should be looking at the manual
for create_function right now is to see how *not* to use it. So,
for every example that was already included, I've added the
corresponding version using real anonymous functions.

Also, I've reworded the purpose and description, because these
functions aren't anonymous, as evidenced by the return value being
their name.

Closes GH-1500.
2022-04-05 13:59:01 +02:00
Christoph M. Becker
a8b575aeac
Fix GH-1478: strftime is deprecated as of PHP 8.1 but no mention of what to use instead 2022-04-05 13:50:13 +02:00
Máté Kocsis
c55ff133ad
Annotate readonly ext/mysqli properties (#1505) 2022-04-05 13:48:02 +02:00
George Peter Banyard
73fae4ee51
Fix syntax errors in examples (#1504) 2022-04-05 11:15:46 +01:00
David Grudl
14a60fad6e
Fixed info about @ operator (#1196)
- UPGRADING says that the error_reporting (ie. value returned by error_reporting() or ini_get('error_reporting ')) is changed, not the severity value passed to the handler.
- UPGRADING says that the error_reporting() == 0 should be replaced with !(error_reporting() & $err_no) in code, not the return with return false. So there is currenctly no way how to detect @ operator.
- "Prior to PHP 8.0.0, the value of the severity passed to the custom error handler was always 0" - no true
- "return false; // Silenced" - not true, if the function returns false then the normal error handler continues, so it is not "silenced".

(partially reverts "Cleanup and update docs related to @ operator" commit 12b1d4704ea448b55ec155619be1e50c0e67e9f9.)

Co-authored-by: George Peter Banyard <girgias@php.net>
Co-authored-by: Larry Garfield <larry@garfieldtech.com>
2022-04-04 20:28:18 +01:00
George Peter Banyard
ca1c139b22 Fix extension membership for igbinary extension 2022-04-04 18:34:26 +01:00
George Peter Banyard
a223531900 Fix section order issues introduced by 99d758bd25 2022-04-04 18:05:11 +01:00
USAMI Kenta
d4d537e6a2
PDO::MYSQL_ATTR_LOCAL_INFILE_DIRECTORY was added in PHP 8.1
The first change mentioned in the manual for PDO::MYSQL_ATTR_LOCAL_INFILE_DIRECTORY was 03f0ebc60c.

Then 607ec1f63c stated about the version to which the constant was added.
However, it incorrectly appends to `MYSQL_ATTR_LOCAL_INFILE` instead of `MYSQL_ATTR_LOCAL_INFILE_DIRECTORY`.

Closes GH-1502.
2022-04-04 13:12:22 +02:00
Rowan Tommins
99d758bd25
Improve documentation of string encoding conversion functions
- Move utf8_encode and utf8_decode into the strings chapter, since
  they were moved out of the XML extension in 7.2
- Recommend mb_convert_encoding, iconv, and UConverter::transcode
  when mentioning encoding in passing
- Document UConverter::transcode, based on examination of source
  and upstream ICU docs
- Make the language used more consistent, e.g. "convert" rather
  than "encode"/"decode", "encoding" rather than "charset"

Closes GH-1418.
2022-04-04 12:24:24 +02:00
Fabien Salathe
8b0e03372d
Remove "experimental" warning from Foreign Function Interface
Foreign Function Interface (FFI) has been introduced in 2019 (PHP 7.4) and the API didn't change since then, it should probably be considered safe to use it.

Closes GH-1495. Closes GH-1499.
2022-04-02 18:13:26 +02:00
George Peter Banyard
42aa8713e3 Fix section order in Imagick docs 2022-04-02 15:40:34 +01:00
George Peter Banyard
e84773a605
Add missing parameter sections for PDO methods (#1459) 2022-04-02 15:34:36 +01:00
George Peter Banyard
45ac957ca5 Add docs for SoapClient::__call() based on SoapClient::__soapCall()
Also drive-by fixes to both __call() and __soapCall() in regards to markup
2022-04-02 13:16:38 +01:00
Jakub Zelenka
87d151824d Document gnupg_listsignatures 2022-03-31 20:48:26 +01:00
Jakub Zelenka
1ea36ad22a Document gnupg_gettrustlist 2022-03-31 20:48:00 +01:00
Jakub Zelenka
91db48f3b3 Document gnupg_deletekey 2022-03-31 20:47:27 +01:00
Sergey Panteleev
6330e4d731
Add examples for string functions (#1477) 2022-03-31 10:41:58 -05:00
Sergey Panteleev
58c419eb2e
[PHP 8.1] Add pcntl_rfork description (#1033) 2022-03-31 10:41:26 -05:00
Máté Kocsis
72d156e206
Sync DirectoryIterator method return types (#1293) 2022-03-31 08:34:47 +02:00
Kévin Dunglas
15247c75e1
False isn't allowed for substr()'s $length (#984) 2022-03-30 16:37:31 -05:00
沈唁
431616624d
Fix array_combine throws ValueError since PHP 8 (#850) 2022-03-30 16:33:13 -05:00
Sergey Panteleev
fe35f4a173
[PHP 8.1] Add IntlDatePatternGenerator description (#1026)
* [PHP 8.1] Add IntlDatePatternGenerator description
2022-03-30 15:33:06 -05:00
Martin Samesch
48754af1a1
Fix return type (int → bool) (#1359)
* Fix return type (int → bool)

Mentioned in doc-de #67 by Daijobou (thanks).
Changelog entry?

* added changelog (thanks saundefined)

* Section returnvalues adjusted

* Forgot to adjust description.

* Update reference/imagick/imagick/getimagealphachannel.xml

Co-authored-by: Christoph M. Becker <cmbecker69@gmx.de>

* Correct purpose

Co-authored-by: Christoph M. Becker <cmbecker69@gmx.de>
2022-03-29 20:15:14 +00:00
Kamil Tekiela
ab58951f68
Remove &warn.undocumented.func; from Reflection
Removed from all the places where it wasn't stricly necessary.

Closes GH-1217.
2022-03-29 16:49:06 +02:00
Theodore Brown
4a07033f7a
Improve description of empty return value
Previously it was written from the negative perspective, which was confusing to understand.

Closes GH-1430.
2022-03-29 15:21:54 +02:00
George Peter Banyard
33e5f4ef72
Fix constructorsynopsis usage in EV extension
Also drop return value section

Closes GH-1465.
2022-03-29 15:20:32 +02:00
Christoph M. Becker
e98c8aea66
Fix GH-1462: passthru() returnvalue section incorrect 2022-03-29 15:05:31 +02:00
Jakub Zelenka
7b935b2820 Update OpenSSL requirements 2022-03-28 19:54:44 +01:00
Sammy
210b5020c0
Add trailing semicolon to getDocComment
Although this is valid PHP, other functions' examples in the class (e.g. `getDefaultProperties` and `getConstructor`) contain this trailing semicolon.

Fixes GH-1432
Closes GH-1486.
2022-03-28 14:09:48 +02:00
colshrapnel
e1cbbb434a
Fix the return value description
The comment in the source code [goes](04a4864b65/ext/pdo/pdo_stmt.c (L1152)) as "if there are no more rows" and doesn't mention any failure.

Closes GH-1480.
2022-03-25 11:23:54 +01:00
Jordi Boggiano
266f9f6b4b
Fix sqlsrv_rows_affected/db2_num_fields return type
Closes GH-1479.
2022-03-25 10:34:39 +01:00
Anton
2e7c5de96f
Fix "see also" for ReflectionFunction::__toString (#1473) 2022-03-21 15:12:38 +00:00
Kamil Tekiela
59af09939a
Remove double parentheses in assert 2022-03-20 21:21:08 +00:00
Bradley Taylor
883d2fe5cb
assert() no longer evaluates strings as of PHP 8.0.0
As per the PHP changelog, the functionality to use a string for `assert` has been removed in PHP 8.0: 69888c3ff1/UPGRADING (L350-L354)

Co-authored-by: Christoph M. Becker <cmbecker69@gmx.de>

Closes GH-1471.
2022-03-20 11:59:40 +01:00
Christoph M. Becker
443531f6c6
Fix GH-1467: SplObjectStorage::removeAll does not return the number of removed objects 2022-03-18 11:03:15 +01:00
George Peter Banyard
5c8ec52976
Add missing return value sections for SNMP functions
Also fix the return value for others at the same time
2022-03-16 22:00:21 +00:00
George Peter Banyard
ecaa214642
Fix de/constructor synopsis tag usage (#1457)
In Solr, Stomp, Yaf.

Also include constructor and destructor in StreamWrapper interface synopsis
2022-03-15 16:36:11 +00:00