fixed the examples

Minor cleanup, removed duplicate timeout vars & replaced with float [sec], added socket Tout setter
cleanup
2016-11-20 11:29:09 +01:00 · 2016-11-18 16:06:15 +01:00 · 2016-11-05 18:00:41 +02:00 · 2016-11-05 17:57:19 +02:00 · 2016-11-04 22:02:04 +02:00 · 2016-03-11 23:11:21 +01:00
20 changed files with 1992 additions and 1845 deletions
@@ -1,4 +1,5 @@
 /vendor
 composer.lock
+.idea/

 *~
@@ -2,15 +2,15 @@

 Implementation of the basic functionality of the Modbus TCP and UDP based protocol using PHP. 

-This is a fork of the original project at https://code.google.com/p/phpmodbus/
+**NOTE: This is a fork to fix & update the library code (and code alone). Notably, the tests are probably all broken.**

 > **What's new**
 > 
 > This fork adds a namespace and fixes issues encountered when porting to PHP 7

-**WARNING: Everything except the actual code in this repo may be broken and outdated.**

-Implemented features:
+## Implemented features
+
 * Modbus master
 * FC1 - Read coils 
 * FC2 - Read input discretes
@@ -22,18 +22,24 @@ Implemented features:
 * FC16 - Write multiple registers
 * FC23 - Read/Write multiple registers

-Example:
+
+## Requirements
+
+ * The PHP extension php_sockets.dll should be enabled (server php.ini file)
+
+ 
+## Example

 ```php
-require_once dirname(__FILE__) . '/Phpmodbus/ModbusMaster.php'; 
+use PHPModbus/ModbusMaster; 
+use PHPModbus/PhpType; 

 // Modbus master UDP
 $modbus = new ModbusMaster("192.168.1.1", "UDP"); 
 // Read multiple registers
 try {
    $recData = $modbus->readMultipleRegisters(0, 12288, 5); 
-}
-catch (Exception $e) {
+} catch (Exception $e) {
    // Print error information if any
    echo $modbus;
    echo $e;
@@ -43,7 +49,14 @@ catch (Exception $e) {
 echo PhpType::bytes2string($recData); 
 ```

