Download the PHP package benmorel/xml-streamer without Composer
On this page you can find all versions of the php package benmorel/xml-streamer. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package xml-streamer
XML Streamer
Stream large XML files as individual DOM elements with low memory consumption.
Installation
This library is installable via Composer:
Requirements
This library requires:
These extensions are enabled by default, and should be available in most PHP environments.
Project status & release process
This library is under development.
The current releases are numbered 0.x.y. When a non-breaking change is introduced (adding new methods, optimizing
existing code, etc.), y is incremented.
When a breaking change is introduced, a new 0.x version cycle is always started.
It is therefore safe to lock your project to a given release cycle, such as 0.5.*.
If you need to upgrade to a newer release cycle, check the release history
for a list of changes introduced by each further 0.x.0 version.
Quickstart
Let's say you have a product feed containing a list of one million products, in the following format:
To read it product by product, you instantiate an XMLStreamer with the path to a <product> element:
Any element in the document that does not match this path will be ignored.
You can then proceed to streaming the file with a generator, that will yield a DOMElement object for each <product>:
Querying with SimpleXML
If you prefer to work with SimpleXML, you can use simplexml_import_dom(). SimpleXML requires that you wrap your element in a DOMDocument before importing it:
This requires the SimpleXML extension, which is enabled by default.
Return value
After all elements have been processed, the generator returns the number of streamed elements:
Configuration options
Limiting the number of elements
If you need to get just a preview of the XML file, you can set the maximum number of elements to stream:
With this configuration, XMLStreamer would yield at most 10 elements, and ignore further entries.
Configuring the encoding
The encoding of the source file is automatically read from the XML declaration:
If your XML file is missing the encoding, you can specify it manually:
Note that this only specifies the input file encoding. The DOMElement output is always UTF-8.
Error handling
If an error occurs at any point (error opening or reading the file, malformed document), an XMLReaderException is thrown.
Note that the streaming may have already been started when the exception is thrown, so the generator may have already yielded a number of elements.
All versions of xml-streamer with dependencies
ext-dom Version *
ext-xmlreader Version *