Weave Code
Fluidxml Laravel Package
servo/fluidxml
FluidXML is a lightweight PHP library for creating, querying, and editing XML with a concise, fluent, jQuery-like API. Chain readable methods, target nodes with XPath selectors, handle namespaces, and cut boilerplate in XML-heavy PHP and Laravel applications.
Concise and fluent XML manipulation library
Frequently asked questions about Fluidxml
- What is FluidXML and what can I use it for in a Laravel app?
- FluidXML is a lightweight, framework-agnostic PHP library that wraps DOMDocument with a fluent, jQuery-like API for building, querying, and editing XML. In Laravel you can use it in service classes, jobs, and artisan commands for tasks like generating sitemaps and RSS feeds, building third-party API or SOAP payloads, transforming config XML, and querying XML responses. It has no Laravel coupling, so it belongs in your domain or service layer rather than controllers.
- How do I install FluidXML in a Laravel project?
- Install it with Composer using composer require servo/fluidxml. The library has zero dependencies beyond PHP and ext-dom, so there are no package conflicts to manage. Pin an explicit constraint such as ^1.0 and verify ext-dom in CI.
- Does FluidXML have a Laravel service provider or facade?
- No. FluidXML is framework-agnostic and ships no first-party service provider, facade, config publishing, or queue-aware integration. The recommended pattern is to define your own XmlBuilder or XmlParser interface, implement it with FluidXML, and bind it in a Laravel service provider. That gives you dependency injection, testability, and a one-file swap if you replace the library later.
- Which Laravel and PHP versions does FluidXML support?
- FluidXML is pure PHP and framework-agnostic, so it fits Laravel 9 through 12 on PHP 8.1 and newer. There are no Laravel version constraints to conflict with, so upgrade risk comes mainly from PHP minor-version drift. Include FluidXML exercises in your PHP upgrade test plan and verify ext-dom in CI.
- How do I run XPath queries with FluidXML?
- FluidXML exposes XPath queries through intuitive, chainable methods that return result sets you can further manipulate. You select nodes with an XPath expression and then apply edits or reads fluently, without raw DOMXPath boilerplate. For complex documents, combine XPath selectors with namespace registration so prefixes resolve correctly.
- Does FluidXML support XML namespaces?
- Yes. FluidXML includes namespace support for complex documents, letting you register prefixes and target namespaced nodes with XPath. This is important for SOAP envelopes, feeds, and standards-based payloads where elements are namespaced. Register namespaces explicitly rather than relying on default prefixes.
- Is FluidXML safe for parsing untrusted XML?
- XML parsing is a classic XXE and billion-laughs vector, so treat any ingestion path as security-sensitive. PHP 8 disables external entity loading by default, but you must verify libxml flags centrally, enforce size limits, and validate against a schema before parsing untrusted input. Consider a hardened XML wrapper regardless of which library you use.
- What are FluidXML's performance limits for large XML files?
- FluidXML is DOM-backed, so it loads the entire document into memory. It is fine for sitemaps, feeds, SOAP or REST payload construction, and config files, but unsuitable for multi-hundred-megabyte documents. For high-volume ingestion, use a streaming parser such as XMLReader and do not force FluidXML there.
- How do I test and pin FluidXML in a Laravel production app?
- Because there is no versioned deprecation policy, pin an explicit Composer constraint like ^1.0 and verify ext-dom and your PHP matrix in CI. Unit-test your adapter interface with representative XML fixtures, and schema- or byte-diff outputs when migrating existing code. Keep XML hardening flags centralized and include FluidXML exercises in PHP upgrade tests.
- Is FluidXML a good alternative to SimpleXML or raw DOMDocument, and is it maintained?
- It improves readability over raw DOMDocument and is more expressive than SimpleXMLElement for building and editing XML. However, it has around 458 stars, zero dependents, a single maintainer, and its last release was in November 2023, so maintenance risk is high. If you adopt it, wrap it behind an internal interface and be ready to vendor or fork it.
Weaver
How can I help you explore Laravel packages today?