route4me / route4me-php-sdk

src/Route4Me/CustomNoteTypeResponse.php

Indentation +38 added lines, -38 removed lines

@@ -6,42 +6,42 @@
 
 class CustomNoteTypeResponse extends Common
 {
-    /**
-     * Note custom type ID
-     * @var integer
-     */
-    public $note_custom_type_id;
-
-    /**
-     * Note custom type
-     * @var CustomNoteType
-     */
-    public $note_custom_type;
-
-    /**
-     * ID of a root owner of the account
-     * @var integer
-     */
-    public $root_owner_member_id;
-
-    /**
-     * Values of the custom note type
-     * @var array
-     */
-    public $note_custom_type_values=[];
-
-    public static function fromArray(array $params)
-    {
-        $customNoteTypeResponse = new self();
-
-        foreach ($params as $key => $value) {
-            if (property_exists($customNoteTypeResponse, $key)) {
-                $customNoteTypeResponse->{$key} = $value;
-            } else {
-                throw new BadParam("Correct parameter must be provided. Wrong Parameter: $key");
-            }
-        }
-
-        return $customNoteTypeResponse;
-    }
+	/**
+	 * Note custom type ID
+	 * @var integer
+	 */
+	public $note_custom_type_id;
+
+	/**
+	 * Note custom type
+	 * @var CustomNoteType
+	 */
+	public $note_custom_type;
+
+	/**
+	 * ID of a root owner of the account
+	 * @var integer
+	 */
+	public $root_owner_member_id;
+
+	/**
+	 * Values of the custom note type
+	 * @var array
+	 */
+	public $note_custom_type_values=[];
+
+	public static function fromArray(array $params)
+	{
+		$customNoteTypeResponse = new self();
+
+		foreach ($params as $key => $value) {
+			if (property_exists($customNoteTypeResponse, $key)) {
+				$customNoteTypeResponse->{$key} = $value;
+			} else {
+				throw new BadParam("Correct parameter must be provided. Wrong Parameter: $key");
+			}
+		}
+
+		return $customNoteTypeResponse;
+	}
 }
\ No newline at end of file

src/Route4Me/GeocodingResponse.php

Indentation +48 added lines, -48 removed lines

@@ -10,52 +10,52 @@
  */
 class GeocodingResponse extends Common
 {
-    /**
-     * A geocoded address
-     * @var string
-     */
-    public $address;
-
-    /**
-     * Latitude
-     * @var double
-     */
-    public $lat;
-
-    /**
-     * Longitude
-     * @var double
-     */
-    public $lng;
-
-    /**
-     * Geocoded area level type
-     * @var string
-     */
-    public $type;
-
-    /**
-     * Confidence ("high", "medium", "low")
-     * @var string
-     */
-    public $confidence;
-
-    /**
-     * Content of the original string (an address or geopoint) sent by HTTP
-     * @var Route
-     */
-    public $original;
-
-    public static function fromArray(array $params)
-    {
-        $geocodingResponse = new self();
-
-        foreach ($params as $key => $value) {
-            if (property_exists($geocodingResponse, $key)) {
-                $geocodingResponse->{$key} = $value;
-            }
-        }
-
-        return $geocodingResponse;
-    }
+	/**
+	 * A geocoded address
+	 * @var string
+	 */
+	public $address;
+
+	/**
+	 * Latitude
+	 * @var double
+	 */
+	public $lat;
+
+	/**
+	 * Longitude
+	 * @var double
+	 */
+	public $lng;
+
+	/**
+	 * Geocoded area level type
+	 * @var string
+	 */
+	public $type;
+
+	/**
+	 * Confidence ("high", "medium", "low")
+	 * @var string
+	 */
+	public $confidence;
+
+	/**
+	 * Content of the original string (an address or geopoint) sent by HTTP
+	 * @var Route
+	 */
+	public $original;
+
+	public static function fromArray(array $params)
+	{
+		$geocodingResponse = new self();
+
+		foreach ($params as $key => $value) {
+			if (property_exists($geocodingResponse, $key)) {
+				$geocodingResponse->{$key} = $value;
+			}
+		}
+
+		return $geocodingResponse;
+	}
 }

src/Route4Me/AddressNote.php

Indentation +234 added lines, -234 removed lines

@@ -11,238 +11,238 @@
  */
 class AddressNote extends Common
 {
-    /**
-     * An unique ID of a note
-     * @var integer
-     */
-    public $note_id;
-
-    /**
-     * The route ID
-     * @var string
-     */
-    public $route_id;
-
-    /**
-     * The route destination ID
-     * @var integer
-     */
-    public $route_destination_id;
-
-    /**
-     * An unique ID of an uploaded file
-     * @var string
-     */
-    public $upload_id;
-
-    /**
-     * When the note was added
-     * @var integer
-     */
-    public $ts_added;
-
-    /**
-     * The position latitude where the address note was added
-     * @var double
-     */
-    public $lat;
-
-    /**
-     * The position longitude where the address note was added
-     * @var double
-     */
-    public $lng;
-
-    /**
-     * The activity type
-     * @var string
-     */
-    public $activity_type;
-
-    /**
-     * The note text contents
-     * @var string
-     */
-    public $contents;
-
-    /**
-     * An upload type of the note
-     * @var string
-     */
-    public $upload_type;
-
-    /**
-     * An upload url - where a file-note was uploaded.
-     * @var string
-     */
-    public $upload_url;
-
-    /**
-     * An extension of the uploaded file.
-     * @var string
-     */
-    public $upload_extension;
-
-    /**
-     * The device a note was uploaded from.
-     * @var string
-     */
-    public $device_type;
-
-    /**
-     * Array of the custom type notes.
-     * @var CustomNoteType[]
-     */
-    public $custom_types;
-
-    public function __construct()
-    {
-
-    }
-
-    public static function fromArray(array $params)
-    {
-        $addressNote = new self();
-
-        foreach ($params as $key => $value) {
-            if (property_exists($addressNote, $key)) {
-                $addressNote->{$key} = $value;
-            } else {
-                throw new BadParam("Correct parameter must be provided. Wrong Parameter: $key");
-            }
-        }
-
-        return $addressNote;
-    }
-
-    /**
-     * Get notes from the specified route destination.<br>
-     * Returns an address object with notes, if an address exists, otherwise - return null.
-     */
-    public static function GetAddressesNotes($noteParams)
-    {
-        $address = Route4Me::makeRequst([
-            'url'       => Endpoint::ADDRESS_V4,
-            'method'    => 'GET',
-            'query'     => [
-                'route_id'              => isset($noteParams['route_id']) ? $noteParams['route_id'] : null,
-                'route_destination_id'  => isset($noteParams['route_destination_id'])
-                    ? $noteParams['route_destination_id'] : null,
-                'notes' => 1,
-            ],
-        ]);
-
-        return $address;
-    }
-
-    public function createCustomNoteType($params)
-    {
-        $allBodyFields = ['type', 'values'];
-
-        $result = Route4Me::makeRequst([
-            'url'       => Endpoint::NOTE_CUSTOM_TYPES_V4,
-            'method'    => 'POST',
-            'body'      => Route4Me::generateRequestParameters($allBodyFields, $params),
-        ]);
-
-        return $result;
-    }
-
-    public function removeCustomNoteType($params)
-    {
-        $result = Route4Me::makeRequst([
-            'url'       => Endpoint::NOTE_CUSTOM_TYPES_V4,
-            'method'    => 'DELETE',
-            'body'      => [
-                'id' => isset($params['id']) ? $params['id'] : null,
-            ],
-        ]);
-
-        return $result;
-    }
-
-    public function getAllCustomNoteTypes()
-    {
-        $result = Route4Me::makeRequst([
-            'url'       => Endpoint::NOTE_CUSTOM_TYPES_V4,
-            'method'    => 'GET',
-        ]);
-
-        return $result;
-    }
-
-    public function getCustomNoteTypeByKey($params)
-    {
-        $result = Route4Me::makeRequst([
-            'url'       => Endpoint::NOTE_CUSTOM_TYPES_V4,
-            'method'    => 'GET',
-        ]);
-
-        if (is_null($result) || !is_array($result)) return null;
-
-        foreach ($result as $custNoteType) {
-            if (isset($custNoteType["note_custom_type"]) && $custNoteType["note_custom_type"] == $params) {
-                return $custNoteType;
-            }
-        }
-    }
-
-    public function AddAddressNote($params)
-    {
-        $allQueryFields = ['route_id', 'address_id', 'dev_lat', 'dev_lng', 'device_type'];
-        $allBodyFields = ['strNoteContents', 'strUpdateType'];
-
-        $result = Route4Me::makeRequst([
-            'url'           => Endpoint::ROUTE_NOTES_ADD,
-            'method'        => 'POST',
-            'query'         => Route4Me::generateRequestParameters($allQueryFields, $params),
-            'body'          => Route4Me::generateRequestParameters($allBodyFields, $params),
-            'HTTPHEADER'    => 'Content-Type: multipart/form-data',
-        ]);
-
-        return $result;
-    }
-
-    public function AddNoteFile($params)
-    {
-        $fname = isset($params['strFilename']) ? $params['strFilename'] : null;
-
-        $allQueryFields = ['route_id', 'address_id', 'dev_lat', 'dev_lng', 'device_type'];
-        $allBodyFields = ['strFilename', 'strUpdateType', 'strNoteContents'];
-
-        $result = Route4Me::makeRequst([
-            'url'           => Endpoint::ROUTE_NOTES_ADD,
-            'method'        => 'POST',
-            'query'         => Route4Me::generateRequestParameters($allQueryFields, $params),
-            'body'          => Route4Me::generateRequestParameters($allBodyFields, $params),
-            'FILE'          => $fname,
-            'HTTPHEADER'    => 'Content-Type: multipart/form-data'
-        ]);
-
-        return $result;
-    }
-
-    public function addCustomNoteToRoute($params)
-    {
-        $customArray = [];
-
-        foreach ($params as $key => $value) {
-            if (false !== strpos($key, 'custom_note_type')) {
-                $customArray[$key] = $value;
-            }
-        }
-
-        $allQueryFields = ['route_id', 'address_id', 'format', 'dev_lat', 'dev_lng'];
-        $allBodyFields = ['strUpdateType', 'strUpdateType', 'strNoteContents'];
-
-        $result = Route4Me::makeRequst([
-            'url'           => Endpoint::ROUTE_NOTES_ADD,
-            'method'        => 'POST',
-            'query'         => Route4Me::generateRequestParameters($allQueryFields, $params),
-            'body'          => array_merge(Route4Me::generateRequestParameters($allBodyFields, $params), $customArray),
-            'HTTPHEADER'    => 'Content-Type: multipart/form-data',
-        ]);
-
-        return $result;
-    }
+	/**
+	 * An unique ID of a note
+	 * @var integer
+	 */
+	public $note_id;
+
+	/**
+	 * The route ID
+	 * @var string
+	 */
+	public $route_id;
+
+	/**
+	 * The route destination ID
+	 * @var integer
+	 */
+	public $route_destination_id;
+
+	/**
+	 * An unique ID of an uploaded file
+	 * @var string
+	 */
+	public $upload_id;
+
+	/**
+	 * When the note was added
+	 * @var integer
+	 */
+	public $ts_added;
+
+	/**
+	 * The position latitude where the address note was added
+	 * @var double
+	 */
+	public $lat;
+
+	/**
+	 * The position longitude where the address note was added
+	 * @var double
+	 */
+	public $lng;
+
+	/**
+	 * The activity type
+	 * @var string
+	 */
+	public $activity_type;
+
+	/**
+	 * The note text contents
+	 * @var string
+	 */
+	public $contents;
+
+	/**
+	 * An upload type of the note
+	 * @var string
+	 */
+	public $upload_type;
+
+	/**
+	 * An upload url - where a file-note was uploaded.
+	 * @var string
+	 */
+	public $upload_url;
+
+	/**
+	 * An extension of the uploaded file.
+	 * @var string
+	 */
+	public $upload_extension;
+
+	/**
+	 * The device a note was uploaded from.
+	 * @var string
+	 */
+	public $device_type;
+
+	/**
+	 * Array of the custom type notes.
+	 * @var CustomNoteType[]
+	 */
+	public $custom_types;
+
+	public function __construct()
+	{
+
+	}
+
+	public static function fromArray(array $params)
+	{
+		$addressNote = new self();
+
+		foreach ($params as $key => $value) {
+			if (property_exists($addressNote, $key)) {
+				$addressNote->{$key} = $value;
+			} else {
+				throw new BadParam("Correct parameter must be provided. Wrong Parameter: $key");
+			}
+		}
+
+		return $addressNote;
+	}
+
+	/**
+	 * Get notes from the specified route destination.<br>
+	 * Returns an address object with notes, if an address exists, otherwise - return null.
+	 */
+	public static function GetAddressesNotes($noteParams)
+	{
+		$address = Route4Me::makeRequst([
+			'url'       => Endpoint::ADDRESS_V4,
+			'method'    => 'GET',
+			'query'     => [
+				'route_id'              => isset($noteParams['route_id']) ? $noteParams['route_id'] : null,
+				'route_destination_id'  => isset($noteParams['route_destination_id'])
+					? $noteParams['route_destination_id'] : null,
+				'notes' => 1,
+			],
+		]);
+
+		return $address;
+	}
+
+	public function createCustomNoteType($params)
+	{
+		$allBodyFields = ['type', 'values'];
+
+		$result = Route4Me::makeRequst([
+			'url'       => Endpoint::NOTE_CUSTOM_TYPES_V4,
+			'method'    => 'POST',
+			'body'      => Route4Me::generateRequestParameters($allBodyFields, $params),
+		]);
+
+		return $result;
+	}
+
+	public function removeCustomNoteType($params)
+	{
+		$result = Route4Me::makeRequst([
+			'url'       => Endpoint::NOTE_CUSTOM_TYPES_V4,
+			'method'    => 'DELETE',
+			'body'      => [
+				'id' => isset($params['id']) ? $params['id'] : null,
+			],
+		]);
+
+		return $result;
+	}
+
+	public function getAllCustomNoteTypes()
+	{
+		$result = Route4Me::makeRequst([
+			'url'       => Endpoint::NOTE_CUSTOM_TYPES_V4,
+			'method'    => 'GET',
+		]);
+
+		return $result;
+	}
+
+	public function getCustomNoteTypeByKey($params)
+	{
+		$result = Route4Me::makeRequst([
+			'url'       => Endpoint::NOTE_CUSTOM_TYPES_V4,
+			'method'    => 'GET',
+		]);
+
+		if (is_null($result) || !is_array($result)) return null;
+
+		foreach ($result as $custNoteType) {
+			if (isset($custNoteType["note_custom_type"]) && $custNoteType["note_custom_type"] == $params) {
+				return $custNoteType;
+			}
+		}
+	}
+
+	public function AddAddressNote($params)
+	{
+		$allQueryFields = ['route_id', 'address_id', 'dev_lat', 'dev_lng', 'device_type'];
+		$allBodyFields = ['strNoteContents', 'strUpdateType'];
+
+		$result = Route4Me::makeRequst([
+			'url'           => Endpoint::ROUTE_NOTES_ADD,
+			'method'        => 'POST',
+			'query'         => Route4Me::generateRequestParameters($allQueryFields, $params),
+			'body'          => Route4Me::generateRequestParameters($allBodyFields, $params),
+			'HTTPHEADER'    => 'Content-Type: multipart/form-data',
+		]);
+
+		return $result;
+	}
+
+	public function AddNoteFile($params)
+	{
+		$fname = isset($params['strFilename']) ? $params['strFilename'] : null;
+
+		$allQueryFields = ['route_id', 'address_id', 'dev_lat', 'dev_lng', 'device_type'];
+		$allBodyFields = ['strFilename', 'strUpdateType', 'strNoteContents'];
+
+		$result = Route4Me::makeRequst([
+			'url'           => Endpoint::ROUTE_NOTES_ADD,
+			'method'        => 'POST',
+			'query'         => Route4Me::generateRequestParameters($allQueryFields, $params),
+			'body'          => Route4Me::generateRequestParameters($allBodyFields, $params),
+			'FILE'          => $fname,
+			'HTTPHEADER'    => 'Content-Type: multipart/form-data'
+		]);
+
+		return $result;
+	}
+
+	public function addCustomNoteToRoute($params)
+	{
+		$customArray = [];
+
+		foreach ($params as $key => $value) {
+			if (false !== strpos($key, 'custom_note_type')) {
+				$customArray[$key] = $value;
+			}
+		}
+
+		$allQueryFields = ['route_id', 'address_id', 'format', 'dev_lat', 'dev_lng'];
+		$allBodyFields = ['strUpdateType', 'strUpdateType', 'strNoteContents'];
+
+		$result = Route4Me::makeRequst([
+			'url'           => Endpoint::ROUTE_NOTES_ADD,
+			'method'        => 'POST',
+			'query'         => Route4Me::generateRequestParameters($allQueryFields, $params),
+			'body'          => array_merge(Route4Me::generateRequestParameters($allBodyFields, $params), $customArray),
+			'HTTPHEADER'    => 'Content-Type: multipart/form-data',
+		]);
+
+		return $result;
+	}
 }

