1
0
mirror of https://github.com/php/doc-en.git synced 2026-03-26 16:52:25 +01:00
Commit Graph

19965 Commits

Author SHA1 Message Date
Alex Dowad
e2e41fdb46 Clarify handling of 3rd parameter for assert callbacks
The handling of the 3rd parameter for assert callbacks set via `assert_options`
changed with the implementation of the expectations RFC, and changed again in
PHP 8. Update the documentation accordingly.

This one seems to be a cause for confusion; witness Bug [#79602]
(https://bugs.php.net/bug.php?id=79602).

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

Closes GH-120.
2023-01-04 17:57:44 +01:00
Tim Düsterhus
6e69d9342e Use FQCN for native attributes (#2137)
* Use FQCN for native attributes

For attributes, it's non-obvious that they need to be imported with `use` or
referenced with their FQCN, because applying a non-existent attribute is not an
error.

Make the examples copy-and-paste safe by adding the leading backslash, as
already done for `#[\SensitiveParameterValue]`.
2023-01-04 16:20:00 +00:00
Yoshinari Takaoka
519d86be33 fixed refpurpose of ReflectionFunctionAbstract::isStatic 2023-01-03 10:26:05 +09:00
Christoph M. Becker
170218df33 Fix GH-2136: ReflectionFunction has isStatic, but missing in docs 2023-01-02 17:35:15 +01:00
Robert Morley
bd38d9d20a Reword excessively hardcore requirement
While we're at it, we also remove the personalization.

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

Closes GH-2123.
2022-12-31 14:18:55 +01:00
Christoph M. Becker
04c37bc8ca Update bcsqrt() docs wrt. PHP 8.0.0 2022-12-31 14:08:54 +01:00
Christoph M. Becker
0189a49610 Builtin subclasses of IteratorIterator don't override getInnerIterator()
Maybe they did prior to PHP 7.0.0, but that would be irrelevant now
anyway.
2022-12-30 20:43:14 +01:00
Loyen
7f385d3239 Update return value description
Closes GH-2130.
2022-12-30 13:16:34 +01:00
Marcos Marcolin
42c0929282 Small spelling correction
Closes GH-2127.
2022-12-29 15:41:05 +01:00
Máté Kocsis
1acd98a6cd Remove unnecessary documentation of non-existent constructors (#2122)
Co-authored-by: Christoph M. Becker <cmbecker69@gmx.de>
2022-12-28 16:34:44 +01:00
Máté Kocsis
3fc56d76de List inherited constructors on the class synopsis pages (#2090) 2022-12-28 15:51:40 +01:00
USAMI Kenta
807156628f Duplicate note on microsecond precision from datetime.formats (#2114) 2022-12-28 23:05:27 +09:00
Máté Kocsis
adf11d8d64 Revert "Add documentation for default constructors - part 1 (#2089)" (#2121) 2022-12-28 08:50:09 +01:00
Christoph M. Becker
e057f1f552 Remove superfluous changelog entries
Actually, most (or even all) datetime functions returned false prior to
PHP 8.0.0, where they now throw an error.  Besides ZPP failures which
we certainly do not want to document explicitly, that also happened in
case the objects have not been properly initialized, which is so close
to ZPP failures, that we don't want to document that either.

Co-authored-by: Alexander Menshchikov <amenshchikov@gmail.com>

Closes GH-1358.
2022-12-27 16:54:37 +01:00
Christoph M. Becker
fea4357a0c Revert "Fixed and simplified array_replace description"
This reverts commit bb36df3ed4, which has
been committed inadvertently.
2022-12-26 15:43:51 +01:00
Dennis Weiershäuser
bb36df3ed4 Fixed and simplified array_replace description 2022-12-26 14:08:03 +01:00
Su, Tao
c7a7f596c4 Clarify jit_debug option and link to zend_jit.h
Clarify how to search for jit_debug options, and add an external link to
PHP zend_jit.h source file.

Hopefully, the clarification and link can save PHP the developer's and
user's time/effort with a simple click jumping to where they should go.

This patch has been verified on my local machine and link works well.

This risk is that doc viewer could get a dead link if PHP source code
file location moved or name changed in future. We just hope this is a
rare case and will not happen so frequently. We depend on user's
bug-report to fix any issue.

Reviewed-by: Christoph M. Becker <cmbecker69@gmx.de>
Signed-off-by: Su, Tao <tao.su@intel.com>

Closes GH-1340.
2022-12-26 13:15:53 +01:00
魔王卷子
c6f9de2b35 Remove duplicate footer comment
Closes GH-2120.
2022-12-26 11:46:00 +01:00
USAMI Kenta
3441bb1c98 Use milliseconds instead of seconds (#2113) 2022-12-24 20:36:51 +09:00
Máté Kocsis
48eeb30c78 Retain original $host parameter name of ldap_connect()
Closes GH-991.
2022-12-24 11:30:08 +01:00
Yoshinari Takaoka
31b22987dd fixed duplicate crosslink entry 2022-12-24 11:32:27 +09:00
Christoph M. Becker
42872b28a6 Fix GH-2108: http_build_query 3rd argument different results in PHP 7 vs 8 2022-12-23 13:22:16 +01:00
Rowan Tommins
464fbf0d12 Better crosslinks between str_replace and preg_replace
The str_replace page had a helpful note that if you'd somehow got
there when you were looking for preg_replace, you didn't need to
llok further. But if you were actually on the page for preg_replace,
there was no link to str_replace at all, not even in the See Also
section.
2022-12-22 18:18:14 +00:00
Benjamin Morel
944af3a79d is_a() works with interfaces, too (#506)
Co-authored-by: Anna Filina <afilina@gmail.com>
Co-authored-by: Christoph M. Becker <cmbecker69@gmx.de>
Co-authored-by: George Peter Banyard <girgias@php.net>
2022-12-22 18:00:24 +00:00
othercorey
befe29ff6f Fix Phar::convertToExecutable changelog parameter name
Closes GH-2104.
2022-12-22 15:37:04 +01:00
Máté Kocsis
0510540984 Add documentation for default constructors - part 1 (#2089)
Co-authored-by: Christoph M. Becker <cmbecker69@gmx.de>
2022-12-19 21:40:26 +01:00
Falk Rund
9381fcbdb1 [Issues/2093] fix typo (#2094) 2022-12-19 19:17:26 +03:00
Christoph M. Becker
aeda3e7df9 Fix GH-2092: Min/Max throw a fatal on empty error starting 8.0 2022-12-19 14:11:36 +01:00
Jeremy Mikola
a319efc2e8 Clarify how users can determine the correct DLL for their environment 2022-12-19 16:59:21 +08:00
Jeremy Mikola
9244ee3baa Document "sessionToken" option for AWS KMS provider for CSFLE
https://jira.mongodb.org/browse/PHPLIB-1049
2022-12-19 11:57:02 +08:00
Jeremy Mikola
2b69366348 Direct Windows users to GitHub releases for ext-mongodb DLLs
PECL stopped generating DLLs earlier this year. As of ext-mongodb 1.15.0, DLLs are now generated by a GitHub Action and attached to releases.

https://jira.mongodb.org/browse/PHPC-2143
2022-12-19 11:43:46 +08:00
Tiffany
caf779183e Add an example with two associative arrays to array_unshift page (#1954)
* Add an example showing how two associative arrays are combined

* Modernize array syntax in first example, use var_dump over print_r, revise wording, add types of fruits and vegetables into second example

* Add `array_merge()` to the "See Also" section
2022-12-17 14:26:10 -06:00
John Flatness
303580c0be ldap: Document removal of ber_identifier param
Closes GH-2086.
2022-12-17 13:02:50 +01:00
Christoph M. Becker
bba15cbc75 Fix GH-2071: DateTime::createFromFormat() does not accept DateTime 2022-12-16 12:58:29 +01:00
Christoph M. Becker
7018fc4321 Properly mark up parameters as parameters 2022-12-16 11:37:55 +01:00
魔王卷子
664efcbc32 Fix typo (passwd → password)
Closes GH-2087.
2022-12-16 11:11:55 +01:00
Jawira Portugal
a7d00d0b91 Update FilesystemIterator::__construct doc for php 8.2
Closes GH-2081.
2022-12-16 10:58:13 +01:00
Christoph M. Becker
08e31acb35 Fix yet another xpointer expression 2022-12-13 12:37:21 +01:00
Christoph M. Becker
071a588364 Fix xpointer expressions
When removing the `not()` operator, some closing parentheses have been
overlooked, which resulted in broken xpointer expressions.
2022-12-13 12:13:33 +01:00
Máté Kocsis
75b45dfe65 Reflector should use the new Stringable role attribute value 2022-12-13 10:58:53 +01:00
Máté Kocsis
bfef87dc15 Use new ext/spl role values (#2074) 2022-12-13 10:51:54 +01:00
Máté Kocsis
d51166ca16 Add ext/spl methodsynopsis roles (#2073) 2022-12-13 10:33:30 +01:00
Máté Kocsis
888d70d7d2 Update ext/snmp role attributes (#2072) 2022-12-13 09:43:46 +01:00
Máté Kocsis
f03806fcd8 Update ext/phar role attributes (#1983) 2022-12-13 09:21:59 +01:00
Máté Kocsis
89eaa41302 Fix some Error/Exception includes 2022-12-11 23:40:15 +01:00
Máté Kocsis
69b648925f Fix NumberFormatter includes 2022-12-11 23:35:47 +01:00
Máté Kocsis
dea05ca001 Remove unnecessary role attribute for libxml_get_external_entity_loader 2022-12-11 23:35:46 +01:00
Máté Kocsis
09c49da6f0 Update Error, Exception, and Throwable role attributes (#2069) 2022-12-11 23:32:45 +01:00
Máté Kocsis
a605fd10c6 Update JsonSerializable role attributes (#2059) 2022-12-11 23:21:42 +01:00
Máté Kocsis
770c6facae Update ext/simplexml role attributes (#2057) 2022-12-11 23:21:31 +01:00