\Query.php

Global
Classes
- \PEAR2\Net\RouterOS\Query

Show:

inherited

RouterOS API client implementation.

This package allows you to read and write information from a RouterOS host using MikroTik's RouterOS API.

PHP version 5

Author: Vasil Rangelov
Category: Net
Copyright: 2011 Vasil Rangelov
License: LGPL License 2.1
Link: http://netrouteros.sourceforge.net/
Package: PEAR2_Net_RouterOS
Version: 1.0.0b1

\PEAR2\Net\RouterOS\Query
jump to top

Package: PEAR2\Net\RouterOS

Represents a query for RouterOS requests.

Author: Vasil Rangelov
Category: Net
License: LGPL License 2.1
Link: http://netrouteros.sourceforge.net/

Constants

 
                ACTION_EXIST
                = ''

Checks if the property exists.

 
                ACTION_NOT_EXIST
                = '-'

Checks if the property does not exist.

 
                ACTION_EQUALS
                = '='

Checks if the property equals a certain value.

 
                ACTION_LESS_THAN
                = '<'

Checks if the property is less than a certain value.

 
                ACTION_GREATHER_THAN
                = '>'

Checks if the property is greather than a certain value.

Properties

array
                 $words= 'array('

An array of the words forming the query. Each value is an array with the first member being the predicate (action and name), and the second member being the value for the predicate.

Default valuearray(Details

Type: array

Methods

__construct(
          
          )
        
        :
          void

This class is not to be instantiated normally, but by static methods instead. Use {@link where()} to create an instance of it.

addWhere(
          string $name, string $value, string $action
          )
        
        :
          \PEAR2\Net\RouterOS\Query

Adds a condition.

Parameters

Name	Type	Description
$name	string	The name of the property to test.
$value	string	The value to test against. Not required for existence tests.
$action	string	One of the ACTION_ constants. Describes the operation to perform.*

Returns

Type	Description
\PEAR2\Net\RouterOS\Query	The query object.

andWhere(
          string $name, string $value
              =
              null, string $action
              =
              self::ACTION_EXIST
          )
        
        :
          \PEAR2\Net\RouterOS\Query

Adds a condition in addition to the query.

Parameters

Name	Type	Description
$name	string	The name of the property to test.
$value	string	The value to test against. Not required for existence tests.
$action	string	One of the ACTION_ constants. Describes the operation to perform.*

Returns

Type	Description
\PEAR2\Net\RouterOS\Query	The query object.

not(
          
          )
        
        :
          \PEAR2\Net\RouterOS\Query

Negates the query.

Returns

Type	Description
\PEAR2\Net\RouterOS\Query	The query object.

orWhere(
          string $name, string $value
              =
              null, string $action
              =
              self::ACTION_EXIST
          )
        
        :
          \PEAR2\Net\RouterOS\Query

Adds a condition as an alternative to the query.

Parameters

Name	Type	Description
$name	string	The name of the property to test.
$value	string	The value to test against. Not required for existence tests.
$action	string	One of the ACTION_ constants. Describes the operation to perform.*

Returns

Type	Description
\PEAR2\Net\RouterOS\Query	The query object.

sanitizeAction(
          string $action
          )
        
        :
          string

static

Sanitizes the action of a condition.

Parameters

Name	Type	Description
$action	string	The action to sanitize.

Returns

Type	Description
string	The sanitized action.

send(
          \PEAR2\Net\RouterOS\Communicator $com
          )
        
        :
          int

Sends the query over a communicator.

Parameters

Name	Type	Description
$com	\PEAR2\Net\RouterOS\Communicator	The communicator to send the query over.

Returns

Type	Description
int	The number of bytes sent.

where(
          string $name, string $value
              =
              null, string $action
              =
              self::ACTION_EXIST
          )
        
        :
          \PEAR2\Net\RouterOS\Query

static

Creates a new query with an initial condition.

Parameters

Name	Type	Description
$name	string	The name of the property to test.
$value	string	The value to test against. Not required for existence tests.
$action	string	One of the ACTION_ constants. Describes the operation to perform.*

Returns

Type	Description
\PEAR2\Net\RouterOS\Query	The query object.

\Query.php

\PEAR2\Net\RouterOS\Queryjump to top

Constants

Properties

Methods

\PEAR2\Net\RouterOS\Query
jump to top