src/Route4Me/Territory.php

Indentation +106 added lines, -106 removed lines

@@ -7,110 +7,110 @@
 
 class Territory extends Common
 {
-    /**
-     * @var
-     */
-    public $territory_id; // Territory id
-    public $territory_name;
-    public $territory_color;
-    public $addresses;
-    public $member_id;
-    public $territory; // Territory parameters
-
-    public function __construct()
-    {
-        Route4Me::setBaseUrl(Endpoint::BASE_URL);
-    }
-
-    public static function fromArray(array $params)
-    {
-        if (!isset($params['territory_name'])) {
-            throw new BadParam('Territory name must be provided');
-        }
-
-        if (!isset($params['territory_color'])) {
-            throw new BadParam('Territory color must be provided');
-        }
-
-        if (!isset($params['territory'])) {
-            throw new BadParam('Territory must be provided');
-        }
-
-        $territoryparameters = new self();
-
-        foreach ($params as $key => $value) {
-            if (property_exists($territoryparameters, $key)) {
-                $territoryparameters->{$key} = $value;
-            }
-        }
-
-        return $territoryparameters;
-    }
-
-    public static function getTerritory($params)
-    {
-        $allQueryFields = ['territory_id', 'addresses'];
-
-        $territory = Route4Me::makeRequst([
-            'url'       => Endpoint::TERRITORY_V4,
-            'method'    => 'GET',
-            'query'     => Route4Me::generateRequestParameters($allQueryFields, $params),
-        ]);
-
-        return $territory;
-    }
-
-    public static function getTerritories($params)
-    {
-        $allQueryFields = ['offset', 'limit', 'addresses'];
-
-        $response = Route4Me::makeRequst([
-            'url'       => Endpoint::TERRITORY_V4,
-            'method'    => 'GET',
-            'query'     => Route4Me::generateRequestParameters($allQueryFields, $params),
-        ]);
-
-        return $response;
-    }
-
-    public static function addTerritory($params)
-    {
-        $allBodyFields = ['territory_name', 'member_id', 'territory_color', 'territory'];
-
-        $response = Route4Me::makeRequst([
-            'url'       => Endpoint::TERRITORY_V4,
-            'method'    => 'POST',
-            'body'      => Route4Me::generateRequestParameters($allBodyFields, $params),
-        ]);
-
-        return $response;
-    }
-
-    public function deleteTerritory($territory_id)
-    {
-        $result = Route4Me::makeRequst([
-            'url'       => Endpoint::TERRITORY_V4,
-            'method'    => 'DELETE',
-            'query'     => [
-                'territory_id' => $territory_id,
-            ],
-        ]);
-
-        return $result;
-    }
-
-    public function updateTerritory($params)
-    {
-        $allQueryFields = ['territory_id'];
-        $allBodyFields = ['territory_name', 'member_id', 'territory_color', 'territory'];
-
-        $response = Route4Me::makeRequst([
-            'url'       => Endpoint::TERRITORY_V4,
-            'method'    => 'PUT',
-            'query'     => Route4Me::generateRequestParameters($allQueryFields, $params),
-            'body'      => Route4Me::generateRequestParameters($allBodyFields, $params),
-        ]);
-
-        return $response;
-    }
+	/**
+	 * @var
+	 */
+	public $territory_id; // Territory id
+	public $territory_name;
+	public $territory_color;
+	public $addresses;
+	public $member_id;
+	public $territory; // Territory parameters
+
+	public function __construct()
+	{
+		Route4Me::setBaseUrl(Endpoint::BASE_URL);
+	}
+
+	public static function fromArray(array $params)
+	{
+		if (!isset($params['territory_name'])) {
+			throw new BadParam('Territory name must be provided');
+		}
+
+		if (!isset($params['territory_color'])) {
+			throw new BadParam('Territory color must be provided');
+		}
+
+		if (!isset($params['territory'])) {
+			throw new BadParam('Territory must be provided');
+		}
+
+		$territoryparameters = new self();
+
+		foreach ($params as $key => $value) {
+			if (property_exists($territoryparameters, $key)) {
+				$territoryparameters->{$key} = $value;
+			}
+		}
+
+		return $territoryparameters;
+	}
+
+	public static function getTerritory($params)
+	{
+		$allQueryFields = ['territory_id', 'addresses'];
+
+		$territory = Route4Me::makeRequst([
+			'url'       => Endpoint::TERRITORY_V4,
+			'method'    => 'GET',
+			'query'     => Route4Me::generateRequestParameters($allQueryFields, $params),
+		]);
+
+		return $territory;
+	}
+
+	public static function getTerritories($params)
+	{
+		$allQueryFields = ['offset', 'limit', 'addresses'];
+
+		$response = Route4Me::makeRequst([
+			'url'       => Endpoint::TERRITORY_V4,
+			'method'    => 'GET',
+			'query'     => Route4Me::generateRequestParameters($allQueryFields, $params),
+		]);
+
+		return $response;
+	}
+
+	public static function addTerritory($params)
+	{
+		$allBodyFields = ['territory_name', 'member_id', 'territory_color', 'territory'];
+
+		$response = Route4Me::makeRequst([
+			'url'       => Endpoint::TERRITORY_V4,
+			'method'    => 'POST',
+			'body'      => Route4Me::generateRequestParameters($allBodyFields, $params),
+		]);
+
+		return $response;
+	}
+
+	public function deleteTerritory($territory_id)
+	{
+		$result = Route4Me::makeRequst([
+			'url'       => Endpoint::TERRITORY_V4,
+			'method'    => 'DELETE',
+			'query'     => [
+				'territory_id' => $territory_id,
+			],
+		]);
+
+		return $result;
+	}
+
+	public function updateTerritory($params)
+	{
+		$allQueryFields = ['territory_id'];
+		$allBodyFields = ['territory_name', 'member_id', 'territory_color', 'territory'];
+
+		$response = Route4Me::makeRequst([
+			'url'       => Endpoint::TERRITORY_V4,
+			'method'    => 'PUT',
+			'query'     => Route4Me::generateRequestParameters($allQueryFields, $params),
+			'body'      => Route4Me::generateRequestParameters($allBodyFields, $params),
+		]);
+
+		return $response;
+	}
 }

src/Route4Me/MyQ.php

Indentation +210 added lines, -210 removed lines

