PHP Класс SimpleBrowser, simpletest

@package SimpleTest
Показать файл Открыть проект Примеры использования класса

Открытые методы

Метод Описание
__construct ( ) Starts with a fresh browser with no cookie or any other state information.
addHeader ( string $header ) Adds a header to every fetch.
ageCookies ( integer $interval ) Ages the cookies by the specified time.
authenticate ( string $username, string $password ) : boolean Retries a request after setting the authentication for the current realm.
back ( ) : boolean Equivalent to hitting the back button on the browser.
clearFrameFocus ( ) Clears the frame focus. All frames will be searched for content.
click ( string $label ) : string/boolean Clicks a visible text item. Will first try buttons, then links and then images.
clickImage ( string $label, integer $x = 1, integer $y = 1, hash $additional = false ) : string/boolean Clicks the submit image by some kind of label.
clickImageById ( integer/string $id, integer $x = 1, integer $y = 1, hash $additional = false ) : string/boolean Clicks the submit image by ID attribute.
clickImageByName ( string $name, integer $x = 1, integer $y = 1, hash $additional = false ) : string/boolean Clicks the submit image by the name.
clickLink ( string $label, integer $index ) : boolean Follows a link by label.
clickLinkById ( string $id ) : string/boolean Follows a link by id attribute.
clickSubmit ( string $label = 'Submit', hash $additional = false ) : string/boolean Clicks the submit button by label. The owning form will be submitted by this.
clickSubmitById ( string $id, hash $additional = false ) : string/boolean Clicks the submit button by ID attribute of the button itself. The owning form will be submitted by this.
clickSubmitByName ( string $name, hash $additional = false ) : string/boolean Clicks the submit button by name attribute. The owning form will be submitted by this.
delete ( string/SimpleUrl $url, hash/SimpleFormEncoding $parameters = false ) : string Sends a DELETE request and fetches the response.
forward ( ) : boolean Equivalent to hitting the forward button on the browser.
get ( string/SimpleUrl $url, hash/SimpleFormEncoding $parameters = false ) : string Fetches the page content with a simple GET request.
getAuthentication ( ) : string Accessor for last Authentication type. Only valid straight after a challenge (401).
getBaseUrl ( ) : string Accessor for base URL of page if set via BASE tag
getContent ( ) : string Accessor for raw page information.
getContentAsText ( ) : string Accessor for plain text version of the page.
getCookieValue ( string $host, string $path, string $name ) : string Reads the most specific cookie value from the browser cookies.
getCurrentCookieValue ( string $name ) : string Reads the current cookies for the current URL.
getField ( string $label ) : string/boolean Accessor for a form element value within the page.
getFieldById ( string/integer $id ) : string/boolean Accessor for a form element value within the page.
getFieldByName ( string $name ) : string/boolean Accessor for a form element value within the page. Finds the first match.
getFrameFocus ( ) : integer/string/boolean Accessor for current frame focus. Will be false if no frame has focus.
getFrames ( ) : array Accessor for a breakdown of the frameset.
getHeaders ( ) : string Accessor for raw header information.
getLink ( string $label, integer $index ) : string/boolean Finds a URL by label. Will find the first link found with this link text by default, or a later one if an index is given. The match ignores case and white space issues.
getLinkById ( string $id ) : string/boolean Finds a link by id attribute.
getMimeType ( ) : string Accessor for current MIME type.
getRealm ( ) : string Accessor for last Authentication realm. Only valid straight after a challenge (401).
getRequest ( ) : string Accessor for raw bytes sent down the wire.
getResponseCode ( ) : integer Accessor for last response code.
getTitle ( ) : string Accessor for parsed title.
getTransportError ( ) : string Accessor for last error.
getUrl ( ) : string Accessor for current URL of page or frame if focused.
getUrls ( ) : array Accessor for a list of all links in current page.
head ( string/SimpleUrl $url, hash/SimpleHeadEncoding $parameters = false ) : boolean Fetches the page content with a HEAD request.
ignoreCookies ( ) Switches off cookie sending and recieving.
ignoreFrames ( ) Disables frames support.
isClickable ( string $label ) : boolean Tests to see if a click target exists.
isImage ( string $label ) : boolean Tests to see if an image exists with this title or alt text.
isSubmit ( string $label ) : boolean Tests to see if a submit button exists with this label.
post ( string/SimpleUrl $url, hash/SimpleFormEncoding $parameters = false, string $content_type = false ) : string Fetches the page content with a POST request.
put ( string/SimpleUrl $url, hash/SimpleFormEncoding $parameters = false, string $content_type = false ) : string Fetches the page content with a PUT request.
restart ( string/integer $date = false ) Removes expired and temporary cookies as if the browser was closed and re-opened.
retry ( ) : string/boolean Equivalent to hitting the retry button on the browser.
setConnectionTimeout ( integer $timeout ) Sets the socket timeout for opening a connection.
setCookie ( string $name, string $value, string $host = false, string $path = '/', string $expiry = false ) Sets an additional cookie.
setField ( string $label, string $value, $position = false ) : boolean Sets all form fields with that name.
setFieldById ( string/integer $id, string $value ) : boolean Sets all form fields with that id attribute.
setFieldByName ( string $name, string $value, $position = false ) : boolean Sets all form fields with that name. Will use label if one is available (not yet implemented).
setFrameFocus ( string $name ) : boolean Sets the focus by name.
setFrameFocusByIndex ( integer $choice ) : boolean Sets the focus by index. The integer index starts from 1.
setMaximumNestedFrames ( integer $max ) Sets the maximum number of nesting of framed pages within a framed page to prevent loops.
setMaximumRedirects ( integer $max ) Sets the maximum number of redirects before a page will be loaded anyway.
setParser ( $parser ) Override the default HTML parser, allowing parsers to be plugged in.
submitFormById ( string $id, $additional = false ) : string/boolean Submits a form by the ID.
useCookies ( ) Switches back on the cookie sending and recieving.
useFrames ( ) Enables frames support. Frames will be fetched from now on.
useProxy ( string $proxy, string $username = false, string $password = false ) Sets proxy to use on all requests for when testing from behind a firewall.