-For more see [http://code.google.com/p/phpmodbus/downloads/list documentation] or [http://code.google.com/p/phpmodbus/wiki/FAQ FAQ].
+Use the `setTimeout($seconds)` and `setSocketTimeout($read_timeout_sec, $write_timeout_sec)` methods to adjust wait times.
+
+Most of the code is (to some extent) commented and documented with PhpDoc. You should get useful tooltips in your IDE.
+
+
+## GoogleCode legacy docs & downloads
+
+This project was originally hosted on (now defunct) Google Code. It's still archived here:
+
+* [GoogleCode Archived Repo](http://code.google.com/p/phpmodbus)

-Note: 
- * The PHP extension php_sockets.dll should be enabled (server php.ini file)
@@ -1,5 +1,5 @@
 {
-  "name": "MightyPork/phpmodbus",
+  "name": "mightypork/phpmodbus",
  "keywords": ["phpmodbus","modbus"],
  "description": "PhpModbus with namespaces and updated to PHP 7",
  "license": "LGPL",
@@ -11,6 +11,10 @@
    {
      "name": "Honza Krakora",
      "email": "krakora.jan@googlemail.com"
+    },
+    {
+      "name": "Ondřej Hruška",
+      "email": "ondra@ondrovo.com"
    }
  ],
  "autoload": {
@@ -1,6 +1,6 @@
 <?php

-require_once dirname(__FILE__) . '/../Phpmodbus/ModbusMaster.php';
+use PHPModbus\ModbusMaster;

 // Create Modbus object
 $ip = "192.192.15.51";
@@ -13,8 +13,7 @@ try {
 	$mw0address = 12288;
 	$quantity = 6;
 	$recData = $modbus->readMultipleRegisters($moduleId, $reference, $quantity);
-}
-catch (Exception $e) {
+} catch (Exception $e) {
 	echo $modbus;
 	echo $e;
 	exit;
@@ -31,10 +30,10 @@ catch (Exception $e) {
 	<h1>Dump of M-memory from WAGO 750-84x series coupler.</h1>
 	<ul>
 		<li>PLC: 750-84x series</li>
-            <li>IP: <?php echo $ip?></li>
-            <li>Modbus module ID: <?php echo $moduleId?></li>
-            <li>Modbus memory reference: <?php echo $reference?></li>
-            <li>Modbus memory quantity: <?php echo $quantity?></li>
+		<li>IP: <?php echo $ip ?></li>
+		<li>Modbus module ID: <?php echo $moduleId ?></li>
+		<li>Modbus memory reference: <?php echo $reference ?></li>
+		<li>Modbus memory quantity: <?php echo $quantity ?></li>
 	</ul>

 	<h2>M-memory dump</h2>
@@ -46,12 +45,12 @@ catch (Exception $e) {
 			<td>value</td>
 		</tr>
 		<?php
-            for($i=0;$i<count($recData);$i+=2) {
+		for ($i = 0; $i < count($recData); $i += 2) {
 			?>
 			<tr>
-                <td><?php echo $i+$reference?></td>
-                <td>MW<?php echo ($i + $reference - $mw0address)/2?></td>
-                <td><?php echo ($recData[$i] << 8)+ $recData[$i+1]?></td>
+				<td><?php echo $i + $reference ?></td>
+				<td>MW<?php echo ($i + $reference - $mw0address) / 2 ?></td>
+				<td><?php echo ($recData[$i] << 8) + $recData[$i + 1] ?></td>
 			</tr>
 			<?php
 		}
@@ -59,9 +58,8 @@ catch (Exception $e) {
 	</table>

 	<h2>Modbus class status</h2>
-        <?php
-        echo $modbus;
-        ?>
+
+	<pre><?= $modbus ?></pre>

 	</body>
 </html>
@@ -1,6 +1,7 @@
 <?php

-require_once dirname(__FILE__) . '/../Phpmodbus/ModbusMaster.php';
+use PHPModbus\ModbusMaster;
+use PHPModbus\PhpType;

 // Create Modbus object
 $modbus = new ModbusMaster("192.192.15.51", "UDP");
@@ -9,8 +10,7 @@ try {
 	// FC 3
 	// read 10 words (20 bytes) from device ID=0, address=12288
 	$recData = $modbus->readMultipleRegisters(0, 12288, 10);
-}
-catch (Exception $e) {
+} catch (Exception $e) {
 	// Print error information if any
 	echo $modbus;
 	echo $e;
@@ -28,17 +28,17 @@ $values = array_chunk($recData, 4);

 // Get float from REAL interpretation
 echo "<h3>REAL to Float</h3>\n";
-foreach($values as $bytes)
+foreach ($values as $bytes)
 	echo PhpType::bytes2float($bytes) . "</br>";

 // Get integer from DINT interpretation
 echo "<h3>DINT to integer </h3>\n";
-foreach($values as $bytes)
+foreach ($values as $bytes)
 	echo PhpType::bytes2signedInt($bytes) . "</br>";

 // Get integer of float from DINT interpretation
 echo "<h3>DWORD to integer (or float) </h3>\n";
-foreach($values as $bytes)
+foreach ($values as $bytes)
 	echo PhpType::bytes2unsignedInt($bytes) . "</br>";

 echo "<h2>16 bit types</h2>\n";
@@ -47,15 +47,14 @@ $values = array_chunk($recData, 2);

 // Get signed integer from INT interpretation
 echo "<h3>INT to integer </h3>\n";
-foreach($values as $bytes)
+foreach ($values as $bytes)
 	echo PhpType::bytes2signedInt($bytes) . "</br>";

 // Get unsigned integer from WORD interpretation
 echo "<h3>WORD to integer </h3>\n";
-foreach($values as $bytes)
+foreach ($values as $bytes)
 	echo PhpType::bytes2unsignedInt($bytes) . "</br>";

 // Get string from STRING interpretation
 echo "<h3>STRING to string </h3>\n";
 echo PhpType::bytes2string($recData) . "</br>";
-?>
@@ -1,6 +1,6 @@
 <?php

-require_once dirname(__FILE__) . '/../Phpmodbus/ModbusMaster.php';
+use PHPModbus\ModbusMaster;

 // Create Modbus object
 $modbus = new ModbusMaster("192.192.15.51", "UDP");
@@ -8,8 +8,7 @@ $modbus = new ModbusMaster("192.192.15.51", "UDP");
 try {
 	// FC 1
 	$recData = $modbus->readCoils(0, 12288, 12);
-}
-catch (Exception $e) {
+} catch (Exception $e) {
 	// Print error information if any
 	echo $modbus;
 	echo $e;
@@ -1,21 +1,22 @@
 <?php

-require_once dirname(__FILE__) . '/../Phpmodbus/ModbusMaster.php';
+use PHPModbus\ModbusMaster;

 // Create Modbus object
 $modbus = new ModbusMaster("192.192.15.51", "UDP");

-// Data to be writen
-$data = array(TRUE, FALSE, TRUE, TRUE, FALSE, TRUE, TRUE, TRUE, 
-              TRUE, TRUE, TRUE, TRUE, FALSE, FALSE, FALSE, FALSE,
-              FALSE, FALSE, FALSE, FALSE, TRUE, TRUE, TRUE, TRUE,
-              TRUE, TRUE, TRUE, TRUE, TRUE, TRUE, TRUE, TRUE);
+// Data to be written - supports both 0/1 and booleans (true, false)
+$data = array(
+	1, 0, 1, 1, 0, 1, 1, 1,
+	1, 1, 1, 1, 0, 0, 0, 0,
+	0, 0, 0, 0, 1, 1, 1, 1,
+	1, 1, 1, 1, 1, 1, 1, 1,
+);

 try {
 	// FC15
 	$modbus->writeMultipleCoils(0, 12288, $data);
-}
-catch (Exception $e) {
+} catch (Exception $e) {
 	// Print error information if any
 	echo $modbus;
 	echo $e;
@@ -1,6 +1,6 @@
 <?php

-require_once dirname(__FILE__) . '/../Phpmodbus/ModbusMaster.php';
+use PHPModbus\ModbusMaster;

 // Create Modbus object
 $modbus = new ModbusMaster("192.192.15.51", "UDP");
@@ -12,8 +12,7 @@ $dataTypes = array("WORD", "INT", "DINT", "REAL");
 try {
 	// FC16
 	$modbus->writeMultipleRegister(0, 12288, $data, $dataTypes);
-}
-catch (Exception $e) {
+} catch (Exception $e) {
 	// Print error information if any
 	echo $modbus;
 	echo $e;
@@ -1,6 +1,6 @@
 <?php

-require_once dirname(__FILE__) . '/../Phpmodbus/ModbusMaster.php';
+use PHPModbus\ModbusMaster;

 // Create Modbus object
 $modbus = new ModbusMaster("192.192.15.51", "UDP");
@@ -9,8 +9,7 @@ try {
 	// FC 2
 	// read 2 input bits from address 0x0 (Wago input image)
 	$recData = $modbus->readInputDiscretes(0, 0, 2);
-}
-catch (Exception $e) {
+} catch (Exception $e) {
 	// Print error information if any
 	echo $modbus;
 	echo $e;
@@ -1,6 +1,6 @@
 <?php

-require_once dirname(__FILE__) . '/../Phpmodbus/ModbusMaster.php';
+use PHPModbus\ModbusMaster;

 // Create Modbus object
 $modbus = new ModbusMaster("192.192.15.51", "UDP");
@@ -8,14 +8,13 @@ $modbus = new ModbusMaster("192.192.15.51", "UDP");
 // Data to be writen
 $bitValue = true;
 $bitNumber = 2;
-$andMask =  0xFFFF ^ pow(2, $bitNumber) ;
-$orMask =  0x0000 ^ (pow(2, $bitNumber) * $bitValue ) ;
+$andMask = 0xFFFF ^ pow(2, $bitNumber);
+$orMask = 0x0000 ^ (pow(2, $bitNumber) * $bitValue);

 try {
 	// FC22
 	$modbus->maskWriteRegister(0, 12288, $andMask, $orMask);
-}
-catch (Exception $e) {
+} catch (Exception $e) {
 	// Print error information if any
 	echo $modbus;
 	echo $e;
@@ -24,5 +23,3 @@ catch (Exception $e) {

 // Print status information
 echo $modbus;
-
-?>
@@ -1,6 +1,6 @@
 <?php

-require_once dirname(__FILE__) . '/../Phpmodbus/ModbusMaster.php';
+use PHPModbus\ModbusMaster;

 // Create Modbus object
 $modbus = new ModbusMaster("192.192.15.51", "UDP");
@@ -12,8 +12,7 @@ $dataTypes = array("WORD", "INT", "DINT", "REAL");
 try {
 	// FC23
 	$recData = $modbus->readWriteRegisters(0, 12288, 6, 12288, $data, $dataTypes);
-}
-catch (Exception $e) {
+} catch (Exception $e) {
 	// Print error information if any
 	echo $modbus;
 	echo $e;
@@ -27,5 +26,3 @@ echo "</br>Status:</br>" . $modbus;
 echo "</br>Data:</br>";
 print_r($recData);
 echo "</br>";
-
-?>
@@ -1,6 +1,6 @@
 <?php

-require_once dirname(__FILE__) . '/../Phpmodbus/ModbusMaster.php';
+use PHPModbus\ModbusMaster;

 // Create Modbus object
 $modbus = new ModbusMaster("192.192.15.51", "UDP");
@@ -8,8 +8,7 @@ $modbus = new ModbusMaster("192.192.15.51", "UDP");
 try {
 	// FC 3
 	$recData = $modbus->readMultipleRegisters(0, 12288, 6);
-}
-catch (Exception $e) {
+} catch (Exception $e) {
 	// Print error information if any
 	echo $modbus;
 	echo $e;
@@ -23,4 +22,3 @@ echo "</br>Status:</br>" . $modbus;
 echo "</br>Data:</br>";
 print_r($recData);
 echo "</br>";
-?>
@@ -1,6 +1,6 @@
 <?php

-require_once dirname(__FILE__) . '/../../Phpmodbus/ModbusMasterUdp.php';
+use PHPModbus\ModbusMasterUdp;

 // Create Modbus object
 $modbus = new ModbusMasterUdp("192.192.15.51");
@@ -8,8 +8,7 @@ $modbus = new ModbusMasterUdp("192.192.15.51");
 try {
 	// Read input discretes - FC 4
 	$recData = $modbus->readMultipleInputRegisters(0, 0, 2);
-}
-catch (Exception $e) {
+} catch (Exception $e) {
 	// Print error information if any
 	echo $modbus;
 	echo $e;
@@ -1,13 +1,13 @@
 <?php

-require_once dirname(__FILE__) . '/../../Phpmodbus/ModbusMasterUdp.php';
+use PHPModbus\ModbusMasterUdp;

 // Create Modbus object
 $modbus = new ModbusMasterUdp("192.192.15.51");

 // Data to be writen - TRUE, FALSE
-$data_true = array(TRUE);
-$data_false = array(FALSE);
+$data_true = array(true);
+$data_false = array(false);

 try {
 	// Write single coil - FC5
@@ -15,8 +15,7 @@ try {
 	$modbus->writeSingleCoil(0, 12289, $data_false);
 	$modbus->writeSingleCoil(0, 12290, $data_true);
 	$modbus->writeSingleCoil(0, 12291, $data_false);
-}
-catch (Exception $e) {
+} catch (Exception $e) {
 	// Print error information if any
 	echo $modbus;
 	echo $e;
@@ -1,19 +1,17 @@
 <?php

-require_once dirname(__FILE__) . '/../Phpmodbus/ModbusMaster.php';
+use PHPModbus\ModbusMaster;

 // Create Modbus object
 $modbus = new ModbusMaster("192.192.15.51", "UDP");

 // Data to be writen
 $data = array(-1000);
-$dataTypes = array("INT");

 try {
 	// FC6
-    $modbus->writeSingleRegister(0, 12288, $data, $dataTypes);
-}
-catch (Exception $e) {
+	$modbus->writeSingleRegister(0, 12288, $data);
+} catch (Exception $e) {
 	// Print error information if any
 	echo $modbus;
 	echo $e;
@@ -22,5 +20,3 @@ catch (Exception $e) {

 // Print status information
 echo $modbus;
-
-?>
@@ -26,18 +26,19 @@ namespace PHPModbus;
 * @copyright  Copyright (c) 2004, 2010 Jan Krakora
 * @package    Phpmodbus
 */
-class IecType {
-
+class IecType
+{
 	/**
 	 * iecBYTE
 	 *
 	 * Converts a value to IEC-1131 BYTE data type
 	 *
-     * @param value value from 0 to 255
-     * @return value IEC BYTE data type
+	 * @param int $value from 0 to 255
+	 * @return int IEC BYTE data type
 	 *
 	 */
-    public static function iecBYTE($value) {
+	public static function iecBYTE($value)
+	{
 		return chr($value & 0xFF);
 	}

@@ -46,11 +47,12 @@ class IecType {
 	 *
 	 * Converts a value to IEC-1131 INT data type
 	 *
-     * @param value value to be converted
-     * @return value IEC-1131 INT data type
+	 * @param int $value to be converted
+	 * @return int IEC-1131 INT data type
 	 *
 	 */
-    public static function iecINT($value) {
+	public static function iecINT($value)
+	{
 		return self::iecBYTE(($value >> 8) & 0x00FF) .
 		self::iecBYTE(($value & 0x00FF));
 	}
@@ -60,14 +62,15 @@ class IecType {
 	 *
 	 * Converts a value to IEC-1131 DINT data type
 	 *
-     * @param value value to be converted
-     * @param value endianness defines endian codding (little endian == 0, big endian == 1)
-     * @return value IEC-1131 INT data type
+	 * @param int $value     to be converted
+	 * @param int $bigEndian defines endian codding (little endian == 0, big endian == 1)
+	 * @return int IEC-1131 INT data type
 	 *
 	 */
-    public static function iecDINT($value, $endianness = 0) {
+	public static function iecDINT($value, $bigEndian = 0)
+	{
 		// result with right endianness
-        return self::endianness($value, $endianness);
+		return self::endianness($value, $bigEndian);
 	}

 	/**
@@ -75,15 +78,16 @@ class IecType {
 	 *
 	 * Converts a value to IEC-1131 REAL data type. The function uses function  @use float2iecReal.
 	 *
-     * @param value value to be converted
-     * @param value endianness defines endian codding (little endian == 0, big endian == 1)
-     * @return value IEC-1131 REAL data type
+	 * @param int  $value     to be converted
+	 * @param bool $bigEndian defines endian codding (little endian == 0, big endian == 1)
+	 * @return int IEC-1131 REAL data type
 	 */
-    public static function iecREAL($value, $endianness = 0) {
+	public static function iecREAL($value, $bigEndian = 0)
+	{
 		// iecREAL representation
 		$real = self::float2iecReal($value);
 		// result with right endianness
-        return self::endianness($real, $endianness);
+		return self::endianness($real, $bigEndian);
 	}

 	/**
@@ -92,13 +96,15 @@ class IecType {
 	 * This function converts float value to IEC-1131 REAL single precision form.
 	 *
 	 * For more see [{@link http://en.wikipedia.org/wiki/Single_precision Single precision on Wiki}] or
-     * [{@link http://de.php.net/manual/en/function.base-convert.php PHP base_convert function commentary}, Todd Stokes @ Georgia Tech 21-Nov-2007] or
+	 * [{@link http://de.php.net/manual/en/function.base-convert.php PHP base_convert function commentary}, Todd Stokes
+	 * @ Georgia Tech 21-Nov-2007] or
 	 * [{@link http://www.php.net/manual/en/function.pack.php PHP pack/unpack functionality}]
 	 *
-     * @param float value to be converted
-     * @return value IEC REAL data type
+	 * @param float $value to be converted
+	 * @return int IEC REAL data type
 	 */
-    private static function float2iecReal($value) {
+	private static function float2iecReal($value)
+	{
 		// get float binary string
 		$float = pack("f", $value);
 		// set 32-bit unsigned integer of the float
@@ -113,24 +119,23 @@ class IecType {
 	 * For more see http://en.wikipedia.org/wiki/Endianness
 	 *
 	 * @param int  $value
-     * @param bool $endianness
+	 * @param bool $bigEndian
 	 * @return int
 	 */
-    private static function endianness($value, $endianness = 0) {
-        if ($endianness == 0)
+	private static function endianness($value, $bigEndian = 0)
+	{
+		if ($bigEndian == 0) {
 			return
 				self::iecBYTE(($value >> 8) & 0x000000FF) .
 				self::iecBYTE(($value & 0x000000FF)) .
 				self::iecBYTE(($value >> 24) & 0x000000FF) .
 				self::iecBYTE(($value >> 16) & 0x000000FF);
-        else
+		} else {
 			return
 				self::iecBYTE(($value >> 24) & 0x000000FF) .
 				self::iecBYTE(($value >> 16) & 0x000000FF) .
 				self::iecBYTE(($value >> 8) & 0x000000FF) .
 				self::iecBYTE(($value & 0x000000FF));
 		}
-
+	}
 }
-
-?>
@@ -35,7 +35,8 @@ namespace PHPModbus;
 * @package    Phpmodbus
 *
 */
-class ModbusMasterTcp extends ModbusMaster {
+class ModbusMasterTcp extends ModbusMaster
+{
 	/**
 	 * ModbusMasterTcp
 	 *
@@ -43,8 +44,8 @@ class ModbusMasterTcp extends ModbusMaster {
 	 *
 	 * @param String $host An IP address of a Modbus TCP device. E.g. "192.168.1.1".
 	 */
-  function ModbusMasterTcp($host){
-    $this->host = $host;
-    $this->socket_protocol = "TCP";
+	public function __construct($host)
+	{
+		parent::__construct($host, "TCP");
 	}
 }
@@ -35,8 +35,8 @@ namespace PHPModbus;
 * @package    Phpmodbus
 *
 */
-class ModbusMasterUdp extends ModbusMaster {
-  
+class ModbusMasterUdp extends ModbusMaster
+{
 	/**
 	 * ModbusMasterUdp
 	 *
@@ -44,8 +44,8 @@ class ModbusMasterUdp extends ModbusMaster {
 	 *
 	 * @param String $host An IP address of a Modbus UDP device. E.g. "192.168.1.1".
 	 */
-  function ModbusMasterUdp($host){
-    $this->host = $host;
-    $this->socket_protocol = "UDP";    
+	public function __construct($host)
+	{
+		parent::__construct($host, "UDP");
 	}
 }
@@ -1,6 +1,7 @@
 <?php

 namespace PHPModbus;
+use Exception;

 /**
 * Phpmodbus Copyright (c) 2004, 2012 Jan Krakora
@@ -28,8 +29,8 @@ namespace PHPModbus;
 * @package    Phpmodbus
 *
 */
-class PhpType {
-
+class PhpType
+{
 	/**
 	 * bytes2float
 	 *
@@ -37,19 +38,17 @@ class PhpType {
 	 * depends on order of the input bytes (endianning).
 	 *
 	 * @param array $values
-     * @param bool $endianness
+	 * @param bool  $bigEndian
 	 * @return float
 	 */
-    public static function bytes2float($values, $endianness = 0) {
-        $data = array();
-        $real = 0;
-
+	public static function bytes2float($values, $bigEndian = 0)
+	{
 		// Set the array to correct form
 		$data = self::checkData($values);
 		// Combine bytes
-        $real = self::combineBytes($data, $endianness);
+		$real = self::combineBytes($data, $bigEndian);
 		// Convert the real value to float
-        return (float) self::real2float($real);
+		return (float)self::real2float($real);
 	}

 	/**
@@ -59,22 +58,23 @@ class PhpType {
 	 * The return value depends on order of the input bytes (endianning).
 	 *
 	 * @param array $values
-     * @param bool $endianness
+	 * @param bool  $bigEndian
 	 * @return int
 	 */
-    public static function bytes2signedInt($values, $endianness = 0) {
+	public static function bytes2signedInt($values, $bigEndian = 0)
+	{
 		$data = array();
 		$int = 0;
 		// Set the array to correct form
 		$data = self::checkData($values);
 		// Combine bytes
-        $int = self::combineBytes($data, $endianness);
+		$int = self::combineBytes($data, $bigEndian);
 		// In the case of signed 2 byte value convert it to 4 byte one
 		if ((count($values) == 2) && ((0x8000 & $int) > 0)) {
 			$int = 0xFFFF8000 | $int;
 		}
 		// Convert the value
-        return (int) self::dword2signedInt($int);
+		return (int)self::dword2signedInt($int);
 	}

 	/**
@@ -84,16 +84,17 @@ class PhpType {
 	 * The return value depends on order of the input bytes (endianning).
 	 *
 	 * @param array $values
-     * @param bool $endianness
+	 * @param bool  $bigEndian
 	 * @return int|float
 	 */
-    public static function bytes2unsignedInt($values, $endianness = 0) {
+	public static function bytes2unsignedInt($values, $bigEndian = 0)
+	{
 		$data = array();
 		$int = 0;
 		// Set the array to correct form
 		$data = self::checkData($values);
 		// Combine bytes
-        $int = self::combineBytes($data, $endianness);
+		$int = self::combineBytes($data, $bigEndian);
 		// Convert the value
 		return self::dword2unsignedInt($int);
 	}
@@ -105,35 +106,39 @@ class PhpType {
 	 * the end of the string by 0x00 character as defined by string standards.
 	 *
 	 * @param array $values
-     * @param bool $endianness
+	 * @param bool  $bigEndian
 	 * @return string
 	 */
-    public static function bytes2string($values, $endianness = 0) {
+	public static function bytes2string($values, $bigEndian = 0)
+	{
 		// Prepare string variable
 		$str = "";
 		// Parse the received data word array
-        for($i=0;$i<count($values);$i+=2) {
-            if ($endianness) {
-                if($values[$i] != 0)
+		for ($i = 0; $i < count($values); $i += 2) {
+			if ($bigEndian) {
+				if ($values[$i] != 0) {
 					$str .= chr($values[$i]);
-                else
-                    break;
-                if($values[$i+1] != 0)
-                    $str .= chr($values[$i+1]);
-                else
+				} else {
 					break;
 				}
-            else {
-                if($values[$i+1] != 0)
-                    $str .= chr($values[$i+1]);
-                else
+				if ($values[$i + 1] != 0) {
+					$str .= chr($values[$i + 1]);
+				} else {
 					break;
-                if($values[$i] != 0)
+				}
+			} else {
+				if ($values[$i + 1] != 0) {
+					$str .= chr($values[$i + 1]);
+				} else {
+					break;
+				}
+				if ($values[$i] != 0) {
 					$str .= chr($values[$i]);
-                else
+				} else {
 					break;
 				}
 			}
+		}
 		// return string
 		return $str;
 	}
@@ -144,13 +149,15 @@ class PhpType {
 	 * This function converts a value in IEC-1131 REAL single precision form to float.
 	 *
 	 * For more see [{@link http://en.wikipedia.org/wiki/Single_precision Single precision on Wiki}] or
-     * [{@link http://de.php.net/manual/en/function.base-convert.php PHP base_convert function commentary}, Todd Stokes @ Georgia Tech 21-Nov-2007] or
+	 * [{@link http://de.php.net/manual/en/function.base-convert.php PHP base_convert function commentary}, Todd Stokes
+	 * @ Georgia Tech 21-Nov-2007] or
 	 * [{@link http://www.php.net/manual/en/function.pack.php PHP pack/unpack functionality}]
 	 *
-     * @param value value in IEC REAL data type to be converted
+	 * @param int $value in IEC REAL data type to be converted
 	 * @return float float value
 	 */
-    private static function real2float($value) {
+	private static function real2float($value)
+	{
 		// get unsigned long
 		$ulong = pack("L", $value);
 		// set float
@@ -167,9 +174,10 @@ class PhpType {
 	 * @param int $value
 	 * @return int
 	 */
-    private static function dword2signedInt($value) {
+	private static function dword2signedInt($value)
+	{
 		if ((0x80000000 & $value) != 0) {
-            return -(0x7FFFFFFF & ~$value)-1;
+			return -(0x7FFFFFFF & ~$value) - 1;
 		} else {
 			return (0x7FFFFFFF & $value);
 		}
@@ -183,11 +191,12 @@ class PhpType {
 	 * @param int $value
 	 * @return int|float
 	 */
-    private static function dword2unsignedInt($value) {
+	private static function dword2unsignedInt($value)
+	{
 		if ((0x80000000 & $value) != 0) {
-            return ((float) (0x7FFFFFFF & $value)) + 2147483648;
+			return ((float)(0x7FFFFFFF & $value)) + 2147483648;
 		} else {
-            return (int) (0x7FFFFFFF & $value);
+			return (int)(0x7FFFFFFF & $value);
 		}
 	}

@@ -196,15 +205,18 @@ class PhpType {
 	 *
 	 * Check if the data variable is array, and check if the values are numeric
 	 *
-     * @param int $data
+	 * @param int[] $data
 	 * @return int
+	 * @throws Exception
 	 */
-    private static function checkData($data) {
+	private static function checkData($data)
+	{
 		// Check the data
 		if (!is_array($data) ||
-                count($data)<2 ||
-                count($data)>4 ||
-                count($data)==3) {
+			count($data) < 2 ||
+			count($data) > 4 ||
+			count($data) == 3
+		) {
 			throw new Exception('The input data should be an array of 2 or 4 bytes.');
 		}
 		// Fill the rest of array by zeroes
@@ -216,7 +228,8 @@ class PhpType {
 		if (!is_numeric($data[0]) ||
 			!is_numeric($data[1]) ||
 			!is_numeric($data[2]) ||
-                !is_numeric($data[3])) {
+			!is_numeric($data[3])
+		) {
 			throw new Exception('Data are not numeric or the array keys are not indexed by 0,1,2 and 3');
 		}

@@ -229,24 +242,25 @@ class PhpType {
 	 * Combine bytes together
 	 *
 	 * @param int  $data
-     * @param bool $endianness
+	 * @param bool $bigEndian
 	 * @return int
 	 */
-    private static function combineBytes($data, $endianness) {
+	private static function combineBytes($data, $bigEndian)
+	{
 		$value = 0;
 		// Combine bytes
-        if ($endianness == 0)
-            $value = (($data[3] & 0xFF)<<16) |
-                    (($data[2] & 0xFF)<<24) |
+		if ($bigEndian == 0) {
+			$value = (($data[3] & 0xFF) << 16) |
+				(($data[2] & 0xFF) << 24) |
 				(($data[1] & 0xFF)) |
-                    (($data[0] & 0xFF)<<8);
-        else
-            $value = (($data[3] & 0xFF)<<24) |
-                    (($data[2] & 0xFF)<<16) |
-                    (($data[1] & 0xFF)<<8) |
+				(($data[0] & 0xFF) << 8);
+		} else {
+			$value = (($data[3] & 0xFF) << 24) |
+				(($data[2] & 0xFF) << 16) |
+				(($data[1] & 0xFF) << 8) |
 				(($data[0] & 0xFF));
+		}

 		return $value;
 	}
 }
-?>
Author	SHA1	Message	Date
MightyPork	4256b6cef7	fixed the examples	2016-11-20 11:29:09 +01:00
MightyPork	61e7a690eb	Minor cleanup, removed duplicate timeout vars & replaced with float [sec], added socket Tout setter	2016-11-18 16:06:15 +01:00
toimtoimtoim	7365700b72	cleanup	2016-11-05 18:00:41 +02:00
toimtoimtoim	cff8493205	refactor timeout_usec to millisecond precision and add setter for ms.	2016-11-05 17:57:19 +02:00
toimtoimtoim	e10bb250d8	Use microsecond precision instead of second for timeout when reading from sockets. Expose variables to configure socket read and write timeouts in sec and usec (microseconds) precision	2016-11-04 22:02:04 +02:00
MightyPork	c18696a718	added myself to composer json	2016-03-11 23:11:21 +01:00
MightyPork	dd5a892fb6	Cleaned up the code, fixed broken phpdoc tags, formatting	2016-03-11 23:08:00 +01:00
MightyPork	7d058ee526	changed name for packagist because it doesnt like uppercase	2016-03-11 22:33:11 +01:00