@@ -13,214 +13,214 @@
 
 class MyQ
 {
-    /** @var string|null $username contains the username used to authenticate with the MyQ API */
-    protected $username = null;
-    /** @var string|null $password contains the password used to authenticate with the MyQ API */
-    protected $password = null;
-    /** @var string|null $appId is the application ID used to register with the MyQ API */
-    protected $appId = 'NWknvuBd7LoFHfXmKNMBcgajXtZEgKUh4V7WNzMidrpUUluDpVYVZx+xT4PCM5Kx';
-    //protected $appId = 'Vj8pQggXLhLy0WHahglCD4N1nAkkXQtGYpq2HrHD7H1nvmbT55KqtN6RSF4ILB%2fi';
-    /** @var string|null $securityToken is the auth token returned after a successful login */
-    protected $securityToken = null;
-    /** @var string|null $userAgent is the User-Agent header value sent with each API request */
-    protected $userAgent = 'Chamberlain/3.4.1';
-    /** @var string|null $culture is the API culture code for the API */
-    protected $culture = 'en';
-    /** @var string|null $contentType is the content type used for all cURL requests */
-    protected $contentType = 'application/json';
-    /** @var array $headers contain HTTP headers for cURL requests */
-    protected $_headers = [];
-    protected $_deviceId = null;
-    protected $_locationName = null;
-    protected $_doorName = null;
-    protected $_loginUrl = 'https://myqexternal.myqdevice.com/api/v4/User/Validate';
-    protected $_getDeviceDetailUrl = 'https://myqexternal.myqdevice.com/api/v4/userdevicedetails/get?&filterOn=true';
-    protected $_putDeviceStateUrl = '/api/v4/DeviceAttribute/PutDeviceAttribute';
-    /** @var resource|null $_conn is the web connection to the MyQ API */
-    protected $_conn = null;
-
-    /**
-     * Initializes class. Optionally allows user to override variables.
-     *
-     * @param array $params A associative array for overwriting class variables
-     *
-     * @return MyQ
-     */
-    public function __construct($params = [])
-    {
-        // Overwrite class variables
-        foreach ($params as $k => $v) {
-            $this->$k = $v;
-        }
-
-        // Initialize cURL request headers
-        if (0 == sizeof($this->_headers)) {
-            $this->_headers = [
-                'MyQApplicationId' => $this->appId,
-                'Culture' => $this->culture,
-                'Content-Type' => $this->contentType,
-                'User-Agent' => $this->userAgent,
-            ];
-        }
-
-        // Initialize cURL connection
-        $this->_init();
-
-        return $this;
-    }
-
-    /**
-     * Perform a login request.
-     *
-     * @param string|null $username Username to use when logging in
-     * @param string|null $password Password to use for logging in
-     *
-     * @return MyQ
-     */
-    public function login($username = null, $password = null)
-    {
-        // Set username/password if not null
-        if (!is_null($username)) {
-            $this->username = $username;
-        }
-
-        if (!is_null($password)) {
-            $this->password = $password;
-        }
-
-        // confirm that we have a valid username/password
-        $error = [];
-        if (is_null($this->username)) {
-            $error[] = 'username';
-        }
-
-        if (is_null($this->password)) {
-            $error[] = 'password';
-        }
-
-        if (sizeof($error) > 0) {
-            throw new MyQException('Missing required auth credential: '.implode(',', $error));
-        }
-
-        $this->_login();
-    }
-
-    public function getState()
-    {
-        $this->_getDetails();
-        $timeInState = time() - $this->_doorStateTime;
-        echo implode(',', [
-            $this->_locationName,
-            $this->_doorName,
-            $this->_doorState,
-            (int) $timeInState,
-        ]);
-    }
-
-    public function getDetails()
-    {
-        return $this->_getDetails();
-    }
-
-    private function _init()
-    {
-        if (!isset($this->_conn)) {
-            $this->_conn = curl_init();
-
-            curl_setopt_array($this->_conn, [
-                CURLOPT_RETURNTRANSFER => true,
-                CURLOPT_ENCODING => '',
-                CURLOPT_MAXREDIRS => 10,
-                CURLOPT_TIMEOUT => 30,
-                CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
-                CURLOPT_FAILONERROR => true,
-                CURLOPT_FOLLOWLOCATION => true,
-                CURLOPT_FRESH_CONNECT => true,
-                CURLOPT_FORBID_REUSE => true,
-                CURLOPT_USERAGENT => $this->userAgent,
-            ]);
-        }
-
-        $this->_setHeaders();
-    }
-
-    private function _setHeaders()
-    {
-        $headers = [];
-
-        foreach ($this->_headers as $k => $v) {
-            $headers[] = "$k: $v";
-        }
-
-        curl_setopt($this->_conn, CURLOPT_HTTPHEADER, $headers);
-    }
-
-    private function _login()
-    {
-        $this->_init();
-
-        curl_setopt($this->_conn, CURLOPT_CUSTOMREQUEST, 'POST');
-        curl_setopt($this->_conn, CURLOPT_URL, $this->_loginUrl);
-
-        $post = json_encode(['username' => $this->username, 'password' => $this->password]);
-
-        curl_setopt($this->_conn, CURLOPT_POSTFIELDS, $post);
-
-        $output = curl_exec($this->_conn);
-
-        $data = json_decode($output);
-
-        if (false == $data || !isset($data->SecurityToken)) {
-            throw new MyQException("Error processing login request: $output");
-        }
-
-        $this->_headers['SecurityToken'] = $data->SecurityToken;
-
-        return $this;
-    }
-
-    private function _getDetails()
-    {
-        $this->_init();
-
-        curl_setopt($this->_conn, CURLOPT_CUSTOMREQUEST, 'GET');
-        curl_setopt($this->_conn, CURLOPT_URL, $this->_getDeviceDetailUrl);
-
-        $output = curl_exec($this->_conn);
-
-        $data = json_decode($output);
-
-        if (false == $data || !isset($data->Devices)) {
-            throw new MyQException("Error fetching device details: $output");
-        }
-
-        // Find our door device ID
-        foreach ($data->Devices as $device) {
-            if (false !== stripos($device->MyQDeviceTypeName, 'Gateway')) {
-                // Find location name
-                foreach ($device->Attributes as $attr) {
-                    if ('desc' == $attr->AttributeDisplayName) {
-                        $this->_locationName = $attr->Value;
-                    }
-                }
-            }
-
-            $this->_deviceId = $device->MyQDeviceId;
-
-            foreach ($device->Attributes as $attr) {
-                switch ($attr->AttributeDisplayName) {
-                    case 'desc':
-                        $this->_doorName = $attr->Value;
-                        break;
-                    case 'doorstate':
-                        $this->_doorState = $attr->Value;
-                        // UpdatedTime is a timestamp in ms, so we truncate
-                        $this->_doorStateTime = (int) $attr->UpdatedTime / 1000;
-                        break;
-                    default:
-                        continue;
-                }
-            }
-        }
-    }
+	/** @var string|null $username contains the username used to authenticate with the MyQ API */
+	protected $username = null;
+	/** @var string|null $password contains the password used to authenticate with the MyQ API */
+	protected $password = null;
+	/** @var string|null $appId is the application ID used to register with the MyQ API */
+	protected $appId = 'NWknvuBd7LoFHfXmKNMBcgajXtZEgKUh4V7WNzMidrpUUluDpVYVZx+xT4PCM5Kx';
+	//protected $appId = 'Vj8pQggXLhLy0WHahglCD4N1nAkkXQtGYpq2HrHD7H1nvmbT55KqtN6RSF4ILB%2fi';
+	/** @var string|null $securityToken is the auth token returned after a successful login */
+	protected $securityToken = null;
+	/** @var string|null $userAgent is the User-Agent header value sent with each API request */
+	protected $userAgent = 'Chamberlain/3.4.1';
+	/** @var string|null $culture is the API culture code for the API */
+	protected $culture = 'en';
+	/** @var string|null $contentType is the content type used for all cURL requests */
+	protected $contentType = 'application/json';
+	/** @var array $headers contain HTTP headers for cURL requests */
+	protected $_headers = [];
+	protected $_deviceId = null;
+	protected $_locationName = null;
+	protected $_doorName = null;
+	protected $_loginUrl = 'https://myqexternal.myqdevice.com/api/v4/User/Validate';
+	protected $_getDeviceDetailUrl = 'https://myqexternal.myqdevice.com/api/v4/userdevicedetails/get?&filterOn=true';
+	protected $_putDeviceStateUrl = '/api/v4/DeviceAttribute/PutDeviceAttribute';
+	/** @var resource|null $_conn is the web connection to the MyQ API */
+	protected $_conn = null;
+
+	/**
+	 * Initializes class. Optionally allows user to override variables.
+	 *
+	 * @param array $params A associative array for overwriting class variables
+	 *
+	 * @return MyQ
+	 */
+	public function __construct($params = [])
+	{
+		// Overwrite class variables
+		foreach ($params as $k => $v) {
+			$this->$k = $v;
+		}
+
+		// Initialize cURL request headers
+		if (0 == sizeof($this->_headers)) {
+			$this->_headers = [
+				'MyQApplicationId' => $this->appId,
+				'Culture' => $this->culture,
+				'Content-Type' => $this->contentType,
+				'User-Agent' => $this->userAgent,
+			];
+		}
+
+		// Initialize cURL connection
+		$this->_init();
+
+		return $this;
+	}
+
+	/**
+	 * Perform a login request.
+	 *
+	 * @param string|null $username Username to use when logging in
+	 * @param string|null $password Password to use for logging in
+	 *
+	 * @return MyQ
+	 */
+	public function login($username = null, $password = null)
+	{
+		// Set username/password if not null
+		if (!is_null($username)) {
+			$this->username = $username;
+		}
+
+		if (!is_null($password)) {
+			$this->password = $password;
+		}
+
+		// confirm that we have a valid username/password
+		$error = [];
+		if (is_null($this->username)) {
+			$error[] = 'username';
+		}
+
+		if (is_null($this->password)) {
+			$error[] = 'password';
+		}
+
+		if (sizeof($error) > 0) {
+			throw new MyQException('Missing required auth credential: '.implode(',', $error));
+		}
+
+		$this->_login();
+	}
+
+	public function getState()
+	{
+		$this->_getDetails();
+		$timeInState = time() - $this->_doorStateTime;
+		echo implode(',', [
+			$this->_locationName,
+			$this->_doorName,
+			$this->_doorState,
+			(int) $timeInState,
+		]);
+	}
+
+	public function getDetails()
+	{
+		return $this->_getDetails();
+	}
+
+	private function _init()
+	{
+		if (!isset($this->_conn)) {
+			$this->_conn = curl_init();
+
+			curl_setopt_array($this->_conn, [
+				CURLOPT_RETURNTRANSFER => true,
+				CURLOPT_ENCODING => '',
+				CURLOPT_MAXREDIRS => 10,
+				CURLOPT_TIMEOUT => 30,
+				CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
+				CURLOPT_FAILONERROR => true,
+				CURLOPT_FOLLOWLOCATION => true,
+				CURLOPT_FRESH_CONNECT => true,
+				CURLOPT_FORBID_REUSE => true,
+				CURLOPT_USERAGENT => $this->userAgent,
+			]);
+		}
+
+		$this->_setHeaders();
+	}
+
+	private function _setHeaders()
+	{
+		$headers = [];
+
+		foreach ($this->_headers as $k => $v) {
+			$headers[] = "$k: $v";
+		}
+
+		curl_setopt($this->_conn, CURLOPT_HTTPHEADER, $headers);
+	}
+
+	private function _login()
+	{
+		$this->_init();
+
+		curl_setopt($this->_conn, CURLOPT_CUSTOMREQUEST, 'POST');
+		curl_setopt($this->_conn, CURLOPT_URL, $this->_loginUrl);
+
+		$post = json_encode(['username' => $this->username, 'password' => $this->password]);
+
+		curl_setopt($this->_conn, CURLOPT_POSTFIELDS, $post);
+
+		$output = curl_exec($this->_conn);
+
+		$data = json_decode($output);
+
+		if (false == $data || !isset($data->SecurityToken)) {
+			throw new MyQException("Error processing login request: $output");
+		}
+
+		$this->_headers['SecurityToken'] = $data->SecurityToken;
+
+		return $this;
+	}
+
+	private function _getDetails()
+	{
+		$this->_init();
+
+		curl_setopt($this->_conn, CURLOPT_CUSTOMREQUEST, 'GET');
+		curl_setopt($this->_conn, CURLOPT_URL, $this->_getDeviceDetailUrl);
+
+		$output = curl_exec($this->_conn);
+
+		$data = json_decode($output);
+
+		if (false == $data || !isset($data->Devices)) {
+			throw new MyQException("Error fetching device details: $output");
+		}
+
+		// Find our door device ID
+		foreach ($data->Devices as $device) {
+			if (false !== stripos($device->MyQDeviceTypeName, 'Gateway')) {
+				// Find location name
+				foreach ($device->Attributes as $attr) {
+					if ('desc' == $attr->AttributeDisplayName) {
+						$this->_locationName = $attr->Value;
+					}
+				}
+			}
+
+			$this->_deviceId = $device->MyQDeviceId;
+
+			foreach ($device->Attributes as $attr) {
+				switch ($attr->AttributeDisplayName) {
+					case 'desc':
+						$this->_doorName = $attr->Value;
+						break;
+					case 'doorstate':
+						$this->_doorState = $attr->Value;
+						// UpdatedTime is a timestamp in ms, so we truncate
+						$this->_doorStateTime = (int) $attr->UpdatedTime / 1000;
+						break;
+					default:
+						continue;
+				}
+			}
+		}
+	}
 }

src/Route4Me/CurlHttpClient.php

Indentation +419 added lines, -419 removed lines

