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

165 Commits

Author SHA1 Message Date
Tim Düsterhus
b47e4bea19 xml: Remove xml_parser_free() from all examples (#4942) 2025-10-19 20:10:00 +02:00
Larry Garfield
00a8ae0c87 Mark xml_parser_free as deprecated. (#4892)
* Mark xml_parser_free as deprecated.

* Flesh out deprecation markers further.

* Add formal warning.

* Remove redundant text.

Co-authored-by: Tim Düsterhus <timwolla@googlemail.com>

---------

Co-authored-by: Tim Düsterhus <timwolla@googlemail.com>
2025-10-04 10:41:53 -05:00
Tim Düsterhus
ce98b568f8 Add &warn.deprecated.function-*; to all deprecated functions 2025-10-04 16:28:55 +02:00
Tim Düsterhus
30eb91e639 Update deprecation information in versions.xml 2025-10-04 16:21:06 +02:00
Tim Düsterhus
42d5fb01e0 Update function attributes
Generated with:

     build/gen_stub.php --replace-methodsynopses **.stub.php ../phpdoc/en/

And then manually picked the changes.
2025-10-04 16:04:02 +02:00
Derick Rethans
802374deda Add new XML parser example that uses a class 2025-03-06 14:36:30 +00:00
Derick Rethans
c1f37a6c27 Mark oop5 and xml* categories as 'interactive' (with exceptions) and use 'examples/' dir for XML example files so they (will) work with WASM 2025-03-06 14:35:36 +00:00
Derick Rethans
d6f54016d6 Fixed examples, and made some self-contained 2025-03-06 14:33:15 +00:00
Máté Kocsis
18aa2012f6 Synchronize manual with stubs for PHP 8.4 - part 8 (#4227)
Co-authored-by: Gina Peter Banyard <girgias@php.net>
2024-12-03 20:15:59 +01:00
Máté Kocsis
9b1673cf11 Mark deprecated functions with the #[\Deprecated] attribute (#4161) 2024-11-27 20:38:45 +01:00
Gina Peter Banyard
9cd8eb0f11 PHP 8.4: xml_set_*() deprecations and changes (#4067) 2024-11-14 21:18:36 +00:00
Niels Dossche
9acfa18973 Document XML_OPTION_PARSE_HUGE (#3899)
* Document XML_OPTION_PARSE_HUGE

* Address review comments
2024-10-23 18:17:53 +02:00
haszi
765b2d6eec Remove empty configuration pages (#3538)
Co-authored-by: haszi <haszika80@gmail.com>
2024-07-09 22:24:55 +01:00
divinity76
ad323a863f may also return "Unknown" if no description was found (#3436)
see

php -r 'const XML_NS_ERR_UNDEFINED_NAMESPACE = 201; var_dump(xml_error_string(XML_NS_ERR_UNDEFINED_NAMESPACE));'
string(7) "Unknown"
2024-06-15 21:04:39 +02:00
Gina Peter Banyard
4d17b7b494 [skip-revcheck] Convert class markup to be compatible with DocBook 5.2
Closes GH-3415
2024-06-14 17:04:53 +01:00
George Peter Banyard
5a14f904d2 Overhaul XML handler docs (#2832) 2023-10-05 00:29:27 +01:00
Niels Dossche
9fb00a4cf8 Corrections to xml_parser_[gs]et_option (#2777) 2023-09-20 22:23:59 +01:00
Máté Kocsis
5e9500ddad [skip-revcheck] Syncronize predefined constants with stubs - part 1 (#2739)
Preparation commit for syncing constants with stub.

This reformats the page, which is mainly just whitespace changes.
2023-09-04 23:37:50 +01:00
Máté Kocsis
14767af0f0 Use new class synopsis markup (#2611)
Follow-up on https://github.com/php/phd/pull/77
2023-08-30 12:28:30 +01:00
Alexandre Daubois
98b4495458 Fix GH-2233: Improve xml_parser_get/set_option parameters section (#2630) 2023-08-01 15:01:16 +01:00
Máté Kocsis
f781803449 Narrow bool return types to true when possible (#2458) 2023-05-07 22:32:58 +02:00
othercorey
7b841d339c Drop xml_get_error_code() return false description
Closes GH-2213.
2023-01-17 13:15:50 +01:00
othercorey
a34ba2aef0 Drop xml_get_current_line_number() return false description
Closes GH-2212.
2023-01-17 13:14:52 +01:00
othercorey
462e616265 Drop xml_get_current_column_number() return false description
Closes GH-2211.
2023-01-17 13:14:01 +01:00
othercorey
5dc10a2e57 Drop xml_get_current_byte_index() return false description
Closes GH-2210.
2023-01-17 13:12:58 +01:00
Máté Kocsis
adf11d8d64 Revert "Add documentation for default constructors - part 1 (#2089)" (#2121) 2022-12-28 08:50:09 +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
Máté Kocsis
4b8dfa8d22 Fix casing of XMLParser class name (#1795) 2022-09-02 18:02:37 +02:00
othercorey
e700973701 Fix return null description for xml_error_string()
Closes GH-1685.
2022-07-08 11:28:13 +02:00
Christoph M. Becker
f5992156e6 Fix XMLParser example for more recent PHP versions (#1662)
The example uses the `$parser` as array index, but that implicit
conversion to integer already raises a notice as of PHP 7.0.0, and
outright fails as of PHP 8.0.0, since the `$parser` is an object now.

Since there doesn't appear a good reason for `$depth` to be an array
which supports different parsers, we change it to an integer, what also
simplifies the example.

This basically integrates user note 127199.
2022-07-01 15:12:48 -05: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
Kamil Tekiela
52dc204a77 Add note about NOP code
Closes GH-933.
2021-09-14 15:09:52 +02:00
Sergey Panteleev
8cdc6621f9 Remove PHP 5, 7 references (#563)
- array functions
- datetime functions
- mbstring functions
- strings functions
- var functions
- xml functions
- json functions
2021-05-16 22:07:40 +03:00
thinkverse
4dcf5a9f13 Fix xml_get_current_byte_index notes section before changelog 2021-04-30 19:14:49 +01:00
thinkverse
0d0c319c7d Fix xml_set_default_handler return values section out-of-order 2021-04-30 19:14:49 +01:00
Sergey Panteleev
f9c4a68ef4 Removed references to PHP 5, PHP 7.0 (#548) 2021-04-26 11:46:55 +03:00
Rowan Tommins
4138897b12 Remove or rewrite examples using implode("", file(...)) (#523)
This is a weirdly inefficient way of getting a file's content into
a string, and I'm not sure why anyone would think it was a good
idea.
2021-04-12 22:33:56 +02:00
Yoshinari Takaoka
4bc958f807 Added PHP 8 into versions.xml for xml based on stubs.
Closes GH-390.
2021-01-24 15:43:41 +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
5f8047c12b Document new opaque classes which replace resources
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351932 c90b9560-bf6c-de11-be94-00142212c4b1
2020-12-06 22:11:40 +00:00
Christoph Michael Becker
3db49ee0a3 XmlParser has been renamed to XMLParser
Although class names are case-insensitive, we better document the proper case.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351792 c90b9560-bf6c-de11-be94-00142212c4b1
2020-11-30 16:03:37 +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
c0b9e812f0 Mark up constants as such
Maybe some day we'll get automatic linking of constants – one may dream.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351473 c90b9560-bf6c-de11-be94-00142212c4b1
2020-11-21 16:55:20 +00:00
Christoph Michael Becker
a8f6a0f119 XML parsers are objects as of PHP 8.0.0
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351472 c90b9560-bf6c-de11-be94-00142212c4b1
2020-11-21 16:53:39 +00:00
Christoph Michael Becker
5ce1caaf99 Generate xml methodsynopses based on stubs
Based on a patch contributed by Máté Kocsis <kocsismate@woohoolabs.com>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351469 c90b9560-bf6c-de11-be94-00142212c4b1
2020-11-21 14:06:31 +00:00
Christoph Michael Becker
b95d28e6ec Fix return types
Functions which return false on failure should state that in their
signature as well.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351135 c90b9560-bf6c-de11-be94-00142212c4b1
2020-11-02 15:52:35 +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