Защищенные методы

Метод Описание
buildPage ( SimpleHttpResponse $response ) : SimplePage Assembles the parsing machinery and actually parses a single page.
createHistory ( ) : SimpleBrowserHistory Creates a new empty history list.
createUserAgent ( ) : SimpleUserAgent Creates the underlying user agent.
fetch ( string/SimpleUrl $url, SimpleEncoding $encoding, integer $depth ) : SimplePage Fetches a page.
getParser ( ) : object Get the HTML parser to use. Can be overridden by setParser.
load ( SimpleUrl $url, SimpleEncoding $parameters ) : string Fetches a page or a single frame if that is the current focus.
loadFrame ( array $frames, string/SimpleUrl $url, SimpleFormEncoding $parameters ) : string Fetches a frame into the existing frameset replacing the original.
loadPage ( string/SimpleUrl $url, SimplePostEncoding $parameters ) : string Fetches a page and makes it the current page/frame.
parse ( SimpleHttpResponse $response, integer $depth ) : SimplePage Parses the raw content into a page.

Описание методов

__construct() публичный Метод

The exception is that a default proxy will be set up if specified in the options.
public __construct ( )

addHeader() публичный Метод

Adds a header to every fetch.
public addHeader ( string $header )
$header string Header line to add to every request until cleared.

ageCookies() публичный Метод

Ages the cookies by the specified time.
public ageCookies ( integer $interval )
$interval integer Amount in seconds.

authenticate() публичный Метод

Retries a request after setting the authentication for the current realm.
public authenticate ( string $username, string $password ) : boolean
$username string Username for realm.
$password string Password for realm.
Результат boolean True if successful fetch. Note that authentication may still have failed.

back() публичный Метод

The browser history is unchanged on failure. The page content is refetched as there is no concept of content caching in SimpleTest.
public back ( ) : boolean
Результат boolean True if history entry and fetch succeeded

buildPage() защищенный Метод

Frees all of the builder memory and so unjams the PHP memory management.
protected buildPage ( SimpleHttpResponse $response ) : SimplePage
$response SimpleHttpResponse Response from fetch.
Результат SimplePage Parsed top level page.

clearFrameFocus() публичный Метод

Clears the frame focus. All frames will be searched for content.
public clearFrameFocus ( )

click() публичный Метод

Clicks a visible text item. Will first try buttons, then links and then images.
public click ( string $label ) : string/boolean
$label string Visible text or alt text.
Результат string/boolean

clickImage() публичный Метод