@@ -4,380 +4,380 @@ 
 
 class CurlHttpClient
 {
-    public $ch;
-    public $debug = false;
-    public $error_msg;
-
-    public function CurlHttpClient($debug = false)
-    {
-        $this->debug = $debug;
-        $this->init();
-    }
-
-    public function init()
-    {
-        // initialize curl handle
-        $this->ch = curl_init();
-        //set various options
-        //set error in case http return code bigger than 300
-        curl_setopt($this->ch, CURLOPT_FAILONERROR, true);
-        // use gzip if possible
-        curl_setopt($this->ch, CURLOPT_ENCODING, 'gzip, deflate');
-        // do not veryfy ssl
-        // this is important for windows
-        // as well for being able to access pages with non valid cert
-        curl_setopt($this->ch, CURLOPT_SSL_VERIFYPEER, 0);
-    }
-
-    /**
-     * Set username/pass for basic http auth.
-     *
-     * @param string user
-     * @param string pass
-     */
-    public function setCredentials($username, $password)
-    {
-        curl_setopt($this->ch, CURLOPT_USERPWD, "$username:$password");
-    }
-
-    /**
-     * Set referrer.
-     *
-     * @param string referrer url
-     */
-    public function setReferrer($referrer_url)
-    {
-        curl_setopt($this->ch, CURLOPT_REFERER, $referrer_url);
-    }
-
-    /**
-     * Set client's userAgent.
-     *
-     * @param string user agent
-     */
-    public function setUserAgent($userAgent)
-    {
-        curl_setopt($this->ch, CURLOPT_USERAGENT, $userAgent);
-    }
-
-    /**
-     * Set to receive output headers in all output functions.
-     *
-     * @param bool true to include all response headers with output, false otherwise
-     */
-    public function includeResponseHeaders($value)
-    {
-        curl_setopt($this->ch, CURLOPT_HEADER, $value);
-    }
-
-    /**
-     * Set proxy to use for each curl request.
-     *
-     * @param string proxy
-     */
-    public function setProxy($proxy)
-    {
-        curl_setopt($this->ch, CURLOPT_PROXY, $proxy);
-    }
-
-    /**
-     * Send post data to target URL
-     * return data returned from url or false if error occured.
-     *
-     * @param string url
-     * @param mixed post data (assoc array ie. $foo['post_var_name'] = $value or as string like var=val1&var2=val2)
-     * @param string ip address to bind (default null)
-     * @param int timeout in sec for complete curl operation (default 10)
-     *
-     * @return string data
-     */
-    public function sendPostData($url, $postdata, $ip = null, $timeout = 10)
-    {
-        //set various curl options first
-        // set url to post to
-        curl_setopt($this->ch, CURLOPT_URL, $url);
-        // return into a variable rather than displaying it
-        curl_setopt($this->ch, CURLOPT_RETURNTRANSFER, true);
-
-        //bind to specific ip address if it is sent trough arguments
-        if ($ip) {
-            if ($this->debug) {
-                echo "Binding to ip $ip\n";
-            }
-            curl_setopt($this->ch, CURLOPT_INTERFACE, $ip);
-        }
-
-        //set curl function timeout to $timeout
-        curl_setopt($this->ch, CURLOPT_TIMEOUT, $timeout);
-
-        //set method to post
-        curl_setopt($this->ch, CURLOPT_POST, true);
-        // set post string
-        curl_setopt($this->ch, CURLOPT_POSTFIELDS, $postdata);
-
-        //and finally send curl request
-        $result = curl_exec_redir($this->ch);
-        if (curl_errno($this->ch)) {
-            if ($this->debug) {
-                echo "Error Occured in Curl\n";
-                echo 'Error number: '.curl_errno($this->ch)."\n";
-                echo 'Error message: '.curl_error($this->ch)."\n";
-            }
-
-            return false;
-        } else {
-            return $result;
-        }
-    }
-
-    /**
-     * fetch data from target URL
-     * return data returned from url or false if error occured.
-     *
-     * @param string url
-     * @param string ip address to bind (default null)
-     * @param int timeout in sec for complete curl operation (default 5)
-     *
-     * @return string data
-     */
-    public function fetchUrl($url, $ip = null, $timeout = 5)
-    {
-        // set url to post to
-        curl_setopt($this->ch, CURLOPT_URL, $url);
-
-        //set method to get
-        curl_setopt($this->ch, CURLOPT_HTTPGET, true);
-        // return into a variable rather than displaying it
-        curl_setopt($this->ch, CURLOPT_RETURNTRANSFER, true);
-
-        //bind to specific ip address if it is sent trough arguments
-        if ($ip) {
-            if ($this->debug) {
-                echo "Binding to ip $ip\n";
-            }
-
-            curl_setopt($this->ch, CURLOPT_INTERFACE, $ip);
-        }
-
-        //set curl function timeout to $timeout
-        curl_setopt($this->ch, CURLOPT_TIMEOUT, $timeout);
-
-        //and finally send curl request
-        $result = curl_exec_redir($this->ch);
-        if (curl_errno($this->ch)) {
-            if ($this->debug) {
-                echo "Error Occured in Curl\n";
-                echo 'Error number: '.curl_errno($this->ch)."\n";
-                echo 'Error message: '.curl_error($this->ch)."\n";
-            }
-
-            return false;
-        } else {
-            return $result;
-        }
-    }
-
-    /**
-     * Fetch data from target URL
-     * and store it directly to file.
-     *
-     * @param string url
-     * @param resource value stream resource(ie. fopen)
-     * @param string ip address to bind (default null)
-     * @param int timeout in sec for complete curl operation (default 5)
-     *
-     * @return bool true on success false othervise
-     */
-    public function fetchIntoFile($url, $fp, $ip = null, $timeout = 5)
-    {
-        // set url to post to
-        curl_setopt($this->ch, CURLOPT_URL, $url);
-        //set method to get
-        curl_setopt($this->ch, CURLOPT_HTTPGET, true);
-        // store data into file rather than displaying it
-        curl_setopt($this->ch, CURLOPT_FILE, $fp);
-
-        //bind to specific ip address if it is sent trough arguments
-        if ($ip) {
-            if ($this->debug) {
-                echo "Binding to ip $ip\n";
-            }
-            curl_setopt($this->ch, CURLOPT_INTERFACE, $ip);
-        }
-
-        //set curl function timeout to $timeout
-        curl_setopt($this->ch, CURLOPT_TIMEOUT, $timeout);
-
-        //and finally send curl request
-        $result = curl_exec_redir($this->ch);
-        if (curl_errno($this->ch)) {
-            if ($this->debug) {
-                echo "Error Occured in Curl\n";
-                echo 'Error number: '.curl_errno($this->ch)."\n";
-                echo 'Error message: '.curl_error($this->ch)."\n";
-            }
-
-            return false;
-        } else {
-            return true;
-        }
-    }
-
-    /**
-     * Send multipart post data to the target URL
-     * return data returned from url or false if error occured
-     * (contribution by vule nikolic, vule@dinke.net).
-     *
-     * @param string url
-     * @param array assoc post data array ie. $foo['post_var_name'] = $value
-     * @param array assoc                     $file_field_array,    contains file_field name = value - path pairs
-     * @param string ip address to bind (default null)
-     * @param int timeout in sec for complete curl operation (default 30 sec)
-     *
-     * @return string data
-     */
-    public function sendMultipartPostData($url, $postdata, $file_field_array = [], $ip = null, $timeout = 30)
-    {
-        //set various curl options first
-        // set url to post to
-        curl_setopt($this->ch, CURLOPT_URL, $url);
-        // return into a variable rather than displaying it
-        curl_setopt($this->ch, CURLOPT_RETURNTRANSFER, true);
-
-        //bind to specific ip address if it is sent trough arguments
-        if ($ip) {
-            if ($this->debug) {
-                echo "Binding to ip $ip\n";
-            }
-
-            curl_setopt($this->ch, CURLOPT_INTERFACE, $ip);
-        }
-
-        //set curl function timeout to $timeout
-        curl_setopt($this->ch, CURLOPT_TIMEOUT, $timeout);
-        //set method to post
-        curl_setopt($this->ch, CURLOPT_POST, true);
-        // disable Expect header
-        // hack to make it working
-        $headers = ['Expect: '];
-        curl_setopt($this->ch, CURLOPT_HTTPHEADER, $headers);
-        // initialize result post array
-        $result_post = [];
-        //generate post string
-        $post_array = [];
-        $post_string_array = [];
-
-        if (!is_array($postdata)) {
-            return false;
-        }
-
-        foreach ($postdata as $key => $value) {
-            $post_array[$key] = $value;
-            $post_string_array[] = urlencode($key).'='.urlencode($value);
-        }
-
-        $post_string = implode('&', $post_string_array);
-        if ($this->debug) {
-            echo "Post String: $post_string\n";
-        }
-
-        // set post string
-        //curl_setopt($this->ch, CURLOPT_POSTFIELDS, $post_string);
-        // set multipart form data - file array field-value pairs
-        if (!empty($file_field_array)) {
-            foreach ($file_field_array as $var_name => $var_value) {
-                if (false !== strpos(PHP_OS, 'WIN')) {
-                    $var_value = str_replace('/', '\\', $var_value);
-                } // win hack
-                $file_field_array[$var_name] = '@'.$var_value;
-            }
-        }
-
-        // set post data
-        $result_post = array_merge($post_array, $file_field_array);
-        curl_setopt($this->ch, CURLOPT_POSTFIELDS, $result_post);
-
-        //and finally send curl request
-        $result = curl_exec_redir($this->ch);
-        if (curl_errno($this->ch)) {
-            if ($this->debug) {
-                echo "Error Occured in Curl\n";
-                echo 'Error number: '.curl_errno($this->ch)."\n";
-                echo 'Error message: '.curl_error($this->ch)."\n";
-            }
-
-            return false;
-        } else {
-            return $result;
-        }
-    }
-
-    /**
-     * Set file location where cookie data will be stored and send on each new request.
-     *
-     * @param string absolute path to cookie file (must be in writable dir)
-     */
-    public function storeCookies($cookie_file)
-    {
-        // use cookies on each request (cookies stored in $cookie_file)
-        curl_setopt($this->ch, CURLOPT_COOKIEJAR, $cookie_file);
-        curl_setopt($this->ch, CURLOPT_COOKIEFILE, $cookie_file);
-    }
-
-    /**
-     * Set custom cookie.
-     *
-     * @param string cookie
-     */
-    public function setCookie($cookie)
-    {
-        curl_setopt($this->ch, CURLOPT_COOKIE, $cookie);
-    }
-
-    /**
-     * Get last URL info
-     * usefull when original url was redirected to other location.
-     *
-     * @return string url
-     */
-    public function getEffectiveUrl()
-    {
-        return curl_getinfo($this->ch, CURLINFO_EFFECTIVE_URL);
-    }
-
-    /**
-     * Get http response code.
-     *
-     * @return int
-     */
-    public function getHttpResponseCode()
-    {
-        return curl_getinfo($this->ch, CURLINFO_HTTP_CODE);
-    }
-
-    /**
-     * Return last error message and error number.
-     *
-     * @return string error msg
-     */
-    public function getErrorMsg()
-    {
-        $err = 'Error number: '.curl_errno($this->ch)."\n";
-        $err .= 'Error message: '.curl_error($this->ch)."\n";
-
-        return $err;
-    }
-
-    /**
-     * Close curl session and free resource
-     * Usually no need to call this function directly
-     * in case you do you have to call init() to recreate curl.
-     */
-    public function close()
-    {
-        //close curl session and free up resources
-        curl_close($this->ch);
-    }
+	public $ch;
+	public $debug = false;
+	public $error_msg;
+
+	public function CurlHttpClient($debug = false)
+	{
+		$this->debug = $debug;
+		$this->init();
+	}
+
+	public function init()
+	{
+		// initialize curl handle
+		$this->ch = curl_init();
+		//set various options
+		//set error in case http return code bigger than 300
+		curl_setopt($this->ch, CURLOPT_FAILONERROR, true);
+		// use gzip if possible
+		curl_setopt($this->ch, CURLOPT_ENCODING, 'gzip, deflate');
+		// do not veryfy ssl
+		// this is important for windows
+		// as well for being able to access pages with non valid cert
+		curl_setopt($this->ch, CURLOPT_SSL_VERIFYPEER, 0);
+	}
+
+	/**
+	 * Set username/pass for basic http auth.
+	 *
+	 * @param string user
+	 * @param string pass
+	 */
+	public function setCredentials($username, $password)
+	{
+		curl_setopt($this->ch, CURLOPT_USERPWD, "$username:$password");
+	}
+
+	/**
+	 * Set referrer.
+	 *
+	 * @param string referrer url
+	 */
+	public function setReferrer($referrer_url)
+	{
+		curl_setopt($this->ch, CURLOPT_REFERER, $referrer_url);
+	}
+
+	/**
+	 * Set client's userAgent.
+	 *
+	 * @param string user agent
+	 */
+	public function setUserAgent($userAgent)
+	{
+		curl_setopt($this->ch, CURLOPT_USERAGENT, $userAgent);
+	}
+
+	/**
+	 * Set to receive output headers in all output functions.
+	 *
+	 * @param bool true to include all response headers with output, false otherwise
+	 */
+	public function includeResponseHeaders($value)
+	{
+		curl_setopt($this->ch, CURLOPT_HEADER, $value);
+	}
+
+	/**
+	 * Set proxy to use for each curl request.
+	 *
+	 * @param string proxy
+	 */
+	public function setProxy($proxy)
+	{
+		curl_setopt($this->ch, CURLOPT_PROXY, $proxy);
+	}
+
+	/**
+	 * Send post data to target URL
+	 * return data returned from url or false if error occured.
+	 *
+	 * @param string url
+	 * @param mixed post data (assoc array ie. $foo['post_var_name'] = $value or as string like var=val1&var2=val2)
+	 * @param string ip address to bind (default null)
+	 * @param int timeout in sec for complete curl operation (default 10)
+	 *
+	 * @return string data
+	 */
+	public function sendPostData($url, $postdata, $ip = null, $timeout = 10)
+	{
+		//set various curl options first
+		// set url to post to
+		curl_setopt($this->ch, CURLOPT_URL, $url);
+		// return into a variable rather than displaying it
+		curl_setopt($this->ch, CURLOPT_RETURNTRANSFER, true);
+
+		//bind to specific ip address if it is sent trough arguments
+		if ($ip) {
+			if ($this->debug) {
+				echo "Binding to ip $ip\n";
+			}
+			curl_setopt($this->ch, CURLOPT_INTERFACE, $ip);
+		}
+
+		//set curl function timeout to $timeout
+		curl_setopt($this->ch, CURLOPT_TIMEOUT, $timeout);
+
+		//set method to post
+		curl_setopt($this->ch, CURLOPT_POST, true);
+		// set post string
+		curl_setopt($this->ch, CURLOPT_POSTFIELDS, $postdata);
+
+		//and finally send curl request
+		$result = curl_exec_redir($this->ch);
+		if (curl_errno($this->ch)) {
+			if ($this->debug) {
+				echo "Error Occured in Curl\n";
+				echo 'Error number: '.curl_errno($this->ch)."\n";
+				echo 'Error message: '.curl_error($this->ch)."\n";
+			}
+
+			return false;
+		} else {
+			return $result;
+		}
+	}
+
+	/**
+	 * fetch data from target URL
+	 * return data returned from url or false if error occured.
+	 *
+	 * @param string url
+	 * @param string ip address to bind (default null)
+	 * @param int timeout in sec for complete curl operation (default 5)
+	 *
+	 * @return string data
+	 */
+	public function fetchUrl($url, $ip = null, $timeout = 5)
+	{
+		// set url to post to
+		curl_setopt($this->ch, CURLOPT_URL, $url);
+
+		//set method to get
+		curl_setopt($this->ch, CURLOPT_HTTPGET, true);
+		// return into a variable rather than displaying it
+		curl_setopt($this->ch, CURLOPT_RETURNTRANSFER, true);
+
+		//bind to specific ip address if it is sent trough arguments
+		if ($ip) {
+			if ($this->debug) {
+				echo "Binding to ip $ip\n";
+			}
+
+			curl_setopt($this->ch, CURLOPT_INTERFACE, $ip);
+		}
+
+		//set curl function timeout to $timeout
+		curl_setopt($this->ch, CURLOPT_TIMEOUT, $timeout);
+
+		//and finally send curl request
+		$result = curl_exec_redir($this->ch);
+		if (curl_errno($this->ch)) {
+			if ($this->debug) {
+				echo "Error Occured in Curl\n";
+				echo 'Error number: '.curl_errno($this->ch)."\n";
+				echo 'Error message: '.curl_error($this->ch)."\n";
+			}
+
+			return false;
+		} else {
+			return $result;
+		}
+	}
+
+	/**
+	 * Fetch data from target URL
+	 * and store it directly to file.
+	 *
+	 * @param string url
+	 * @param resource value stream resource(ie. fopen)
+	 * @param string ip address to bind (default null)
+	 * @param int timeout in sec for complete curl operation (default 5)
+	 *
+	 * @return bool true on success false othervise
+	 */
+	public function fetchIntoFile($url, $fp, $ip = null, $timeout = 5)
+	{
+		// set url to post to
+		curl_setopt($this->ch, CURLOPT_URL, $url);
+		//set method to get
+		curl_setopt($this->ch, CURLOPT_HTTPGET, true);
+		// store data into file rather than displaying it
+		curl_setopt($this->ch, CURLOPT_FILE, $fp);
+
+		//bind to specific ip address if it is sent trough arguments
+		if ($ip) {
+			if ($this->debug) {
+				echo "Binding to ip $ip\n";
+			}
+			curl_setopt($this->ch, CURLOPT_INTERFACE, $ip);
+		}
+
+		//set curl function timeout to $timeout
+		curl_setopt($this->ch, CURLOPT_TIMEOUT, $timeout);
+
+		//and finally send curl request
+		$result = curl_exec_redir($this->ch);
+		if (curl_errno($this->ch)) {
+			if ($this->debug) {
+				echo "Error Occured in Curl\n";
+				echo 'Error number: '.curl_errno($this->ch)."\n";
+				echo 'Error message: '.curl_error($this->ch)."\n";
+			}
+
+			return false;
+		} else {
+			return true;
+		}
+	}
+
+	/**
+	 * Send multipart post data to the target URL
+	 * return data returned from url or false if error occured
+	 * (contribution by vule nikolic, vule@dinke.net).
+	 *
+	 * @param string url
+	 * @param array assoc post data array ie. $foo['post_var_name'] = $value
+	 * @param array assoc                     $file_field_array,    contains file_field name = value - path pairs
+	 * @param string ip address to bind (default null)
+	 * @param int timeout in sec for complete curl operation (default 30 sec)
+	 *
+	 * @return string data
+	 */
+	public function sendMultipartPostData($url, $postdata, $file_field_array = [], $ip = null, $timeout = 30)
+	{
+		//set various curl options first
+		// set url to post to
+		curl_setopt($this->ch, CURLOPT_URL, $url);
+		// return into a variable rather than displaying it
+		curl_setopt($this->ch, CURLOPT_RETURNTRANSFER, true);
+
+		//bind to specific ip address if it is sent trough arguments
+		if ($ip) {
+			if ($this->debug) {
+				echo "Binding to ip $ip\n";
+			}
+
+			curl_setopt($this->ch, CURLOPT_INTERFACE, $ip);
+		}
+
+		//set curl function timeout to $timeout
+		curl_setopt($this->ch, CURLOPT_TIMEOUT, $timeout);
+		//set method to post
+		curl_setopt($this->ch, CURLOPT_POST, true);
+		// disable Expect header
+		// hack to make it working
+		$headers = ['Expect: '];
+		curl_setopt($this->ch, CURLOPT_HTTPHEADER, $headers);
+		// initialize result post array
+		$result_post = [];
+		//generate post string
+		$post_array = [];
+		$post_string_array = [];
+
+		if (!is_array($postdata)) {
+			return false;
+		}
+
+		foreach ($postdata as $key => $value) {
+			$post_array[$key] = $value;
+			$post_string_array[] = urlencode($key).'='.urlencode($value);
+		}
+
+		$post_string = implode('&', $post_string_array);
+		if ($this->debug) {
+			echo "Post String: $post_string\n";
+		}
+
+		// set post string
+		//curl_setopt($this->ch, CURLOPT_POSTFIELDS, $post_string);
+		// set multipart form data - file array field-value pairs
+		if (!empty($file_field_array)) {
+			foreach ($file_field_array as $var_name => $var_value) {
+				if (false !== strpos(PHP_OS, 'WIN')) {
+					$var_value = str_replace('/', '\\', $var_value);
+				} // win hack
+				$file_field_array[$var_name] = '@'.$var_value;
+			}
+		}
+
+		// set post data
+		$result_post = array_merge($post_array, $file_field_array);
+		curl_setopt($this->ch, CURLOPT_POSTFIELDS, $result_post);
+
+		//and finally send curl request
+		$result = curl_exec_redir($this->ch);
+		if (curl_errno($this->ch)) {
+			if ($this->debug) {
+				echo "Error Occured in Curl\n";
+				echo 'Error number: '.curl_errno($this->ch)."\n";
+				echo 'Error message: '.curl_error($this->ch)."\n";
+			}
+
+			return false;
+		} else {
+			return $result;
+		}
+	}
+
+	/**
+	 * Set file location where cookie data will be stored and send on each new request.
+	 *
+	 * @param string absolute path to cookie file (must be in writable dir)
+	 */
+	public function storeCookies($cookie_file)
+	{
+		// use cookies on each request (cookies stored in $cookie_file)
+		curl_setopt($this->ch, CURLOPT_COOKIEJAR, $cookie_file);
+		curl_setopt($this->ch, CURLOPT_COOKIEFILE, $cookie_file);
+	}
+
+	/**
+	 * Set custom cookie.
+	 *
+	 * @param string cookie
+	 */
+	public function setCookie($cookie)
+	{
+		curl_setopt($this->ch, CURLOPT_COOKIE, $cookie);
+	}
+
+	/**
+	 * Get last URL info
+	 * usefull when original url was redirected to other location.
+	 *
+	 * @return string url
+	 */
+	public function getEffectiveUrl()
+	{
+		return curl_getinfo($this->ch, CURLINFO_EFFECTIVE_URL);
+	}
+
+	/**
+	 * Get http response code.
+	 *
+	 * @return int
+	 */
+	public function getHttpResponseCode()
+	{
+		return curl_getinfo($this->ch, CURLINFO_HTTP_CODE);
+	}
+
+	/**
+	 * Return last error message and error number.
+	 *
+	 * @return string error msg
+	 */
+	public function getErrorMsg()
+	{
+		$err = 'Error number: '.curl_errno($this->ch)."\n";
+		$err .= 'Error message: '.curl_error($this->ch)."\n";
+
+		return $err;
+	}
+
+	/**
+	 * Close curl session and free resource
+	 * Usually no need to call this function directly
+	 * in case you do you have to call init() to recreate curl.
+	 */
+	public function close()
+	{
+		//close curl session and free up resources
+		curl_close($this->ch);
+	}
 }
 
 /**
@@ -386,63 +386,63 @@ 
  */
 function curlExecRedir($ch)
 {
-    static $curl_loops = 0;
-    static $curl_max_loops = 20;
+	static $curl_loops = 0;
+	static $curl_max_loops = 20;
 
-    if ($curl_loops++ >= $curl_max_loops) {
-        $curl_loops = 0;
+	if ($curl_loops++ >= $curl_max_loops) {
+		$curl_loops = 0;
 
-        return false;
-    }
+		return false;
+	}
 
-    curl_setopt($ch, CURLOPT_HTTPHEADER, ['Expect:']);
-    curl_setopt($ch, CURLOPT_HEADER, true);
-    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
-    curl_setopt($ch, CURLOPT_VERBOSE, false);
-    $data = curl_exec($ch);
-    $data = str_replace("\r", "\n", str_replace("\r\n", "\n", $data));
-    list($header, $data) = explode("\n\n", $data, 2);
-    $http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
+	curl_setopt($ch, CURLOPT_HTTPHEADER, ['Expect:']);
+	curl_setopt($ch, CURLOPT_HEADER, true);
+	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+	curl_setopt($ch, CURLOPT_VERBOSE, false);
+	$data = curl_exec($ch);
+	$data = str_replace("\r", "\n", str_replace("\r\n", "\n", $data));
+	list($header, $data) = explode("\n\n", $data, 2);
+	$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
 
-    //echo "*** Got HTTP code: $http_code ***\n";
-    //echo "**  Got headers: \n$header\n\n";
+	//echo "*** Got HTTP code: $http_code ***\n";
+	//echo "**  Got headers: \n$header\n\n";
 
-    if (301 == $http_code || 302 == $http_code) {
-        // If we're redirected, we should revert to GET
-        curl_setopt($ch, CURLOPT_HTTPGET, true);
+	if (301 == $http_code || 302 == $http_code) {
+		// If we're redirected, we should revert to GET
+		curl_setopt($ch, CURLOPT_HTTPGET, true);
 
-        $matches = [];
-        preg_match('/Location:\s*(.*?)(\n|$)/i', $header, $matches);
-        $url = @parse_url(trim($matches[1]));
+		$matches = [];
+		preg_match('/Location:\s*(.*?)(\n|$)/i', $header, $matches);
+		$url = @parse_url(trim($matches[1]));
 
-        if (!$url) {
-            //couldn't process the url to redirect to
-            $curl_loops = 0;
+		if (!$url) {
+			//couldn't process the url to redirect to
+			$curl_loops = 0;
 
-            return $data;
-        }
+			return $data;
+		}
 
-        $last_url = parse_url(curl_getinfo($ch, CURLINFO_EFFECTIVE_URL));
-        if (empty($url['scheme'])) {
-            $url['scheme'] = $last_url['scheme'];
-        }
+		$last_url = parse_url(curl_getinfo($ch, CURLINFO_EFFECTIVE_URL));
+		if (empty($url['scheme'])) {
+			$url['scheme'] = $last_url['scheme'];
+		}
 
-        if (empty($url['host'])) {
-            $url['host'] = $last_url['host'];
-        }
+		if (empty($url['host'])) {
+			$url['host'] = $last_url['host'];
+		}
 
-        if (empty($url['path'])) {
-            $url['path'] = $last_url['path'];
-        }
+		if (empty($url['path'])) {
+			$url['path'] = $last_url['path'];
+		}
 
-        $new_url = $url['scheme'].'://'.$url['host'].$url['path'].(!empty($url['query']) ? '?'.$url['query'] : '');
-        //echo "Being redirected to $new_url\n";
-        curl_setopt($ch, CURLOPT_URL, $new_url);
+		$new_url = $url['scheme'].'://'.$url['host'].$url['path'].(!empty($url['query']) ? '?'.$url['query'] : '');
+		//echo "Being redirected to $new_url\n";
+		curl_setopt($ch, CURLOPT_URL, $new_url);
 
-        return curl_exec_redir($ch);
-    } else {
-        $curl_loops = 0;
+		return curl_exec_redir($ch);
+	} else {
+		$curl_loops = 0;
 
-        return $data;
-    }
+		return $data;
+	}
 }

