mehedijaman / laravel-zkteco

Seamlessly integrate any ZKTeco fingerprint attendance machine with your Laravel application.

Laravel ZKTeco Integration

Overview

The Laravel ZKTeco package provides an easy way to integrate ZKTeco biometric devices with your Laravel application. This package simplifies the process of connecting to ZKTeco devices, fetching attendance logs, and managing user data.

Features

• Easy Integration: Seamlessly connect your Laravel application with ZKTeco biometric devices.
• Attendance Management: Fetch and manage attendance logs from connected devices.
• User Management: Add, update, and remove users on the biometric device directly from your application.
• Real-time Data Sync: Ensure that your application always has the latest attendance data.

Installation

You can install the package via composer:

composer require mehedijaman/laravel-zkteco

The package is designed to automatically register itself upon installation.

Please ensure that the PHP sockets extension is enabled on your server. If it is not enabled, you will need to activate it.

Activate PHP Socket

Ensure that the PHP sockets extension is enabled on your server. If it is not enabled, follow these steps to activate it:

Locate the php.ini File: The php.ini file's location depends on your PHP installation. Common locations include:

• /etc/php/8.x/cli/php.ini (for CLI)
• /etc/php/8.x/apache2/php.ini (for Apache)
• /etc/php/8.x/fpm/php.ini (for PHP-FPM)

Edit the php.ini File: Open the php.ini file in a text editor with superuser privileges:

sudo nano /etc/php/7.x/apache2/php.ini

Uncomment the Sockets Extension: Find the following line:

;extension=sockets

Remove the semicolon (;) to uncomment the line:

extension=sockets

Save and Exit: Save the changes and exit the editor (Ctrl + X, Y, Enter).

Restart the Web Server: Restart the web server to apply the changes:

sudo systemctl restart apache2

Usage

Instantiate the LaravelZkteco Object.

use MehediJaman\LaravelZkteco\LaravelZkteco;
$zk = new LaravelZkteco('ipaddress', 'port');

Call ZKTeco methods

• Connect

//    connect device
//    this return bool
    $zk->connect();   

• Disconnect

//    disconnect device
//    this return bool

    $zk->disconnect();   

• Enable Device

//    enable devices
//    this return bool/mixed

    $zk->enableDevice();   

NOTE: You have to call after read/write any info of Device.

• Disable Device

//    disable  device
//    this return bool/mixed

    $zk->disableDevice(); 

NOTE: You have to call before read/write any info of Device.

• Device Version

//    get device version 
//    this return bool/mixed

    $zk->version(); 

• Device Os Version

//    get device os version 
//    this return bool/mixed

    $zk->osVersion(); 

• Power Off

//    turn off the device 
//    this return bool/mixed

    $zk->shutdown(); 

• Restart

//    restart the device 
//    this return bool/mixed

    $zk->restart(); 

• Sleep

//    sleep the device 
//    this return bool/mixed

    $zk->sleep(); 

• Resume

//    resume the device from sleep 
//    this return bool/mixed

    $zk->resume(); 

• Voice Test

//    voice test of the device "Thank you" 
//    this return bool/mixed

    $zk->testVoice(); 

• Platform

//    get platform 
//    this return bool/mixed

    $zk->platform(); 

• Firmware Version

//    get firmware version
//    this return bool/mixed

    $zk->fmVersion(); 

• Work Code

//    get work code
//    this return bool/mixed

    $zk->workCode(); 

• SSR

//    get SSR
//    this return bool/mixed

    $zk->ssr(); 

• Pin Width

//    get  Pin Width
//    this return bool/mixed

    $zk->pinWidth(); 

• Serial Number

//    get device serial number
//    this return bool/mixed

    $zk->serialNumber(); 

• Device Name

//    get device name
//    this return bool/mixed

    $zk->deviceName(); 

• Get Device Time

//    get device time

//    return bool/mixed bool|mixed Format: "Y-m-d H:i:s"

    $zk->getTime(); 

• Set Device Time

//    set device time
//    parameter string $t Format: "Y-m-d H:i:s"
//    return bool/mixed

    $zk->setTime(); 

• Get Users

//    get User
//    this return array[]

    $zk->getUser(); 

• Set Users

//    set user

//    1 s't parameter int $uid Unique ID (max 65535)
//    2 nd parameter int|string $userid ID in DB (same like $uid, max length = 9, only numbers - depends device setting)
//    3 rd parameter string $name (max length = 24)
//    4 th parameter int|string $password (max length = 8, only numbers - depends device setting)
//    5 th parameter int $role Default Util::LEVEL_USER
//    6 th parameter int $cardno Default 0 (max length = 10, only numbers

//    return bool|mixed

    $zk->setUser(); 

• Clear All Admin

//    remove all admin
//    return bool|mixed

    $zk->clearAdmin(); 

• Clear All Users

//    remove all users
//    return bool|mixed

    $zk->clearAdmin(); 

• Remove A User

//    remove a user by $uid
//    parameter integer $uid
//    return bool|mixed

    $zk->removeUser(); 

• Get Attendance Log

//    get attendance log

//    return array[]

//    like as 0 => array:5 [▼
//              "uid" => 1      /* serial number of the attendance */
//              "id" => "1"     /* user id of the application */
//              "state" => 1    /* the authentication type, 1 for Fingerprint, 4 for RF Card etc */
//              "timestamp" => "2020-05-27 21:21:06" /* time of attendance */
//              "type" => 255   /* attendance type, like check-in, check-out, overtime-in, overtime-out, break-in & break-out etc. if attendance type is none of them, it gives  255. */
//              ]

    $zk->getAttendance(); 

• Clear Attendance Log

//    clear attendance log

//    return bool/mixed

    $zk->clearAttendance(); 

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Mehedi Jaman

License

The MIT License (MIT). Please see License File for more information.