SimpleXML — Parsing XML in PHP

Also Known As

TL;DR

Explanation

SimpleXML represents an XML document as a PHP object where child elements are accessed as object properties and attributes as array keys. Accessing a missing element returns an empty SimpleXMLElement (not null), so boolean checks need care. SimpleXML is ideal for consuming simple XML APIs and configuration files. For namespace-aware XML, use children() and attributes() with the namespace URI. SimpleXML and DOMDocument are interoperable: simplexml_import_dom() and dom_import_simplexml() convert between them. For complex queries, convert to DOMDocument and use XPath. SimpleXML cannot handle very large files — it loads the entire document into memory.

Common Misconception

Why It Matters

Common Mistakes

• Not casting SimpleXMLElement to string/int when using values — concatenation and arithmetic on a SimpleXMLElement object can produce unexpected results.
• Using foreach on a potentially single-element result — SimpleXML returns a single SimpleXMLElement for one child and an iterable for multiple; always use foreach safely.
• Loading untrusted external XML with libxml_disable_entity_loader(false) — XML External Entity (XXE) attacks are possible if external entities are enabled.
• Ignoring namespace prefixes — xml:lang, atom:title and other namespaced attributes are invisible to property access; use attributes('ns', true) for namespace-aware access.

Code Examples

<?php
// ❌ Naive SimpleXML usage — wrong existence check, no error handling
$xml = simplexml_load_string($apiResponse);

if ($xml->error) { // Wrong — empty element is truthy!
    handleError();
}

// Forgetting to cast types
$count = $xml->results->count; // SimpleXMLElement, not int
for ($i = 0; $i < $count; $i++) { // May behave unexpectedly
    // ...
}

<?php
// ✅ Correct SimpleXML usage
libxml_use_internal_errors(true);
$xml = simplexml_load_string($apiResponse);

if ($xml === false) {
    $errors = libxml_get_errors();
    libxml_clear_errors();
    throw new RuntimeException('Invalid XML: ' . $errors[0]->message);
}

// Correct existence check
if (isset($xml->error)) {
    handleError((string) $xml->error->message);
}

// Always cast to PHP types
$count = (int) $xml->results->count;
$title = (string) $xml->title;

// Namespace-aware access
$ns = $xml->children('http://www.w3.org/2005/Atom');
foreach ($ns->entry as $entry) {
    echo (string) $entry->title;
}

References

• ↗ https://www.php.net/SimpleXML
• ↗ https://www.php.net/simplexml_load_string

Tags

Related Terms