src/Route4Me/Members/MemberAuthenticationResponse.php

Indentation +190 added lines, -190 removed lines

@@ -10,194 +10,194 @@
  */
 class MemberAuthenticationResponse extends \Route4Me\Common
 {
-    /** @var boolean $status
-     * True, if authentication process was finished successfuly.
-     */
-    public $status;
-
-    /** @var string $geocoding_service
-     * Geocoding service
-     */
-    public $geocoding_service;
-
-    /** @var int $session_id
-     * Session ID
-     */
-    public $session_id;
-
-    /** @var string $session_guid
-     * Session guid
-     */
-    public $session_guid;
-
-    /** @var int $member_id
-     * Member ID
-     */
-    public $member_id;
-
-    /** @var string $api_key
-     * API key of an user
-     */
-    public $api_key;
-
-    /** @var int $tracking_ttl
-     * Tracking TTL
-     */
-    public $tracking_ttl;
-
-    /** @var string $update_channel_name
-     * Update channel name
-     */
-    public $update_channel_name;
-
-    /** @var string $geofence_polygon_shape
-     * Geofence polygon shape. ENUM('circle', 'poly', 'rect').
-     */
-    public $geofence_polygon_shape ;
-
-    /** @var int $geofence_polygon_size
-     * Geofence polygon size
-     */
-    public $geofence_polygon_size;
-
-    /** @var int $geofence_time_onsite_trigger_secs
-     * Geofence time onsite trigger in seconds.
-     */
-    public $geofence_time_onsite_trigger_secs;
-
-    /** @var int $geofence_minimum_trigger_speed
-     * Geofence minimum trigger speed.
-     */
-    public $geofence_minimum_trigger_speed;
-
-    /** @var boolean $is_subscription_past_due
-     * If true, subscription is past due.
-     */
-    public $is_subscription_past_due;
-
-    /** @var string $visited_departed_enabled
-     * if true, triggering of the visited and departed activities is enabled.
-     */
-    public $visited_departed_enabled;
-
-    /** @var string $long_press_enabled
-     * if true, long press is enabled.
-     */
-    public $long_press_enabled;
-
-    /** @var string $account_type_id
-     * The account type ID
-     */
-    public $account_type_id;
-
-    /** @var string $account_type_alias
-     * Account type alias.
-     */
-    public $account_type_alias;
-
-    /** @var string $member_type
-     * A type of the member.
-     * Available values:
-     * 'PRIMARY_ACCOUNT',
-     * 'SUB_ACCOUNT_ADMIN',
-     * 'SUB_ACCOUNT_REGIONAL_MANAGER',
-     * 'SUB_ACCOUNT_DISPATCHER',
-     * 'SUB_ACCOUNT_PLANNER',
-     * 'SUB_ACCOUNT_DRIVER',
-     * 'SUB_ACCOUNT_ANALYST',
-     * 'SUB_ACCOUNT_VENDOR',
-     * 'SUB_ACCOUNT_CUSTOMER_SERVICE'
-     */
-    public $member_type;
-
-    /** @var string $max_stops_per_route
-     * Maximum stops per route.
-     */
-    public $max_stops_per_route;
-
-    /** @var string $max_routes
-     * Maximum number of the routes.
-     */
-    public $max_routes;
-
-    /** @var int $routes_planned
-     * Number of the planned routes by an user.
-     */
-    public $routes_planned;
-
-    /** @var string $preferred_units
-     * Preferred units. Enum('km', 'mi').
-     */
-    public $preferred_units;
-
-    /** @var string $preferred_language
-     * Preferred language. Enum('en', 'fr').
-     */
-    public $preferred_language;
-
-    /** @var string $HIDE_ROUTED_ADDRESSES
-     * If true, routed addresses will be hidden.
-     */
-    public $HIDE_ROUTED_ADDRESSES;
-
-    /** @var string $HIDE_VISITED_ADDRESSES
-     * If true, visited addresses will be hidden.
-     */
-    public $HIDE_VISITED_ADDRESSES;
-
-    /** @var string $HIDE_NONFUTURE_ROUTES
-     * If equal to true, nonfuture addresses will be hidden.
-     */
-    public $HIDE_NONFUTURE_ROUTES;
-
-    /** @var string $READONLY_USER
-     * If equal to true, user can only read data.
-     */
-    public $READONLY_USER;
-
-    /** @var int $auto_logout_ts
-     * Time in seconds. If a user is inactive during this period, he will be logout.
-     */
-    public $auto_logout_ts;
-
-    /** @var string $last_known_member_payment_device
-     * Last known member payment device (e.g. 'web')
-     */
-    public $last_known_member_payment_device;
-
-    /** @var int $account_expires_timestamp
-     * Account expire date
-     */
-    public $account_expires_timestamp;
-
-    /** @var boolean $account_past_due
-     * Account past due
-     */
-    public $account_past_due;
-
-    /** @var array  $licensed_modules
-     * Licensed module. e.g.:
-     * 'MODULE__ROUTE_EDITOR_CUSTOM_DATA_EDITING',
-     * 'MODULE__VOICE_NAVIGATION:TRUE',
-     * 'MODULE__VOICE_NAVIGATION'
-     */
-    public $licensed_modules;
-
-    /** @var int $last_active_timestamp
-     * Last active timestamp
-     */
-    public $last_active_timestamp;
-
-    public static function fromArray(array $params)
-    {
-        $memberAurhenticateResponse = new self();
-
-        foreach ($params as $key => $value) {
-            if (property_exists($memberAurhenticateResponse, $key)) {
-                $memberAurhenticateResponse->{$key} = $value;
-            }
-        }
-
-        return $memberAurhenticateResponse;
-    }
+	/** @var boolean $status
+	 * True, if authentication process was finished successfuly.
+	 */
+	public $status;
+
+	/** @var string $geocoding_service
+	 * Geocoding service
+	 */
+	public $geocoding_service;
+
+	/** @var int $session_id
+	 * Session ID
+	 */
+	public $session_id;
+
+	/** @var string $session_guid
+	 * Session guid
+	 */
+	public $session_guid;
+
+	/** @var int $member_id
+	 * Member ID
+	 */
+	public $member_id;
+
+	/** @var string $api_key
+	 * API key of an user
+	 */
+	public $api_key;
+
+	/** @var int $tracking_ttl
+	 * Tracking TTL
+	 */
+	public $tracking_ttl;
+
+	/** @var string $update_channel_name
+	 * Update channel name
+	 */
+	public $update_channel_name;
+
+	/** @var string $geofence_polygon_shape
+	 * Geofence polygon shape. ENUM('circle', 'poly', 'rect').
+	 */
+	public $geofence_polygon_shape ;
+
+	/** @var int $geofence_polygon_size
+	 * Geofence polygon size
+	 */
+	public $geofence_polygon_size;
+
+	/** @var int $geofence_time_onsite_trigger_secs
+	 * Geofence time onsite trigger in seconds.
+	 */
+	public $geofence_time_onsite_trigger_secs;
+
+	/** @var int $geofence_minimum_trigger_speed
+	 * Geofence minimum trigger speed.
+	 */
+	public $geofence_minimum_trigger_speed;
+
+	/** @var boolean $is_subscription_past_due
+	 * If true, subscription is past due.
+	 */
+	public $is_subscription_past_due;
+
+	/** @var string $visited_departed_enabled
+	 * if true, triggering of the visited and departed activities is enabled.
+	 */
+	public $visited_departed_enabled;
+
+	/** @var string $long_press_enabled
+	 * if true, long press is enabled.
+	 */
+	public $long_press_enabled;
+
+	/** @var string $account_type_id
+	 * The account type ID
+	 */
+	public $account_type_id;
+
+	/** @var string $account_type_alias
+	 * Account type alias.
+	 */
+	public $account_type_alias;
+
+	/** @var string $member_type
+	 * A type of the member.
+	 * Available values:
+	 * 'PRIMARY_ACCOUNT',
+	 * 'SUB_ACCOUNT_ADMIN',
+	 * 'SUB_ACCOUNT_REGIONAL_MANAGER',
+	 * 'SUB_ACCOUNT_DISPATCHER',
+	 * 'SUB_ACCOUNT_PLANNER',
+	 * 'SUB_ACCOUNT_DRIVER',
+	 * 'SUB_ACCOUNT_ANALYST',
+	 * 'SUB_ACCOUNT_VENDOR',
+	 * 'SUB_ACCOUNT_CUSTOMER_SERVICE'
+	 */
+	public $member_type;
+
+	/** @var string $max_stops_per_route
+	 * Maximum stops per route.
+	 */
+	public $max_stops_per_route;
+
+	/** @var string $max_routes
+	 * Maximum number of the routes.
+	 */
+	public $max_routes;
+
+	/** @var int $routes_planned
+	 * Number of the planned routes by an user.
+	 */
+	public $routes_planned;
+
+	/** @var string $preferred_units
+	 * Preferred units. Enum('km', 'mi').
+	 */
+	public $preferred_units;
+
+	/** @var string $preferred_language
+	 * Preferred language. Enum('en', 'fr').
+	 */
+	public $preferred_language;
+
+	/** @var string $HIDE_ROUTED_ADDRESSES
+	 * If true, routed addresses will be hidden.
+	 */
+	public $HIDE_ROUTED_ADDRESSES;
+
+	/** @var string $HIDE_VISITED_ADDRESSES
+	 * If true, visited addresses will be hidden.
+	 */
+	public $HIDE_VISITED_ADDRESSES;
+
+	/** @var string $HIDE_NONFUTURE_ROUTES
+	 * If equal to true, nonfuture addresses will be hidden.
+	 */
+	public $HIDE_NONFUTURE_ROUTES;
+
+	/** @var string $READONLY_USER
+	 * If equal to true, user can only read data.
+	 */
+	public $READONLY_USER;
+
+	/** @var int $auto_logout_ts
+	 * Time in seconds. If a user is inactive during this period, he will be logout.
+	 */
+	public $auto_logout_ts;
+
+	/** @var string $last_known_member_payment_device
+	 * Last known member payment device (e.g. 'web')
+	 */
+	public $last_known_member_payment_device;
+
+	/** @var int $account_expires_timestamp
+	 * Account expire date
+	 */
+	public $account_expires_timestamp;
+
+	/** @var boolean $account_past_due
+	 * Account past due
+	 */
+	public $account_past_due;
+
+	/** @var array  $licensed_modules
+	 * Licensed module. e.g.:
+	 * 'MODULE__ROUTE_EDITOR_CUSTOM_DATA_EDITING',
+	 * 'MODULE__VOICE_NAVIGATION:TRUE',
+	 * 'MODULE__VOICE_NAVIGATION'
+	 */
+	public $licensed_modules;
+
+	/** @var int $last_active_timestamp
+	 * Last active timestamp
+	 */
+	public $last_active_timestamp;
+
+	public static function fromArray(array $params)
+	{
+		$memberAurhenticateResponse = new self();
+
+		foreach ($params as $key => $value) {
+			if (property_exists($memberAurhenticateResponse, $key)) {
+				$memberAurhenticateResponse->{$key} = $value;
+			}
+		}
+
+		return $memberAurhenticateResponse;
+	}
 }
