xml_set_unparsed_entity_decl_handler
(PHP 4, PHP 5)
xml_set_unparsed_entity_decl_handler — Ορίζει έναν αμεταγλώττιστο entity declaration handler
Περιγραφή
Ορίζει τη συνάρτηση του αμεταγλώττιστου entity declaration handler για τον XML parser parser . Ο handler είναι ένα string που περιέχει το όνομα της συνάρτησης που πρέπει να υπάρχει όταν η xml_parse() καλείται για τον parser .
Αυτός ο handler θα κληθεί αν ο XML parser συνατήσει μια external entity declaration με μια NDATA δήλωση, όπως η ακόλουθη :
<!ENTITY <parameter>name</parameter> {<parameter>publicId</parameter> | <parameter>systemId</parameter>} NDATA <parameter>notationName</parameter>
Δείτε το » τμήμα 4.2.2 την XML 1.0 spec για ορισμό της σημείωσης που δηλώνονται external entities.
Αυτή η συνάρτηση που ονομάζεται από τον handler πρέπει να δεχθεί έξι παραμέτρους:
- parser
- Η πρώτη παράμετρος, parser, είναι μια αναφορά στον XML parser που καλεί τον handler.
- entity_name
- Το όνομα της οντότητας που πρόκειται να οριστεί.
- base
- Αυτό είναι η βάση για εύρεση του identifier του συστήματος (systemId ) μιας εξωτερικής οντότητας. Προς το παρόν αυτή η παράμετρος θα είναι πάντα ορισμένη και ίση με ένα κενό string.
- system_id
- Είναι ο identifier του συστήματος για μια εξωτερική οντότητα.
- public_id
- ο Public identifier για την εξωτερική οντότητα.
- notation_name
- Το όνομα του notation αυτής της οντότητας (δείτε το xml_set_notation_decl_handler()).
Αν μια συνάρτηση του handler οριστεί ίση με ένα κενό string, ή FALSE, ο handler υπό αμφισβήτηση απενεργοποιείται.
TRUE επιστρέφεται αν ο handler έχει οριστεί, FALSE αν ο parser δεν είναι parser.
Note: Αντί για ένα όνομα συνάρτησης, ένα array που περιέχει μια αναφορά σε ένα αντικείμενο και ένα όνομα μεθόδου μπορεί να δοθεί.