AtomParser::parse()

Compatibility

Present in every tracked release (6.7.7 to 7.1.0), and compiles on PHP 7.4 through 8.6-dev.

Performance profile

How much work a call to AtomParser::parse() does, and what it touches: the algorithmic scaling, the Zend instruction count per call across PHP versions, the hooks it hands control to, and the core code that calls it. Measured from the compiled opcodes, not a stopwatch, so every number is identical on any machine running the same PHP version, and every function in core is ranked by cost.

Cost class

Heavy

Reads or writes the filesystem via fopen().

Scaling

Scales with input

The body loops, so the work grows with how much data it finds.

Instructions

86–122

Executed per call on PHP 8.5, depending on the branch taken. The body compiles to 122.

Plugin surface

None

Nothing here hands control to plugin code.

Called by

0

Nothing in core calls this; the cost is only what you spend yourself.

What it touches

• filesystemfilesystem accessfopen()called directly

Further down the call graph this can also reach hook, query, option, cache, serialize and transient. Those are the worst case, several calls deep and usually down an error path, not what a normal call pays.

What one call costs · 2 distinct outcomes

One number would be a lie: the work depends on which branch runs. These are every distinct cost AtomParser::parse() can have, taken from its control-flow graph on PHP 8.5.

Uses · 1

• __()Retrieves the translation of $text.

Source code

View on Trac ↗View on GitHub ↗

148    function parse() {149 150        set_error_handler(array(&$this, 'error_handler'));151 152        array_unshift($this->ns_contexts, array());153 154        if ( ! function_exists( 'xml_parser_create_ns' ) ) {155        	trigger_error( __( "PHP's XML extension is not available. Please contact your hosting provider to enable PHP's XML extension." ) );156        	return false;157        }158 159        $parser = xml_parser_create_ns();160        xml_set_element_handler($parser, array($this, "start_element"), array($this, "end_element"));161        xml_parser_set_option($parser,XML_OPTION_CASE_FOLDING,0);162        xml_parser_set_option($parser,XML_OPTION_SKIP_WHITE,0);163        xml_set_character_data_handler($parser, array($this, "cdata"));164        xml_set_default_handler($parser, array($this, "_default"));165        xml_set_start_namespace_decl_handler($parser, array($this, "start_ns"));166        xml_set_end_namespace_decl_handler($parser, array($this, "end_ns"));167 168        $this->content = '';169 170        $ret = true;171 172        $fp = fopen($this->FILE, "r");173        while ($data = fread($fp, 4096)) {174            if($this->debug) $this->content .= $data;175 176            if(!xml_parse($parser, $data, feof($fp))) {177                /* translators: 1: Error message, 2: Line number. */178                trigger_error(sprintf(__('XML Error: %1$s at line %2$s')."\n",179                    xml_error_string(xml_get_error_code($parser)),180                    xml_get_current_line_number($parser)));181                $ret = false;182                break;183            }184        }185        fclose($fp);186 187        if (PHP_VERSION_ID < 80000) { // xml_parser_free() has no effect as of PHP 8.0.188            xml_parser_free($parser);189        }190 191        unset($parser);192 193        restore_error_handler();194 195        return $ret;196    }

Changelog

Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.0.4 tag, from src/wp-includes/atomlib.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.