PHP 8.3.4 Released!

xml_parser_create

(PHP 4, PHP 5, PHP 7, PHP 8)

xml_parser_createXML パーサを作成する

説明

xml_parser_create(?string $encoding = null): XMLParser

xml_parser_create() は新しい XML パーサを作成し、 他の XML 関数が使用する XMLParser のインスタンスを返します。

パラメータ

encoding

入力のエンコーディングは 自動判定されるので、encoding パラメータは 出力のエンコーディングのみを指定することになります。 もし空の文字列が渡された場合、先頭の 3 あるいは 4 バイトの内容をもとに パーサがエンコーディングの判別を試みます。 ではデフォルトの出力文字セットは UTF-8 です。 サポートされるエンコーディングは ISO-8859-1UTF-8 および US-ASCII です。

戻り値

新しい XMLParser のインスタンスを返します。

変更履歴

バージョン 説明
8.0.0 この関数は XMLParser のインスタンスを返すようになりました。 これより前のバージョンでは、リソースが返され、失敗した場合は false が返っていました。
8.0.0 encoding は、nullable になりました。

参考

add a note

User Contributed Notes 7 notes

up
12
marek995 at seznam dot cz
13 years ago
I created a function, which combines xml_paresr_create and all functions around.

<?php
function html_parse($file)
{
$array = str_split($file, 1);
$count = false;
$text = "";
$end = false;
foreach(
$array as $temp)
{
switch(
$temp)
{
case
"<":
between($text);
$text = "";
$count = true;
$end = false;
break;
case
">":
if(
$end == true) {end_tag($text);}
else {
start_tag($text);}
$text = "";
break;
case
"/":
if(
$count == true) {$end = true;}
else {
$text = $text . "/";}
break;
default:
$count = false;
$text = $text . $temp;
}
}
}
?>
The input value is a string.
It calls functions start_tag() , between() and end_tag() just like the original xml parser.

But it has a few differences:
- It does NOT check the code. Just resends values to that three functions, no matter, if they are right
- It works with parameters. For example: from tag <sth b="42"> sends sth b="42"
- It works wit diacritics. The original parser sometimes wrapped the text before the first diacritics appearance.
- Works with all encoding. If the input is UTF-8, the output will be UTF-8 too
- It works with strings. Not with file pointers.
- No "Reserved XML name" error
- No doctype needed
- It does not work with commentaries, notes, programming instructions etc. Just the tags

definition of the handling functions is:

<?php
function between($stuff) {}
?>

No other attributes
up
2
jcalvert at gmx dot net
19 years ago
To maintain compatibility between PHP4 and PHP5 you should always pass a string argument to this function. PHP4 autodetects the format of the input if you leave it out whereas PHP5 will assume the format to be ISO-8859-1 (and choke on the byte order marker of UTF-8 files).

Calling the function as <?php $res = xml_parser_create('') ?> will cause both versions of PHP to autodetect the format.
up
-1
bishop at php dot net
5 years ago
Internals has proposed[1] changing this extension from resource-based to object-based. When this change is made, xml_parser_create will return an object, not a resource. Application developers are encouraged to replace any checks for explicit success, like:

<?php
$res
= xml_parser_create(/*...*/);
if (!
is_resource($res)) {
// ...
}
?>

With a check for explicit failure:
<?php
$res
= xml_parser_create(/*...*/);
if (
false === $res) {
// ...
}

[
1]: https://marc.info/?l=php-internals&m=154998365013373&w=2
up
0
Tobbe
18 years ago
The above "XML to array" code does not work properly if you have several tags on the same level and with the same name, example:

<currenterrors>
<error>
<description>This is a real error...</description>
</error>
<error>
<description>This is a second error...</description>
</error>
<error>
<description>Lots of errors today...</description>
</error>
<error>
<description>This is the last error...</description>
</error>
</currenterrors>

It will then only display the first <error>-tag.
In this case you will need to number the tags automatically or maybe have several arrays for each new element.
up
0
php at stock-consulting dot com
19 years ago
Even though I passed "UTF-8" as encoding type PHP (Version 4.3.3) did *not* treat the input file as UTF-8. The input file was missing the BOM header bytes (which may indeed be omitted, according to RFC3629...but things are a bit unclear there. The RFC seems to make mere recommendations concering the BOM header). If you want to sure that PHP treats an UTF-8 encoded file correctly, make sure that it begins with the corresponding 3 byte BOM header (0xEF 0xBB 0xBF)
up
-7
Anonymous
17 years ago
I'd also recommend adding the option below
xml_parser_set_option($parser,XML_OPTION_SKIP_WHITE,1);
up
-9
juanhdv at NOSPAM dot divvol dot org
16 years ago
In PHP 5, when including in your xml file the definition '<?xml version="1.0" encoding="ISO-8859-1" ?>', I'd also recommend adding the option below:

xml_parser_set_option($xml_parser,XML_OPTION_TARGET_ENCODING, "ISO-8859-1").

It works fine!

If your enconding is 'UTF-8', just replace 'ISO-8859-1'.
To Top