\ No newline at end of file

src/Route4Me/Members/MemberCapabilities.php

Indentation +24 added lines, -24 removed lines

@@ -7,51 +7,51 @@
  */
 class MemberCapabilities extends \Route4Me\Common
 {
-    /*
+	/*
      * Array of the avoidance zone IDs.
      */
-    public $avoid = [];
+	public $avoid = [];
 
-    /*
+	/*
      * Road avoid options: "Highways", "Tolls", "highways,tolls".
      */
-    public $avoid_roads = [];
+	public $avoid_roads = [];
 
-    /*
+	/*
      * Restriction options.
      */
-    public $features = [];
+	public $features = [];
 
-    /*
+	/*
      * Travel modes: "Highways", "Tolls", "highways,tolls".
      */
-    public $travelModes = [];
+	public $travelModes = [];
 
-    /*
+	/*
      * Navigate options
      */
-    public $navigateBy = [];
+	public $navigateBy = [];
 
-    /*
+	/*
      * Array of the license modules
      */
-    public $LicensedModules = [];
+	public $LicensedModules = [];
 
-    /*
+	/*
      * If true, the member subscription is commercial.
      */
-    public $commercial;
+	public $commercial;
 
-    public static function fromArray(array $params)
-    {
-        $memberCapabilities = new self();
+	public static function fromArray(array $params)
+	{
+		$memberCapabilities = new self();
 
-        foreach ($params as $key => $value) {
-            if (property_exists($memberCapabilities, $key)) {
-                $memberCapabilities->{$key} = $value;
-            }
-        }
+		foreach ($params as $key => $value) {
+			if (property_exists($memberCapabilities, $key)) {
+				$memberCapabilities->{$key} = $value;
+			}
+		}
 
-        return $memberCapabilities;
-    }
+		return $memberCapabilities;
+	}
 }

