xml_set_external_entity_ref_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.

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.

Note: Αντί για ένα όνομα συνάρτησης, ένα array που περιέχει μια αναφορά σε ένα αντικείμενο και ένα όνομα μεθόδου μπορεί να δοθεί.