Usually the alt tag or the nearest equivalent. The owning form will be submitted by this. Clicking outside of the boundary of the coordinates will result in a failure.
public clickImage ( string $label, integer $x = 1, integer $y = 1, hash $additional = false ) : string/boolean
$label string ID attribute of button.
$x integer X-coordinate of imaginary click.
$y integer Y-coordinate of imaginary click.
$additional hash Additional form data.
Результат string/boolean

clickImageById() публичный Метод

The owning form will be submitted by this. Clicking outside of the boundary of the coordinates will result in a failure.
public clickImageById ( integer/string $id, integer $x = 1, integer $y = 1, hash $additional = false ) : string/boolean
$id integer/string
$x integer X-coordinate of imaginary click.
$y integer Y-coordinate of imaginary click.
$additional hash Additional form data.
Результат string/boolean

clickImageByName() публичный Метод

Usually the alt tag or the nearest equivalent. The owning form will be submitted by this. Clicking outside of the boundary of the coordinates will result in a failure.
public clickImageByName ( string $name, integer $x = 1, integer $y = 1, hash $additional = false ) : string/boolean
$name string Name attribute of button.
$x integer X-coordinate of imaginary click.
$y integer Y-coordinate of imaginary click.
$additional hash Additional form data.
Результат string/boolean

clickLinkById() публичный Метод

Follows a link by id attribute.
public clickLinkById ( string $id ) : string/boolean
$id string ID attribute value.
Результат string/boolean

clickSubmit() публичный Метод

Clicks the submit button by label. The owning form will be submitted by this.
public clickSubmit ( string $label = 'Submit', hash $additional = false ) : string/boolean
$label string Button label. An unlabeled button can be triggered by 'Submit'.
$additional hash Additional form data.
Результат string/boolean

clickSubmitById() публичный Метод

Clicks the submit button by ID attribute of the button itself. The owning form will be submitted by this.
public clickSubmitById ( string $id, hash $additional = false ) : string/boolean
$id string Button ID.
$additional hash Additional form data.
Результат string/boolean

clickSubmitByName() публичный Метод

Clicks the submit button by name attribute. The owning form will be submitted by this.
public clickSubmitByName ( string $name, hash $additional = false ) : string/boolean
$name string Button name.
$additional hash Additional form data.
Результат string/boolean

createHistory() защищенный Метод

Creates a new empty history list.
protected createHistory ( ) : SimpleBrowserHistory
Результат SimpleBrowserHistory New list.

createUserAgent() защищенный Метод

Creates the underlying user agent.
protected createUserAgent ( ) : SimpleUserAgent
Результат SimpleUserAgent Content fetcher.

delete() публичный Метод

Sends a DELETE request and fetches the response.
public delete ( string/SimpleUrl $url, hash/SimpleFormEncoding $parameters = false ) : string
$url string/SimpleUrl
$parameters hash/SimpleFormEncoding
Результат string Content of page or false.

fetch() защищенный Метод

Jointly recursive with the parse() method as it descends a frameset.
protected fetch ( string/SimpleUrl $url, SimpleEncoding $encoding, integer $depth ) : SimplePage
$url string/SimpleUrl
$encoding SimpleEncoding GET/POST parameters.
$depth integer Nested frameset depth protection.
Результат SimplePage Parsed page.

forward() публичный Метод

The browser history is unchanged on failure. The page content is refetched as there is no concept of content caching in SimpleTest.
public forward ( ) : boolean
Результат boolean True if history entry and fetch succeeded

get() публичный Метод

Fetches the page content with a simple GET request.
public get ( string/SimpleUrl $url, hash/SimpleFormEncoding $parameters = false ) : string
$url string/SimpleUrl
$parameters hash/SimpleFormEncoding
Результат string Content of page or false.

getAuthentication() публичный Метод

Accessor for last Authentication type. Only valid straight after a challenge (401).
public getAuthentication ( ) : string
Результат string Description of challenge type.

getBaseUrl() публичный Метод

Accessor for base URL of page if set via BASE tag
public getBaseUrl ( ) : string
Результат string base URL

getContent() публичный Метод

Accessor for raw page information.
public getContent ( ) : string
Результат string Original text content of web page.

getContentAsText() публичный Метод

Accessor for plain text version of the page.
public getContentAsText ( ) : string
Результат string Normalised text representation.

getCookieValue() публичный Метод

