1
0
mirror of https://github.com/php/doc-en.git synced 2026-03-23 23:32:18 +01:00

205 Commits

Author SHA1 Message Date
Arnaud Le Blanc
99916949eb Followup "Document get_error_handler(), get_exception_handler()" (#4686)
Followup of #4567 to address post-merge comments
2025-05-20 22:48:05 +01:00
Juliette
a124543dd3 Fix links to magic constants page (#4668)
Not sure what happened here, but found quite a few incorrect links for the magic constants page.

Fixed now.
2025-05-15 21:59:00 -07:00
Mikhail Alferov
21ce7d7f4f set-error-handler.xml Remove the misleading statement
For the method of the class as an error handler, the `set_error_handler` function may return a `callable`:

a) a string

b) a Closure

c) an indexed array (with the name of the class or an instance of the class in the first element, and the name of the method in the second one)

However, it is not limited to just "an indexed array with the class and method name".

I suggest removing the mention of the array as a return value, otherwise we will have to list every possible type of callable value :)
2025-04-24 16:08:57 +02:00
Arnaud Le Blanc
4a6671fe69 Document get_error_handler(), get_exception_handler() (#4567)
RFC: https://wiki.php.net/rfc/get-error-exception-handler
2025-04-21 13:15:50 +02:00
Gina Peter Banyard
72b70d7c3c PHP 8.4: trigger_error() updates (#4063) 2024-11-14 22:01:55 +00:00
Mikhail Alferov
210d382b5b trigger-error.xml: add the literal tag for the E_USER_* (#3570)
* trigger-error.xml: add the `literal` tag for the E_USER_*

* trigger-error.xml: change the family of constants syntax

Co-authored-by: Peter Cowburn <petercowburn@gmail.com>

---------

Co-authored-by: Peter Cowburn <petercowburn@gmail.com>
2024-07-26 02:47:37 +01:00
Mikhail Alferov
1fd69376c6 debug-print-backtrace.xml: added include and require statements links (#3443) 2024-06-14 17:15:00 +01:00
Máté Kocsis
d715365c09 Sync some methodsynopses with stubs (#3199)
Co-authored-by: Gina Peter Banyard <girgias@php.net>
2024-04-16 13:02:43 +02:00
Jérôme Tamarelle
e203b12d79 Fix debug_backtrace() argument description (#2935)
Zero ``0`` is a specific value
2023-11-14 01:21:37 +00:00
immeëmosol
9caac4c5cc Note that error control operator (@) affects error_reporting (#2804)
Co-authored-by: George Peter Banyard <girgias@php.net>
2023-10-18 01:27:10 +01:00
immeëmosol
2fe8d67ea4 error_reporting: Fix return value description (#2805) 2023-10-16 17:38:10 +02:00
Sebastian Hädrich
26a8f2141b Add note explaining the bitmap combination possiblities for debug_backtrace() (#1630)
Co-authored-by: George Peter Banyard <girgias@php.net>
2023-07-26 14:39:47 +01:00
Máté Kocsis
f781803449 Narrow bool return types to true when possible (#2458) 2023-05-07 22:32:58 +02:00
Odachannnn
686b6869e2 Exceptions are not specific to PHP 5 (#2352) 2023-03-15 21:41:53 +00:00
Kamil Tekiela
23906aa9f6 die is not a function (#2218) 2023-01-19 10:01:59 +00: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
Máté Kocsis
b5525a1412 Use the alias entity everywhere (#1800) 2022-09-06 21:10:52 +01:00
Kamil Tekiela
09f4a3f040 Reword parameter description of set_exception_handler (#1004) 2022-05-18 17:56:55 +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
Máté Kocsis
769812c12f Generate various ext/standard method synopses from stubs - part 5 (#1232) 2021-12-22 12:34:12 +01:00
Christoph M. Becker
44090248a8 Update set_error|exeception_handler $callback descriptions
First, the $callback is a callable, and users are supposed to either
know what that means, or look it up elsewhere in the documentation, so
there is no need to explain it here again, and let it rot again.

Second, there is no need anymore to document pre PHP 7.0.0 behavior.
2021-12-17 14:22:42 +01:00
Christoph M. Becker
7a312f9c79 set_error_handler() no longer returns null on failure
As of PHP 8.0.0, it throws a TypeError; prior to that version, that was
undefined behavior (as documented for internal functions).
2021-11-18 15:23:04 +01:00
Danack
b95e76e41d Types are not hints in PHP. (#1003)
As they are checked at run-time, type checking is enforced in PHP and not 'hinted'.

Co-authored-by: Kamil Tekiela <tekiela246@gmail.com>
2021-10-09 14:43:01 +01:00
Kamil Tekiela
de9c65c91f Remove E_STRICT and other PHP 5 related information (#730) 2021-08-17 17:56:25 +01:00
Sergey Panteleev
1de948e93f Fix issues in ErrorFunc directory
Part of #658
2021-06-09 12:12:17 +03:00
Christoph M. Becker
24ea750d47 Remove PHP 5 specific info 2021-05-23 15:07:41 +02:00
Máté
c44475e1fa Generate methodsynopses based on stubs for Zend functions and methods
Co-authored-by: Christoph M. Becker <cmbecker69@gmx.de>

Closes GH-168.
2021-05-22 16:48:16 +02:00
Sergey Panteleev
5fabd07880 Removed Changelog entries for PHP 5, PHP 7.0 (#543) 2021-04-22 17:52:58 +03:00
George Peter Banyard
12b1d4704e Cleanup and update docs related to @ operator
Also fix part of the set_error_handler() docs

Closes GH-441
2021-02-18 16:31:56 +00:00
Christoph M. Becker
471f9f42cd error_log($msg, 0) always returns true
Cf. <https://bugs.php.net/66760>.
2021-02-17 12:52:28 +01:00
Christoph Michael Becker
0c9c2dd669 Generate some standard methodsynopses based on stubs
Cf. <https://github.com/php/doc-en/pull/289>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@352191 c90b9560-bf6c-de11-be94-00142212c4b1
2020-12-26 19:26:31 +00:00
Christoph Michael Becker
71c12b1583 set_error_handler: clarify callback parameters and PHP 8.0 changes
Closes GH-276.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@352038 c90b9560-bf6c-de11-be94-00142212c4b1
2020-12-12 18:36:18 +00:00
Christoph Michael Becker
e41806c30b Revert revision(s) 351724 from phpdoc/en/trunk:
Document false and null return types

Cf. <https://news-web.php.net/php.doc.cvs/17645>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351730 c90b9560-bf6c-de11-be94-00142212c4b1
2020-11-28 18:05:44 +00:00
Christoph Michael Becker
4754397753 Revert revision 351727 from phpdoc/en/trunk:
Document false and null return types

Cf. <https://news-web.php.net/php.doc.cvs/17645>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351729 c90b9560-bf6c-de11-be94-00142212c4b1
2020-11-28 17:58:32 +00:00
Jakub Vrana
69bd53265b Document false and null return types
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351727 c90b9560-bf6c-de11-be94-00142212c4b1
2020-11-28 15:12:46 +00:00
Jakub Vrana
c80da7c04a Document false and null return types
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351724 c90b9560-bf6c-de11-be94-00142212c4b1
2020-11-28 12:54:59 +00:00
Christoph Michael Becker
86e6094e86 Use canonical type names
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351133 c90b9560-bf6c-de11-be94-00142212c4b1
2020-11-02 15:39:04 +00:00
Christoph Michael Becker
80872147aa Get rid of "callback" types
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350788 c90b9560-bf6c-de11-be94-00142212c4b1
2020-10-06 09:11:05 +00:00
Christoph Michael Becker
b92a33c51c Fix #80164: Example says "see changelog" but there's no changelog
That example refers to a changelog entry which stated that E_ALL is
available as of PHP 5.4.0.  Since the documenation does no longer
document PHP 5, that referral has to be removed.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350716 c90b9560-bf6c-de11-be94-00142212c4b1
2020-09-30 12:05:41 +00:00
Christoph Michael Becker
7f569e1f17 Remove more changelog entries, mostly from PHP 5.3 era
Patch contributed by Sobak <msobaczewski@gmail.com>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350655 c90b9560-bf6c-de11-be94-00142212c4b1
2020-09-26 14:08:59 +00:00
Christoph Michael Becker
9af43469f4 Remove more changelog entries, mostly from PHP 5.2 era
Patch contributed by Sobak <msobaczewski@gmail.com>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350654 c90b9560-bf6c-de11-be94-00142212c4b1
2020-09-26 13:52:31 +00:00
Christoph Michael Becker
be5b0f33a1 Remove more changelog entries, mostly from PHP 5.1 era
Patch contributed by Sobak <msobaczewski@gmail.com>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350653 c90b9560-bf6c-de11-be94-00142212c4b1
2020-09-26 13:45:57 +00:00
Christoph Michael Becker
f29b00cccf Improve example regarding valid HTML
This integrated user note 125348.  Also, there is no need to `break` after `exit`ing.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350547 c90b9560-bf6c-de11-be94-00142212c4b1
2020-09-11 12:39:38 +00:00
Peter Cowburn
0007fca77f Clarify set_error_handler types that cannot be handled (doc bug #76318)
Patch by Sorin Nunca

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@349133 c90b9560-bf6c-de11-be94-00142212c4b1
2020-02-05 20:04:00 +00:00
George Peter Banyard
b824e2b108 Remove PHP 4 and 5.0.0 mentions.
This includes changelogs but also some paragraphs and notes which mention PHP 4.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@347555 c90b9560-bf6c-de11-be94-00142212c4b1
2019-06-05 17:31:34 +00:00
Andrey Andreev
028513e94b Document PHP 7.2 deprecations as the result of https://wiki.php.net/rfc/deprecations_php_7_2
Also, simplify the first paragraph of 'Traditional assertions' in assert() docs

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@342126 c90b9560-bf6c-de11-be94-00142212c4b1
2017-03-14 11:30:59 +00:00
Thomas Punt
0e2239fcf9 Resolve doc bug #73892
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@341674 c90b9560-bf6c-de11-be94-00142212c4b1
2017-01-17 10:39:08 +00:00
Christoph Michael Becker
f0e9d47a0d Confer to error_clear_last()
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@339224 c90b9560-bf6c-de11-be94-00142212c4b1
2016-05-24 13:21:22 +00:00
Adam Harvey
8ae33d5f94 Slightly tinker with the description of error_clear_last().
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@337880 c90b9560-bf6c-de11-be94-00142212c4b1
2015-09-21 12:17:54 +00:00
Christoph Michael Becker
86da9d9501 PHP7 update (contributed by jhdxr)
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@337661 c90b9560-bf6c-de11-be94-00142212c4b1
2015-08-28 12:39:57 +00:00