src/Route4Me/Members/MemberResponse.php

Indentation +406 added lines, -406 removed lines

@@ -9,411 +9,411 @@
  */
 class MemberResponse extends \Route4Me\Common
 {
-    /** @var boolean $authenticated
-     * A boolean flag indicating if the session is valid.
-     */
-    public $authenticated;
-
-    /** @var boolean $status
-     * Process status
-     */
-    public $status;
-
-    /** @var string $geocoding_service
-     * Geocoding service
-     */
-    public $geocoding_service;
-
-    /** @var string $session_id
-     * The integer session id of the current session.
-     */
-    public $session_id;
-
-    /** @var string $session_guid
-     * An MD5 hash string of the currently authenticated sesssion,
-     * important to use this with future requests.
-     */
-    public $session_guid;
-
-    /** @var string $member_first_name
-     * The first name of the user.
-     */
-    public $member_first_name;
-
-    /** @var string $member_last_name
-     * The last name of the user.
-     */
-    public $member_last_name;
-
-    /** @var int $member_timestamp_added
-     * The unix timestamp when the user joined the service.
-     */
-    public $member_timestamp_added;
-
-    /** @var string $industry
-     * The industry the authenticated user specified.
-     */
-    public $industry;
-
-    /** @var int $member_id
-     * Member ID
-     */
-    public $member_id;
-
-    /** @var string $member_email
-     * Member email
-     */
-    public $member_email;
-
-    /** @var boolean $is_trial
-     * If the user is currently a trial customer.
-     */
-    public $is_trial;
-
-    /** @var boolean $is_active
-     * If the user is currently an active customer.
-     */
-    public $is_active;
-
-    /** @var string $api_key
-     * User's API key
-     */
-    public $api_key;
-
-    /** @var int $tracking_ttl
-     * Tracking TTL
-     */
-    public $tracking_ttl;
-
-    /** @var boolean $hide_billing_section
-     * Hide billing section.
-     */
-    public $hide_billing_section;
-
-    /** @var string $last_known_member_payment_device
-     * Last known member payment device (e.g. 'web').
-     */
-    public $last_known_member_payment_device;
-
-    /** @var array $licensed_modules
-     * Licensed module. e.g.:
-     * 'MODULE__ROUTE_EDITOR_CUSTOM_DATA_EDITING',
-     * 'MODULE__VOICE_NAVIGATION:TRUE',
-     * 'MODULE__VOICE_NAVIGATION'
-     */
-    public $licensed_modules;
-
-    /** @var boolean $member_business_type
-     * Member business type (e.g. 'BUSINESS_EMPLOYEE').
-     */
-    public $member_business_type;
-
-    /** @var string $geofence_polygon_shape
-     * Geofence polygon shape. Available values:
-     * 'circle', 'poly', 'rect'.
-     */
-    public $geofence_polygon_shape;
-
-    /** @var int $geofence_polygon_size
-     * Geofence polygon size
-     */
-    public $geofence_polygon_size;
-
-    /** @var int $geofence_time_onsite_trigger_secs
-     * Geofence onsite trigger time (seconds).
-     */
-    public $geofence_time_onsite_trigger_secs;
-
-    /** @var int $geofence_minimum_trigger_speed
-     * Geofence's minimum trigger speed.
-     */
-    public $geofence_minimum_trigger_speed;
-
-    /** @var bool $is_subscription_past_due
-     * True if the subscription is past due.
-     */
-    public $is_subscription_past_due;
-
-    /** @var string $visited_departed_enabled
-     * If true, triggering of the visited and departed activities is enabled.
-     */
-    public $visited_departed_enabled;
-
-    /** @var string $long_press_enabled
-     * If true, long press is enabled.
-     */
-    public $long_press_enabled;
-
-    /** @var int $account_type_id
-     * The account type ID.
-     */
-    public $account_type_id;
-
-    /** @var string $current_price
-     * Current price (e.g. '0.000').
-     */
-    public $current_price;
-
-    /** @var int $initially_requested_account_type_id
-     * Initially Requested account type ID.
-     */
-    public $initially_requested_account_type_id;
-
-    /** @var string $account_type_alias
-     * Account type alias
-     */
-    public $account_type_alias;
-
-    /** @var string $member_type
-     * Member type. Available values:
-     * PRIMARY_ACCOUNT, SUB_ACCOUNT_ADMIN, SUB_ACCOUNT_REGIONAL_MANAGER,
-     * SUB_ACCOUNT_DISPATCHER, SUB_ACCOUNT_PLANNER, SUB_ACCOUNT_DRIVER,
-     * SUB_ACCOUNT_ANALYSTSUB_ACCOUNT_VENDORSUB_ACCOUNT_CUSTOMER_SERVICE
-     */
-    public $member_type;
-
-    /** @var string $OWNER_MEMBER_ID
-     * Parent user ID.
-     */
-    public $OWNER_MEMBER_ID;
-
-    /** @var string $ROOT_OWNER_MEMBER_ID
-     * Root owner member ID (e.g. '402088').
-     */
-    public $ROOT_OWNER_MEMBER_ID;
-
-    /** @var string $ROOT_OWNER_MEMBER_EMAIL
-     * Root owner member email.
-     */
-    public $ROOT_OWNER_MEMBER_EMAIL;
-
-    /** @var string $ROOT_OWNER_MEMBER_API_KEY
-     * Root owner member API key.
-     */
-    public $ROOT_OWNER_MEMBER_API_KEY;
-
-    /** @var string $geocodingMethod
-     * Geocoding method
-     */
-    public $geocodingMethod;
-
-    /** @var string $service_type
-     * Service type (e.g. 'pre5').
-     */
-    public $service_type;
-
-    /** @var string $validated_by
-     * Validated by (e.g. 'ADMIN_PANEL').
-     */
-    public $validated_by;
-
-    /** @var int $max_stops_per_route
-     * Maximum allowed number of the stops per route.
-     */
-    public $max_stops_per_route;
-
-    /** @var int $max_routes
-     * Maximum allowed number of the generated routes.
-     */
-    public $max_routes;
-
-    /** @var int $max_route
-     * Maximum allowed number of the generated routes.
-     */
-    public $max_route;
-
-    /** @var int $route_planned
-     * Planned route numbers
-     */
-    public $route_planned;
-
-    /** @var int $routes_planned
-     * Routes Planned
-     */
-    public $routes_planned;
-
-    /** @var int $total_routes_planned
-     * Total planned routes.
-     */
-    public $total_routes_planned;
-
-    /** @var int $authentication_count
-     * Authentication count.
-     */
-    public $authentication_count;
-
-    /** @var string $salesforce_unique_record_id
-     * Salesforce unique record ID.
-     */
-    public $salesforce_unique_record_id;
-
-    /** @var string $salesforce_account_id
-     * Salesforce account ID
-     */
-    public $salesforce_account_id;
-
-    /** @var string $salesforce_lead_id
-     * Salesforce lead ID
-     */
-    public $salesforce_lead_id;
-
-    /** @var int $max_api_optimization_addresses
-     * The maximun number of addresses the authenticated user
-     * can optimize in this billing cycle.
-     */
-    public $max_api_optimization_addresses;
-
-    /** @var int $max_api_geocoding_addresses
-     * The maximun number of geocodings the authenticated user
-     * can optimize in this billing cycle.
-     */
-    public $max_api_geocoding_addresses;
-
-    /** @var int $max_api_directions_addresses
-     * The maximum number of driving route transactions the authenticated
-     * user can execute in this billing cycle.
-     */
-    public $max_api_directions_addresses;
-
-    /** @var int $max_api_validation_addresses
-     * The maximun number of address validation transactions the authenticated
-     * user can execute in this billing cycle.
-     */
-    public $max_api_validation_addresses;
-
-    /** @var int $max_stops_per_unoptimized_route
-     * The maximum number of stops the authenticated user
-     * can put into a route with optimization disabled.
-     */
-    public $max_stops_per_unoptimized_route;
-
-    /** @var int $max_api_distance_tx
-     * The maximum number of distance transactions the authenticated
-     * user can execute in this billing cycle.
-     */
-    public $max_api_distance_tx;
-
-    /** @var boolean $blDisplayUpgradeTrackingHTML
-     * Display upgrade tracking HTML.
-     */
-    public $blDisplayUpgradeTrackingHTML;
-
-    /** @var int $intTrackingTrigger
-     * Tracking trigger (int).
-     */
-    public $intTrackingTrigger;
-
-    /** @var int $last_payment_ts
-     * The last unix timestamp when this user was successfully charged.
-     */
-    public $last_payment_ts;
-
-    /** @var int $last_failed_payment_ts
-     * The last unix timestamp when this user was failed to pay.
-     */
-    public $last_failed_payment_ts;
-
-    /** @var int $account_expires_timestamp
-     * Account expire date
-     */
-    public $account_expires_timestamp;
-
-    /** @var boolean $account_past_due
-     * Account past due
-     */
-    public $account_past_due;
-
-    /** @var string $ui_input_method
-     * UI input method
-     */
-    public $ui_input_method;
-
-    /** @var string $registration_app
-     * Registration application
-     */
-    public $registration_app;
-
-    /** @var string $registration_device
-     * Registration device
-     */
-    public $registration_device;
-
-    /** @var string $preferred_units
-     * Preferred units (mi, km)
-     */
-    public $preferred_units;
-
-    /** @var string $preferred_language
-     * Preferred language (en, fr)
-     */
-    public $preferred_language;
-
-    /** @var string $hide_routed_addresses
-     * If true, routed addresses will be hidden.
-     */
-    public $hide_routed_addresses;
-
-    /** @var string $show_superuser_addresses
-     * Show superuser addresses ('0', '1').
-     */
-    public $show_superuser_addresses;
-
-    /** @var string $appdirect_url
-     * Application direction URL
-     */
-    public $appdirect_url;
-
-    /** @var int $timestamp_trial_expiration
-     * Timestamp trial expiration
-     */
-    public $timestamp_trial_expiration;
-
-    /** @var string $update_channel_name
-     * Update channel name
-     */
-    public $update_channel_name;
-
-    /** @var int $max_subusers_cnt
-     * Maximum subusers count
-     */
-    public $max_subusers_cnt;
-
-    /** @var string $hide_visited_addresses
-     * If true, visited addresses will be hidden.
-     */
-    public $hide_visited_addresses;
-
-    /** @var string $HIDE_NONFUTURE_ROUTES
-     * If true, nonfuture routes will be hidden.
-     */
-    public $HIDE_NONFUTURE_ROUTES;
-
-    /** @var string $display_max_routes_future_days
-     * Display maximum routes future days ('0', '1').
-     */
-    public $display_max_routes_future_days;
-
-    /** @var string $READONLY_USER
-     * Readonly uer ('0', '1').
-     */
-    public $READONLY_USER;
-
-    /** @var int $auto_logout_ts
-     * Time in seconds. A user will be logged out after been inactive during specified by this parameter seconds.
-     */
-    public $auto_logout_ts;
-
-    public static function fromArray(array $params)
-    {
-        $memberResponse = new self();
-
-        foreach ($params as $key => $value) {
-            if (property_exists($memberResponse, $key)) {
-                $memberResponse->{$key} = $value;
-            }
-        }
-
-        return $memberResponse;
-    }
+	/** @var boolean $authenticated
+	 * A boolean flag indicating if the session is valid.
+	 */
+	public $authenticated;
+
+	/** @var boolean $status
+	 * Process status
+	 */
+	public $status;
+
+	/** @var string $geocoding_service
+	 * Geocoding service
+	 */
+	public $geocoding_service;
+
+	/** @var string $session_id
+	 * The integer session id of the current session.
+	 */
+	public $session_id;
+
+	/** @var string $session_guid
+	 * An MD5 hash string of the currently authenticated sesssion,
+	 * important to use this with future requests.
+	 */
+	public $session_guid;
+
+	/** @var string $member_first_name
+	 * The first name of the user.
+	 */
+	public $member_first_name;
+
+	/** @var string $member_last_name
+	 * The last name of the user.
+	 */
+	public $member_last_name;
+
+	/** @var int $member_timestamp_added
+	 * The unix timestamp when the user joined the service.
+	 */
+	public $member_timestamp_added;
+
+	/** @var string $industry
+	 * The industry the authenticated user specified.
+	 */
+	public $industry;
+
+	/** @var int $member_id
+	 * Member ID
+	 */
+	public $member_id;
+
+	/** @var string $member_email
+	 * Member email
+	 */
+	public $member_email;
+
+	/** @var boolean $is_trial
+	 * If the user is currently a trial customer.
+	 */
+	public $is_trial;
+
+	/** @var boolean $is_active
+	 * If the user is currently an active customer.
+	 */
+	public $is_active;
+
+	/** @var string $api_key
+	 * User's API key
+	 */
+	public $api_key;
+
+	/** @var int $tracking_ttl
+	 * Tracking TTL
+	 */
+	public $tracking_ttl;
+
+	/** @var boolean $hide_billing_section
+	 * Hide billing section.
+	 */
+	public $hide_billing_section;
+
+	/** @var string $last_known_member_payment_device
+	 * Last known member payment device (e.g. 'web').
+	 */
+	public $last_known_member_payment_device;
+
+	/** @var array $licensed_modules
+	 * Licensed module. e.g.:
+	 * 'MODULE__ROUTE_EDITOR_CUSTOM_DATA_EDITING',
+	 * 'MODULE__VOICE_NAVIGATION:TRUE',
+	 * 'MODULE__VOICE_NAVIGATION'
+	 */
+	public $licensed_modules;
+
+	/** @var boolean $member_business_type
+	 * Member business type (e.g. 'BUSINESS_EMPLOYEE').
+	 */
+	public $member_business_type;
+
+	/** @var string $geofence_polygon_shape
+	 * Geofence polygon shape. Available values:
+	 * 'circle', 'poly', 'rect'.
+	 */
+	public $geofence_polygon_shape;
+
+	/** @var int $geofence_polygon_size
+	 * Geofence polygon size
+	 */
+	public $geofence_polygon_size;
+
+	/** @var int $geofence_time_onsite_trigger_secs
+	 * Geofence onsite trigger time (seconds).
+	 */
+	public $geofence_time_onsite_trigger_secs;
+
+	/** @var int $geofence_minimum_trigger_speed
+	 * Geofence's minimum trigger speed.
+	 */
+	public $geofence_minimum_trigger_speed;
+
+	/** @var bool $is_subscription_past_due
+	 * True if the subscription is past due.
+	 */
+	public $is_subscription_past_due;
+
+	/** @var string $visited_departed_enabled
+	 * If true, triggering of the visited and departed activities is enabled.
+	 */
+	public $visited_departed_enabled;
+
+	/** @var string $long_press_enabled
+	 * If true, long press is enabled.
+	 */
+	public $long_press_enabled;
+
+	/** @var int $account_type_id
+	 * The account type ID.
+	 */
+	public $account_type_id;
+
+	/** @var string $current_price
+	 * Current price (e.g. '0.000').
+	 */
+	public $current_price;
+
+	/** @var int $initially_requested_account_type_id
+	 * Initially Requested account type ID.
+	 */
+	public $initially_requested_account_type_id;
+
+	/** @var string $account_type_alias
+	 * Account type alias
+	 */
+	public $account_type_alias;
+
+	/** @var string $member_type
+	 * Member type. Available values:
+	 * PRIMARY_ACCOUNT, SUB_ACCOUNT_ADMIN, SUB_ACCOUNT_REGIONAL_MANAGER,
+	 * SUB_ACCOUNT_DISPATCHER, SUB_ACCOUNT_PLANNER, SUB_ACCOUNT_DRIVER,
+	 * SUB_ACCOUNT_ANALYSTSUB_ACCOUNT_VENDORSUB_ACCOUNT_CUSTOMER_SERVICE
+	 */
+	public $member_type;
+
+	/** @var string $OWNER_MEMBER_ID
+	 * Parent user ID.
+	 */
+	public $OWNER_MEMBER_ID;
+
+	/** @var string $ROOT_OWNER_MEMBER_ID
+	 * Root owner member ID (e.g. '402088').
+	 */
+	public $ROOT_OWNER_MEMBER_ID;
+
+	/** @var string $ROOT_OWNER_MEMBER_EMAIL
+	 * Root owner member email.
+	 */
+	public $ROOT_OWNER_MEMBER_EMAIL;
+
+	/** @var string $ROOT_OWNER_MEMBER_API_KEY
+	 * Root owner member API key.
+	 */
+	public $ROOT_OWNER_MEMBER_API_KEY;
+
+	/** @var string $geocodingMethod
+	 * Geocoding method
+	 */
+	public $geocodingMethod;
+
+	/** @var string $service_type
+	 * Service type (e.g. 'pre5').
+	 */
+	public $service_type;
+
+	/** @var string $validated_by
+	 * Validated by (e.g. 'ADMIN_PANEL').
+	 */
+	public $validated_by;
+
+	/** @var int $max_stops_per_route
+	 * Maximum allowed number of the stops per route.
+	 */
+	public $max_stops_per_route;
+
+	/** @var int $max_routes
+	 * Maximum allowed number of the generated routes.
+	 */
+	public $max_routes;
+
+	/** @var int $max_route
+	 * Maximum allowed number of the generated routes.
+	 */
+	public $max_route;
+
+	/** @var int $route_planned
+	 * Planned route numbers
+	 */
+	public $route_planned;
+
+	/** @var int $routes_planned
+	 * Routes Planned
+	 */
+	public $routes_planned;
+
+	/** @var int $total_routes_planned
+	 * Total planned routes.
+	 */
+	public $total_routes_planned;
+
+	/** @var int $authentication_count
+	 * Authentication count.
+	 */
+	public $authentication_count;
+
+	/** @var string $salesforce_unique_record_id
+	 * Salesforce unique record ID.
+	 */
+	public $salesforce_unique_record_id;
+
+	/** @var string $salesforce_account_id
+	 * Salesforce account ID
+	 */
+	public $salesforce_account_id;
+
+	/** @var string $salesforce_lead_id
+	 * Salesforce lead ID
+	 */
+	public $salesforce_lead_id;
+
+	/** @var int $max_api_optimization_addresses
+	 * The maximun number of addresses the authenticated user
+	 * can optimize in this billing cycle.
+	 */
+	public $max_api_optimization_addresses;
+
+	/** @var int $max_api_geocoding_addresses
+	 * The maximun number of geocodings the authenticated user
+	 * can optimize in this billing cycle.
+	 */
+	public $max_api_geocoding_addresses;
+
+	/** @var int $max_api_directions_addresses
+	 * The maximum number of driving route transactions the authenticated
+	 * user can execute in this billing cycle.
+	 */
+	public $max_api_directions_addresses;
+
+	/** @var int $max_api_validation_addresses
+	 * The maximun number of address validation transactions the authenticated
+	 * user can execute in this billing cycle.
+	 */
+	public $max_api_validation_addresses;
+
+	/** @var int $max_stops_per_unoptimized_route
+	 * The maximum number of stops the authenticated user
+	 * can put into a route with optimization disabled.
+	 */
+	public $max_stops_per_unoptimized_route;
+
+	/** @var int $max_api_distance_tx
+	 * The maximum number of distance transactions the authenticated
+	 * user can execute in this billing cycle.
+	 */
+	public $max_api_distance_tx;
+
+	/** @var boolean $blDisplayUpgradeTrackingHTML
+	 * Display upgrade tracking HTML.
+	 */
+	public $blDisplayUpgradeTrackingHTML;
+
+	/** @var int $intTrackingTrigger
+	 * Tracking trigger (int).
+	 */
+	public $intTrackingTrigger;
+
+	/** @var int $last_payment_ts
+	 * The last unix timestamp when this user was successfully charged.
+	 */
+	public $last_payment_ts;
+
+	/** @var int $last_failed_payment_ts
+	 * The last unix timestamp when this user was failed to pay.
+	 */
+	public $last_failed_payment_ts;
+
+	/** @var int $account_expires_timestamp
+	 * Account expire date
+	 */
+	public $account_expires_timestamp;
+
+	/** @var boolean $account_past_due
+	 * Account past due
+	 */
+	public $account_past_due;
+
+	/** @var string $ui_input_method
+	 * UI input method
+	 */
+	public $ui_input_method;
+
+	/** @var string $registration_app
+	 * Registration application
+	 */
+	public $registration_app;
+
+	/** @var string $registration_device
+	 * Registration device
+	 */
+	public $registration_device;
+
+	/** @var string $preferred_units
+	 * Preferred units (mi, km)
+	 */
+	public $preferred_units;
+
+	/** @var string $preferred_language
+	 * Preferred language (en, fr)
+	 */
+	public $preferred_language;
+
+	/** @var string $hide_routed_addresses
+	 * If true, routed addresses will be hidden.
+	 */
+	public $hide_routed_addresses;
+
+	/** @var string $show_superuser_addresses
+	 * Show superuser addresses ('0', '1').
+	 */
+	public $show_superuser_addresses;
+
+	/** @var string $appdirect_url
+	 * Application direction URL
+	 */
+	public $appdirect_url;
+
+	/** @var int $timestamp_trial_expiration
+	 * Timestamp trial expiration
+	 */
+	public $timestamp_trial_expiration;
+
+	/** @var string $update_channel_name
+	 * Update channel name
+	 */
+	public $update_channel_name;
+
+	/** @var int $max_subusers_cnt
+	 * Maximum subusers count
+	 */
+	public $max_subusers_cnt;
+
+	/** @var string $hide_visited_addresses
+	 * If true, visited addresses will be hidden.
+	 */
+	public $hide_visited_addresses;
+
+	/** @var string $HIDE_NONFUTURE_ROUTES
+	 * If true, nonfuture routes will be hidden.
+	 */
+	public $HIDE_NONFUTURE_ROUTES;
+
+	/** @var string $display_max_routes_future_days
+	 * Display maximum routes future days ('0', '1').
+	 */
+	public $display_max_routes_future_days;
+
+	/** @var string $READONLY_USER
+	 * Readonly uer ('0', '1').
+	 */
+	public $READONLY_USER;
+
+	/** @var int $auto_logout_ts
+	 * Time in seconds. A user will be logged out after been inactive during specified by this parameter seconds.
+	 */
+	public $auto_logout_ts;
+
+	public static function fromArray(array $params)
+	{
+		$memberResponse = new self();
+
+		foreach ($params as $key => $value) {
+			if (property_exists($memberResponse, $key)) {
+				$memberResponse->{$key} = $value;
+			}
+		}
+
+		return $memberResponse;
+	}
 
 }
\ No newline at end of file