Documentation

class.simple_html_dom.php

Website: http://sourceforge.net/projects/simplehtmldom/ Additional projects that may be used: http://sourceforge.net/projects/debugobject/ Acknowledge: Jose Solorzano (https://sourceforge.net/projects/php-html/) Contributions by: Yousuke Kumakura (Attribute filters) Vadim Voituk (Negative indexes supports of "find" method) Antcs (Constructor with automatically load contents either text or file/url)

all affected sections have comments starting with "PaperG"

Paperg - Added case insensitive testing of the value of the selector. Paperg - Added tag_start for the starting index of tags - NOTE: This works but not accurately. This tag_start gets counted AFTER \r\n have been crushed out, and after the remove_noice calls so it will not reflect the REAL position of the tag in the source, it will almost always be smaller by some amount. We use this to determine how far into the file the tag in question is. This "percentage will never be accurate as the $dom->size is the "real" number of bytes the dom was created from. but for most purposes, it's a really good estimation. Paperg - Added the forceTagsClosed to the dom constructor. Forcing tags closed is great for malformed html, but it CAN lead to parsing errors. Allow the user to tell us how much they trust the html. Paperg add the text and plaintext to the selectors for the find syntax. plaintext implies text in the innertext of a node. text implies that the tag is a text node. This allows for us to find tags based on the text they contain. Create find_ancestor_tag to see if a tag is - at any level - inside of another specific tag. Paperg: added parse_charset so that we know about the character set of the source document. NOTE: If the user's system has a routine called get_last_retrieve_url_contents_content_type availalbe, we will assume it's returning the content-type header from the last transfer or curl_exec, and we will parse that and use it in preference to any other method of charset detection.

Found infinite loop in the case of broken html in restore_noise. Rewrote to protect from that. PaperG (John Schlick) Added get_display_size for "IMG" tags.

Licensed under The MIT License Redistributions of files must retain the above copyright notice.

Tags
author

S.C. Chen me578022@gmail.com

author

John Schlick

author

Rus Carroll

subpackage

simple_html_dom

Interfaces, Classes and Traits

simple_html_dom_node
simple html dom node PaperG - added ability for "find" routine to lowercase the value of the selector.
simple_html_dom
simple html dom parser Paperg - in the find routine: allow us to specify that we want case insensitive testing of the value of the selector.

Table of Contents

DEFAULT_BR_TEXT  = " "
DEFAULT_SPAN_TEXT  = " "
DEFAULT_TARGET_CHARSET  = 'UTF-8'
HDOM_INFO_BEGIN  = 0
HDOM_INFO_END  = 1
HDOM_INFO_ENDSPACE  = 7
HDOM_INFO_INNER  = 5
HDOM_INFO_OUTER  = 6
HDOM_INFO_QUOTE  = 2
HDOM_INFO_SPACE  = 3
HDOM_INFO_TEXT  = 4
HDOM_QUOTE_DOUBLE  = 0
HDOM_QUOTE_NO  = 3
HDOM_QUOTE_SINGLE  = 1
HDOM_SMARTY_AS_TEXT  = 1
Contents between curly braces "{" and "}" are interpreted as text
HDOM_TYPE_COMMENT  = 2
HDOM_TYPE_ELEMENT  = 1
All of the Defines for the classes below.
HDOM_TYPE_ENDTAG  = 4
HDOM_TYPE_ROOT  = 5
HDOM_TYPE_TEXT  = 3
HDOM_TYPE_UNKNOWN  = 6
MAX_FILE_SIZE  = 600000
file_get_html()  : mixed
str_get_html()  : mixed
dump_html_tree()  : mixed

Constants

HDOM_SMARTY_AS_TEXT

Contents between curly braces "{" and "}" are interpreted as text

public mixed HDOM_SMARTY_AS_TEXT = 1

Functions

file_get_html()

file_get_html(mixed $url[, mixed $use_include_path = false ][, mixed $context = null ], mixed $offset[, mixed $maxLen = -1 ][, mixed $lowercase = true ][, mixed $forceTagsClosed = true ][, mixed $target_charset = DEFAULT_TARGET_CHARSET ][, mixed $stripRN = true ][, mixed $defaultBRText = DEFAULT_BR_TEXT ][, mixed $defaultSpanText = DEFAULT_SPAN_TEXT ]) : mixed
Parameters
$url : mixed
$use_include_path : mixed = false
$context : mixed = null
$offset : mixed
$maxLen : mixed = -1
$lowercase : mixed = true
$forceTagsClosed : mixed = true
$target_charset : mixed = DEFAULT_TARGET_CHARSET
$stripRN : mixed = true
$defaultBRText : mixed = DEFAULT_BR_TEXT
$defaultSpanText : mixed = DEFAULT_SPAN_TEXT
Return values
mixed

str_get_html()

str_get_html(mixed $str[, mixed $lowercase = true ][, mixed $forceTagsClosed = true ][, mixed $target_charset = DEFAULT_TARGET_CHARSET ][, mixed $stripRN = true ][, mixed $defaultBRText = DEFAULT_BR_TEXT ][, mixed $defaultSpanText = DEFAULT_SPAN_TEXT ]) : mixed
Parameters
$str : mixed
$lowercase : mixed = true
$forceTagsClosed : mixed = true
$target_charset : mixed = DEFAULT_TARGET_CHARSET
$stripRN : mixed = true
$defaultBRText : mixed = DEFAULT_BR_TEXT
$defaultSpanText : mixed = DEFAULT_SPAN_TEXT
Return values
mixed

dump_html_tree()

dump_html_tree(mixed $node[, mixed $show_attr = true ], mixed $deep) : mixed
Parameters
$node : mixed
$show_attr : mixed = true
$deep : mixed
Return values
mixed

Search results