Add ZK library classes for device interaction and user management

- Implemented Os class for retrieving OS information.
- Added Pin class for getting PIN width.
- Created Platform class for fetching platform details and version.
- Developed SerialNumber class to retrieve device serial number.
- Introduced Ssr class for SSR information retrieval.
- Implemented Time class for setting and getting device time.
- Added User class for user management including setting, getting, clearing, and removing users.
- Created Util class with various utility functions for command handling and data processing.
- Implemented Version class for fetching device version.
- Added WorkCode class for retrieving work code information.
- Set up Composer autoloading for the ZK library.

zklib/src/Fingerprint.php

@@ -0,0 +1,162 @@
+<?php
+
+namespace ZK;
+
+use ZKLib;
+
+class Fingerprint
+{
+    /**
+     * TODO: Can get data, but don't know how to parse the data. Need more documentation about it...
+     *
+     * @param ZKLib $self
+     * @param integer $uid Unique Employee ID in ZK device
+     * @return array Binary fingerprint data array (where key is finger ID (0-9))
+     */
+    public function get(ZKLib $self, $uid)
+    {
+        $self->_section = __METHOD__;
+
+        $data = [];
+        //fingers of the hands
+        for ($i = 0; $i <= 9; $i++) {
+            $tmp = $this->_getFinger($self, $uid, $i);
+            if ($tmp['size'] > 0) {
+                $data[$i] = $tmp['tpl'];
+            }
+            unset($tmp);
+        }
+        return $data;
+    }
+
+
+    /**
+     * @param ZKLib $self
+     * @param integer $uid Unique Employee ID in ZK device
+     * @param integer $finger Finger ID (0-9)
+     * @return array
+     */
+    private function _getFinger(ZKLib $self, $uid, $finger)
+    {
+        $command = Util::CMD_USER_TEMP_RRQ;
+        $byte1 = chr((int)($uid % 256));
+        $byte2 = chr((int)($uid >> 8));
+        $command_string = $byte1 . $byte2 . chr($finger);
+
+        $ret = [
+            'size' => 0,
+            'tpl' => ''
+        ];
+
+        $session = $self->_command($command, $command_string, Util::COMMAND_TYPE_DATA);
+        if ($session === false) {
+            return $ret;
+        }
+
+        $data = Util::recData($self, 10, false);
+
+        if (!empty($data)) {
+            $templateSize = strlen($data);
+            $prefix = chr($templateSize % 256) . chr(round($templateSize / 256)) . $byte1 . $byte2 . chr($finger) . chr(1);
+            $data = $prefix . $data;
+            if (strlen($templateSize) > 0) {
+                $ret['size'] = $templateSize;
+                $ret['tpl'] = $data;
+            }
+        }
+
+        return $ret;
+    }
+
+    /**
+     * TODO: Still can not set fingerprint. Need more documentation about it...
+     *
+     * @param ZKLib $self
+     * @param int $uid Unique Employee ID in ZK device
+     * @param array $data Binary fingerprint data array (where key is finger ID (0-9) same like returned array from 'get' method)
+     * @return int Count of added fingerprints
+     */
+    public function set(ZKLib $self, $uid, array $data)
+    {
+        $self->_section = __METHOD__;
+
+
+        $count = 0;
+        foreach ($data as $finger => $item) {
+            $allowSet = true;
+            if ($this->_checkFinger($self, $uid, $finger) === true) {
+                $allowSet = $this->_removeFinger($self, $uid, $finger);
+            }
+            if ($allowSet === true && $this->_setFinger($self, $item) === true) {
+                $count++;
+            }
+        }
+
+        return $count;
+    }
+
+    /**
+     * @param ZKLib $self
+     * @param string $data Binary fingerprint data item
+     * @return bool|mixed
+     */
+    private function _setFinger(ZKLib $self, $data)
+    {
+        $command = Util::CMD_USER_TEMP_WRQ;
+        $command_string = $data;
+
+        return $self->_command($command, $command_string);
+    }
+
+    /**
+     * @param ZKLib $self
+     * @param int $uid Unique Employee ID in ZK device
+     * @param array $data Fingers ID array (0-9)
+     * @return int Count of deleted fingerprints
+     */
+    public function remove(ZKLib $self, $uid, array $data)
+    {
+        $self->_section = __METHOD__;
+
+        $count = 0;
+        foreach ($data as $finger) {
+            if ($this->_checkFinger($self, $uid, $finger) === true) {
+                if ($this->_removeFinger($self, $uid, $finger) === true) {
+                    $count++;
+                }
+            }
+        }
+
+        return $count;
+    }
+
+    /**
+     * @param ZKLib $self
+     * @param int $uid Unique Employee ID in ZK device
+     * @param int $finger Finger ID (0-9)
+     * @return bool
+     */
+    private function _removeFinger(ZKLib $self, $uid, $finger)
+    {
+        $command = Util::CMD_DELETE_USER_TEMP;
+        $byte1 = chr((int)($uid % 256));
+        $byte2 = chr((int)($uid >> 8));
+        $command_string = ($byte1 . $byte2) . chr($finger);
+
+        $self->_command($command, $command_string);
+
+        return !($this->_checkFinger($self, $uid, $finger));
+    }
+
+    /**
+     * @param ZKLib $self
+     * @param int $uid Unique Employee ID in ZK device
+     * @param int $finger Finger ID (0-9)
+     * @return bool Returned true if exist
+     */
+    private function _checkFinger(ZKLib $self, $uid, $finger)
+    {
+        $res = $this->_getFinger($self, $uid, $finger);
+        return (bool)($res['size'] > 0);
+    }
+}