InstructionProcessor
in
Provide an processor to handle embedded instructions.
XML defines a mechanism for inserting instructions (like PHP) into a document. These are called "Processor Instructions." The HTML5 parser provides an opportunity to handle these processor instructions during the tree-building phase (before the DOM is constructed), which makes it possible to alter the document as it is being created.
One could, for example, use this mechanism to execute well-formed PHP code embedded inside of an HTML5 document.
Table of Contents
Methods
- process() : DOMElement
- Process an individual processing instruction.
Methods
process()
Process an individual processing instruction.
public
process(DOMElement $element, string $name, string $data) : DOMElement
The process() function is responsible for doing the following:
- Determining whether $name is an instruction type it can handle.
- Determining what to do with the data passed in.
- Making any subsequent modifications to the DOM by modifying the DOMElement or its attached DOM tree.
Parameters
- $element : DOMElement
-
The parent element for the current processing instruction.
- $name : string
-
The instruction's name. E.g.
<?phphas the namephp. - $data : string
-
All of the data between the opening and closing PI marks.
Return values
DOMElement —The element that should be considered "Current". This may just be the element passed in, but if the processor added more elements, it may choose to reset the current element to one of the elements it created. (When in doubt, return the element passed in.)