(PHP 3 >= 3.0.6, PHP 4, PHP 5)
xml_set_external_entity_ref_handler -- ορίζει έναν external entity reference handlerΟρίζει τη συνάρτηση για τον external entity reference handler για τον XML parser parser. Ο handler είναι ένα string που περιέχει το όνομα μιας συνάρτησης που πρέπει να υπάρχει όταν η xml_parse() καλείται ως parser.
Η συνάρτηση που ονομάζεται από τον handler πρέπει να δέχεται
πέντε παραμέτρους, και πρέπει να επιστρέφει μια ακέραια τιμή. Αν η τιμή
που επιστρέφεται από τον handler είναι FALSE (το οποίο θα είναι αν δεν
επιστραφεί καμία τιμή), ο XML parser θα σταματήσει να μεταγλωττίζει και η
xml_get_error_code() θα επιστρέψει XML_ERROR_EXTERNAL_ENTITY_HANDLING.
handler ( resource parser, string open_entity_names, string base, string system_id, string public_id )
Η πρώτη παράμετρος, parser, είναι μια αναφορά στον XML parser που καλεί τον handler.
Η δεύτερη παράμετρος, open_entity_names, είναι μια λίστα ονομάτων από οντότητες που διαχωρίζεται με κενά και οι οποίες οντότητες είναι ανοικτές για τη μεταγλώττιση αυτής της οντότητας (συμπεριλαμβάνεται το όνομα της οντότητας που αναφέρεται).
Αυτή είναι η βάση για να πάρουμε τον identifier του συστήματος (system_id) από μια εξωτερική entity. Προς το παρόν αυτή η παράμετρος θα ορίζεται πάντα ίση με ένα κενό string.
Η τέταρτη παράμετρος, system_id, είναι ο identifier του συστήματος όπως έχει οριστεί στη δήλωση της entity.
Η πέμπτη παράμετρος, public_id, είναι ο public identifier όπως ορίζεται στη δήλωση της entity, ή ένα κενό string αν δεν έχει προσδιοριστεί κάτι άλλο. Τα κενά στον public identifier θα έχουν κανονικοποιηθεί όπως απαιτεί το XML spec.
Αν μια συνάρτηση handler οριστεί ίση με ένα κενό string, ή FALSE, ο handler υπό αμφισβήτηση απενεργοποιείται.
TRUE επιστρέφεται αν ο handler έχει οριστεί, FALSE αν ο parser δεν είναι parser.
Óçìåßùóç: Αντί για ένα όνομα συνάρτησης, ένα array που περιέχει μια αναφορά σε ένα αντικείμενο και ένα όνομα μεθόδου μπορεί να δοθεί.