PHP xml_set_unparsed_entity_decl_handler XML 解析器函数

  • 定义和用法

    xml_set_unparsed_entity_decl_handler - 设置未解析的实体声明处理程序
  • 版本支持

    PHP4 PHP5 PHP7
    支持 支持 支持
  • 语法

    xml_set_unparsed_entity_decl_handler ( resource $parser , callable $handler )
    
    为XML解析器解析器设置未解析的实体声明处理函数。如果XML解析器遇到带有NDATA声明的外部实体声明,则将调用该处理程序,如下所示:
    <!ENTITY <parameter>name</parameter> {<parameter>publicId</parameter> | <parameter>systemId</parameter>}
            NDATA <parameter>notationName</parameter>
    
    请参阅XML 1.0规范的»4.2.2节,以获取已声明的外部实体表示法的定义。
  • 参数

    参数 必需的 描述
    parser 对XML解析器的引用,用于设置未解析的实体声明处理程序函数。
    handler handler是一个字符串,其中包含在解析器调用xml_parse()时必须存在的函数的名称。由处理程序命名的函数必须接受六个参数: handler ( resource $parser , string $entity_name , string $base , string $system_id , string $public_id , string $notation_name )
    • parser - 第一个参数解析器是对调用处理程序的XML解析器的引用。
    • entity_name - 即将定义的实体的名称。
    • base - 这是解析外部实体的系统标识符(systemId)的基础。当前,此参数将始终设置为空字符串。
    • system_id - 外部实体的系统标识符。
    • public_id - 外部实体的公共标识符。
    • notation_name - 该实体的表示法名称(请参见xml_set_notation_decl_handler())。
    如果将处理程序函数设置为空字符串或FALSE,则该处理程序将被禁用。
    注意:除了函数名,还可以提供包含对象引用和方法名的数组。
  • 返回值

    成功返回TRUE,失败返回FALSE。
  • 相关函数

    xml_set_end_namespace_decl_handler() - 设置结束命名空间声明处理程序