Forum und email

xml_set_unparsed_entity_decl_handler

(PHP 4, PHP 5)

xml_set_unparsed_entity_decl_handler — Ορίζει έναν αμεταγλώττιστο entity declaration handler

Περιγραφή

bool xml_set_unparsed_entity_decl_handler ( resource $parser , callback $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 πρέπει να δεχθεί έξι παραμέτρους:

handler ( resource $parser , string $entity_name , string $base , string $system_id , string $public_id , string $notation_name )
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 που περιέχει μια αναφορά σε ένα αντικείμενο και ένα όνομα μεθόδου μπορεί να δοθεί.