Reads the most specific cookie value from the browser cookies.
public getCookieValue ( string $host, string $path, string $name ) : string
$host string Host to search.
$path string Applicable path.
$name string Name of cookie to read.
Результат string False if not present, else the value as a string.

getCurrentCookieValue() публичный Метод

Reads the current cookies for the current URL.
public getCurrentCookieValue ( string $name ) : string
$name string Key of cookie to find.
Результат string Null if there is no current URL, false if the cookie is not set.

getField() публичный Метод

Finds the first match.
public getField ( string $label ) : string/boolean
$label string Field label.
Результат string/boolean

getFieldById() публичный Метод

Accessor for a form element value within the page.
public getFieldById ( string/integer $id ) : string/boolean
$id string/integer
Результат string/boolean

getFieldByName() публичный Метод

Accessor for a form element value within the page. Finds the first match.
public getFieldByName ( string $name ) : string/boolean
$name string Field name.
Результат string/boolean

getFrameFocus() публичный Метод

Accessor for current frame focus. Will be false if no frame has focus.
public getFrameFocus ( ) : integer/string/boolean
Результат integer/string/boolean

getFrames() публичный Метод

Accessor for a breakdown of the frameset.
public getFrames ( ) : array
Результат array Hash tree of frames by name or index if no name.

getHeaders() публичный Метод

Accessor for raw header information.
public getHeaders ( ) : string
Результат string Header block.

getLinkById() публичный Метод

Finds a link by id attribute.
public getLinkById ( string $id ) : string/boolean
$id string ID attribute value.
Результат string/boolean

getMimeType() публичный Метод

Accessor for current MIME type.
public getMimeType ( ) : string
Результат string MIME type as string; e.g. 'text/html'

getParser() защищенный Метод

Otherwise scans through the available parsers and uses the first one which is available.
protected getParser ( ) : object
Результат object SimplePHPPageBuilder or SimpleTidyPageBuilder

getRealm() публичный Метод

Accessor for last Authentication realm. Only valid straight after a challenge (401).
public getRealm ( ) : string
Результат string Name of security realm.

getRequest() публичный Метод

Accessor for raw bytes sent down the wire.
public getRequest ( ) : string
Результат string Original text sent.

getResponseCode() публичный Метод

Accessor for last response code.
public getResponseCode ( ) : integer
Результат integer Last HTTP response code received.

getTitle() публичный Метод

Accessor for parsed title.
public getTitle ( ) : string
Результат string Title or false if no title is present.

getTransportError() публичный Метод

Accessor for last error.
public getTransportError ( ) : string
Результат string Error from last response.

getUrl() публичный Метод

Accessor for current URL of page or frame if focused.
public getUrl ( ) : string
Результат string Location of current page or frame as a string.

getUrls() публичный Метод

Accessor for a list of all links in current page.
public getUrls ( ) : array
Результат array List of urls with scheme of http or https and hostname.

head() публичный Метод

Will affect cookies, but will not change the base URL.
public head ( string/SimpleUrl $url, hash/SimpleHeadEncoding $parameters = false ) : boolean
$url string/SimpleUrl
$parameters hash/SimpleHeadEncoding
Результат boolean True if successful.

ignoreCookies() публичный Метод

Switches off cookie sending and recieving.
public ignoreCookies ( )

ignoreFrames() публичный Метод

Frames will not be fetched and the frameset page will be used instead.
public ignoreFrames ( )

isClickable() публичный Метод

Tests to see if a click target exists.
public isClickable ( string $label ) : boolean
$label string Visible text or alt text.
Результат boolean True if target present.

isImage() публичный Метод

Tests to see if an image exists with this title or alt text.
public isImage ( string $label ) : boolean
$label string Image text.
Результат boolean True if present.

isSubmit() публичный Метод

Tests to see if a submit button exists with this label.
public isSubmit ( string $label ) : boolean
$label string Button label.
Результат boolean True if present.

load() защищенный Метод

Fetches a page or a single frame if that is the current focus.
protected load ( SimpleUrl $url, SimpleEncoding $parameters ) : string
$url SimpleUrl Target to fetch.
$parameters SimpleEncoding GET/POST parameters.
Результат string Raw content of page.

loadFrame() защищенный Метод

Fetches a frame into the existing frameset replacing the original.
protected loadFrame ( array $frames, string/SimpleUrl $url, SimpleFormEncoding $parameters ) : string
$frames array List of names to drill down.
$url string/SimpleUrl
$parameters SimpleFormEncoding POST parameters.
Результат string Raw content of page.

