anascloud/zkteko

A Laravel package for ZKTeco biometric devices, ported from a Python implementation.

dev-main 2026-06-14 10:31 UTC

Requires

• php: ^7.3|^8.0
• illuminate/support: ^8.0|^9.0|^10.0|^11.0

MIT

• anascloud

• laravel
• attendance
• biometric
• zkteko

Published on Packagist.org on 2026-06-14 10:31 UTC

README

A Laravel package for ZKTeco biometric devices, ported from a Python implementation.

Installation

You can install the package via composer:

composer require anascloud/zkteko

Configuration

Publish the configuration file:

php artisan vendor:publish --provider="Anascloud\Zkteko\ZktekoServiceProvider" --tag="zkteko-config"

Set your device details in your .env file:

ZKTEKO_IP=192.168.10.79
ZKTEKO_PORT=4370
ZKTEKO_PASSWORD=2837

Usage

Direct Usage

use Anascloud\Zkteko\ZKTeco;

$zk = new ZKTeco('192.168.10.79', 4370, 2837);

if ($zk->connect()) {
    $attendance = $zk->getAttendance();
    
    foreach ($attendance as $log) {
        // Process logs
    }
    
    $zk->disconnect();
}

Facade Usage

use Anascloud\Zkteko\Facades\Zkteko;

if (Zkteko::connect()) {
    $attendance = Zkteko::getAttendance();
    Zkteko::disconnect();
}

Credits

• Author: anascloud

License

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