(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
Η πρώτη παράμετρος, parser, είναι μια αναφορά στον XML parser που καλεί τον handler.
open_entity_names
Η δεύτερη παράμετρος, open_entity_names
, είναι μια
λίστα ονομάτων από οντότητες που διαχωρίζεται με κενά και οι οποίες οντότητες είναι ανοικτές
για τη μεταγλώττιση αυτής της οντότητας (συμπεριλαμβάνεται το όνομα της οντότητας
που αναφέρεται).
base
Αυτή είναι η βάση για να πάρουμε τον identifier του συστήματος
(system_id
) από μια εξωτερική entity. Προς το παρόν
αυτή η παράμετρος θα ορίζεται πάντα ίση με ένα κενό string.
system_id
Η τέταρτη παράμετρος, system_id
, είναι ο
identifier του συστήματος όπως έχει οριστεί στη δήλωση της entity.
public_id
Η πέμπτη παράμετρος, public_id
, είναι ο
public identifier όπως ορίζεται στη δήλωση της entity, ή
ένα κενό string αν δεν έχει προσδιοριστεί κάτι άλλο. Τα κενά στον
public identifier θα έχουν κανονικοποιηθεί όπως απαιτεί το
XML spec.
Αν μια συνάρτηση handler οριστεί ίση με ένα κενό string, ή FALSE, ο handler υπό αμφισβήτηση απενεργοποιείται.
TRUE επιστρέφεται αν ο handler έχει οριστεί, FALSE αν ο
parser
δεν είναι parser.
Óçìåßùóç: Αντί για ένα όνομα συνάρτησης, ένα array που περιέχει μια αναφορά σε ένα αντικείμενο και ένα όνομα μεθόδου μπορεί να δοθεί.