1
0
mirror of https://github.com/php/doc-en.git synced 2026-04-27 01:08:09 +02:00
Commit Graph

28491 Commits

Author SHA1 Message Date
Christoph M. Becker d2e48faaf8 Remove vld INI settings
It makes no sense to list these, if there is no other vld documentation
in the manual.
2023-01-05 11:01:24 +01:00
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
Máté Kocsis 681fd84dbd Add documentation for missing attribute constructors (#2126)
Co-authored-by: Christoph M. Becker <cmbecker69@gmx.de>
2023-01-02 21:33:51 +01: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
Marco Aurélio Deleu 500f8db67a Point the readme to the doc-base repository
Co-authored-by: Anna Filina <afilina@gmail.com>

Closes GH-869.
2022-12-27 15:43:19 +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
Christoph M. Becker 5d775e7df5 Fix GH-2115: Typo in unpacking 2022-12-26 15:07:02 +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
Juliette b59634b465 OOP5/Traits/Constants: fix example code
The example code contained three errors:
* Reference to non-existent `ConstantTrait` trait (x2).
* Instantiation of non-existent `ConstantExample` class.
* Reference to an undefined constant.

Fixed now.

Co-authored-by: jrfnl <jrfnl@users.noreply.github.com>

Closes GH-2118.
2022-12-25 11:59:07 +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
Anna Filina 6d2f72b0f2 Fix typo in PHP 7.0 migration guide
Closes GH-2110.
2022-12-23 18:47:54 +01: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
George Peter Banyard b035daa699 Nits to the type juggling page (#2098)
The big one is the need to clarify the behaviour around the coercive typing mode, as the conversion of objects to strings is relatively straight forward but in theory internal objects that overload the cast handler can convert to other types too.

Drive-by typo fix

Co-authored-by: Christoph M. Becker <cmbecker69@gmx.de>
2022-12-21 20:16:19 +00: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 99ef98227f Fix GH-2082: Incorrect output for example
We fix the wording in the explanation, too.
2022-12-16 12:43:12 +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