Download the PHP package josemmo/uxml without Composer
On this page you can find all versions of the php package josemmo/uxml. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package uxml
Short Description Uncomplicated XML manipulation library with a clean and concise syntax
License MIT
Homepage https://github.com/josemmo/uxml
Informations about the package uxml
Uncomplicated XML
UXML is an extremely simple PHP library for manipulating XML documents with ease while keeping overhead to a bare minimum.
It consist of just a single class which uses the PHP built-in DOMElement
and DOMDocument
classes under the hood.
Installation
Using Composer
Without Composer
Download source files from the GitHub repository:
Use the UXML class in your app:
FAQ
Why use this instead of sabre/xml or FluidXML?\ Both those options are great and if they fit your project you should definetely use them! However, in my case I needed something more lightweight to put on top of LibXML's DOM to provide an alternative syntax.
Is UXML compatible with DOMElement
?\
Yes, indeed! You can get the original DOMElement
instance from an UXML
object and vice versa.
I want UXML to do "X". Can you implement it?\ My main goal with this project is not to implement all possible behaviors in the XML specification, you can use the DOM or SimpleXML libraries for that.
Usage
Create a new document
UXML does not distinguish between XML documents (DOMDocument
) and elements (DOMElement
). Instead, you can create a new document like so:
You can also wrap an already existing DOMElement
:
Load an XML document from source
By loading an XML string, UXML will return the root element of the document tree:
Add elements to a node
When adding an element, UXML will return a reference to the newly created element:
You can also define a value:
And even attributes or namespaces:
Element chaining
Because with every element insertion a reference to the new element is returned, you can chain multiple of these calls to create a tree:
Export XML source
Besides casting UXML
objects to a string
, there is a method for exporting the XML source of an element and its children:
By default, exported strings include an XML declaration (except when casting UXML
instances to a string
).
Find XML elements
UXML allows you to use XPath 1.0 queries to get a particular element from a document:
Or even multiple elements:
Note all XPath queries are relative to current element:
Remove XML elements
Elements can be removed from the XML tree by calling the remove()
method on them.
After an element is removed, it becomes unusable:
Namespaces
Namespaces are assigned in the same way as other attributes:
However, when querying elements, the prefix defined in the document may not be the one you are expecting:
To fix this, you can make use of clark notation inside the XPath query:
Advanced XML manipulation
For any other document manipulation outside the scope of this library, you can always interact with the DOMElement
instance:
All versions of uxml with dependencies
lib-libxml Version *