loadPage() защищенный Метод

Fetches a page and makes it the current page/frame.
protected loadPage ( string/SimpleUrl $url, SimplePostEncoding $parameters ) : string
$url string/SimpleUrl
$parameters SimplePostEncoding POST parameters.
Результат string Raw content of page.

parse() защищенный Метод

Will load further frame pages unless frames are disabled.
protected parse ( SimpleHttpResponse $response, integer $depth ) : SimplePage
$response SimpleHttpResponse Response from fetch.
$depth integer Nested frameset depth.
Результат SimplePage Parsed HTML.

post() публичный Метод

Fetches the page content with a POST request.
public post ( string/SimpleUrl $url, hash/SimpleFormEncoding $parameters = false, string $content_type = false ) : string
$url string/SimpleUrl
$parameters hash/SimpleFormEncoding
$content_type string MIME Content-Type of the request body
Результат string Content of page.

put() публичный Метод

Fetches the page content with a PUT request.
public put ( string/SimpleUrl $url, hash/SimpleFormEncoding $parameters = false, string $content_type = false ) : string
$url string/SimpleUrl
$parameters hash/SimpleFormEncoding
$content_type string MIME Content-Type of the request body
Результат string Content of page.

restart() публичный Метод

Removes expired and temporary cookies as if the browser was closed and re-opened.
public restart ( string/integer $date = false )
$date string/integer

retry() публичный Метод

Will attempt to repeat the page fetch. If there is no history to repeat it will give false.
public retry ( ) : string/boolean
Результат string/boolean

setConnectionTimeout() публичный Метод

Sets the socket timeout for opening a connection.
public setConnectionTimeout ( integer $timeout )
$timeout integer Maximum time in seconds.

setCookie() публичный Метод

If a cookie has the same name and path it is replaced.
public setCookie ( string $name, string $value, string $host = false, string $path = '/', string $expiry = false )
$name string Cookie key.
$value string Value of cookie.
$host string Host upon which the cookie is valid.
$path string Cookie path if not host wide.
$expiry string Expiry date.

setField() публичный Метод

Sets all form fields with that name.
public setField ( string $label, string $value, $position = false ) : boolean
$label string Name or label of field in forms.
$value string New value of field.
Результат boolean True if field exists, otherwise false.

setFieldById() публичный Метод

Sets all form fields with that id attribute.
public setFieldById ( string/integer $id, string $value ) : boolean
$id string/integer
$value string New value of field.
Результат boolean True if field exists, otherwise false.

setFieldByName() публичный Метод

Sets all form fields with that name. Will use label if one is available (not yet implemented).
public setFieldByName ( string $name, string $value, $position = false ) : boolean
$name string Name of field in forms.
$value string New value of field.
Результат boolean True if field exists, otherwise false.

setFrameFocus() публичный Метод

Sets the focus by name.
public setFrameFocus ( string $name ) : boolean
$name string Chosen frame.
Результат boolean True if frame exists.

setFrameFocusByIndex() публичный Метод

Sets the focus by index. The integer index starts from 1.
public setFrameFocusByIndex ( integer $choice ) : boolean
$choice integer Chosen frame.
Результат boolean True if frame exists.

setMaximumNestedFrames() публичный Метод

Sets the maximum number of nesting of framed pages within a framed page to prevent loops.
public setMaximumNestedFrames ( integer $max )
$max integer Highest depth allowed.

setMaximumRedirects() публичный Метод

Sets the maximum number of redirects before a page will be loaded anyway.
public setMaximumRedirects ( integer $max )
$max integer Most hops allowed.

setParser() публичный Метод

Override the default HTML parser, allowing parsers to be plugged in.
public setParser ( $parser )

submitFormById() публичный Метод

Submits a form by the ID.
public submitFormById ( string $id, $additional = false ) : string/boolean
$id string The form ID. No submit button value will be sent.
Результат string/boolean

useCookies() публичный Метод

Switches back on the cookie sending and recieving.
public useCookies ( )

useFrames() публичный Метод

Enables frames support. Frames will be fetched from now on.
public useFrames ( )

useProxy() публичный Метод

Set URL to false to disable.
public useProxy ( string $proxy, string $username = false, string $password = false )
$proxy string Proxy URL.
$username string Proxy username for authentication.
$password string Proxy password for authentication.