PHPackages                             coding-libs/zkteco-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. coding-libs/zkteco-php

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

coding-libs/zkteco-php
======================

A package for managing ZKTeco device.

v0.0.34(9mo ago)152.5k↓47.1%4MITPHPPHP ^8.0CI passing

Since Aug 21Pushed 9mo ago4 watchersCompare

[ Source](https://github.com/coding-libs/zkteco-php)[ Packagist](https://packagist.org/packages/coding-libs/zkteco-php)[ Docs](https://github.com/coding-libs)[ RSS](/packages/coding-libs-zkteco-php/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (4)Dependencies (1)Versions (36)Used By (0)

[![Zkteco Logo](https://raw.githubusercontent.com/coding-libs/zkteco-js/master/logo.jpg)](https://www.zkteco.com/)

Warning
-------

[](#warning)

**⚠️ This repository is not recommended for use in production. ⚠️**

This repository is currently in development and may contain bugs or incomplete features. Use at your own risk and do not deploy to a production environment.

About zkteco-php
================

[](#about-zkteco-php)

The zkteco-php library provides a robust solution for php/laravel developers to interface with ZK BioMetric Fingerprint Attendance Devices. Its user-friendly API allows seamless extraction of data, such as registered users, logs, and device versions. Developers can also add users, retrieve real-time logs, and clear attendance records. Using a socket connection, the library ensures fast and reliable data exchange. Whether creating an attendance system or a time-and-attendance management application, zkteco-js is the essential tool for integrating biometric devices efficiently.

### Installation

[](#installation)

```
composer require coding-libs/zkteco-php
```

### Usage Example

[](#usage-example)

```
// Uncomment the line below if you are not using a PHP framework and need to manually load Composer dependencies.
// require_once "vendor/autoload.php";

use CodingLibs\ZktecoPhp\Libs\ZKTeco;
$zktecoLib = new Zkteco('192.168.1.1');
//$zktecoLib = new Zkteco(ip:'192.168.1.1', port:4370, shouldPing:false, timeout:25, password:12345); // Password means CMD Key
$zkteco->connect();

$zktecoLib->vendorName(); // "ZKTeco Inc.
$zktecoLib->deviceName(); // "F22/ID
$zktecoLib->serialNumber(); // "BOCK201261276
$zktecoLib->pinWidth(); // "14
$zktecoLib->faceFunctionOn(); // "0
$zktecoLib->platform(); // "ZLM60_TFT
$zktecoLib->fmVersion(); // "10
$zktecoLib->ssr(); // "1
$zktecoLib->version(); // "Ver 6.60 Sep 19 2019
$zktecoLib->workCode(); // "0
$zktecoLib->getFingerprint(1);
$zktecoLib->getUsers(); // users
$zktecoLib->getAttendances(); // attendances logs
$zktecoLib->getTime(); // device time
$zktecoLib->clearAdminPriv(); // Removes the admin privileges from the current user.
$zktecoLib->clearAllUsers(); // clear all users
```

#### We have introduced some unique methods.

[](#we-have-introduced-some-unique-methods)

```
$zktecoLib->getAttendances(function ($item){
// condition goes there
    return $item;
}); // attendances logs
$zktecoLib->deleteUsers(function($user){
   // condition goes there
}); // delete users conditionally
$zktecoLib->deviceId(); // "0
$zktecoLib->getDeviceData('TCPPort'); // "4370
$zktecoLib->setCustomData('my_company_name', "Coding Labs"); // You can set any custom value as you want
$zktecoLib->getCustomData("my_company_name"); // "Coding Labs
$zktecoLib->setPushCommKey("iclock_push_commKey"); // It may be useful for iClock authentication.
$zktecoLib->getPushCommKey(); // "iclock_push_commKey
# and more...
```

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](https://github.com/coding-libs/zkteco-php/graphs/contributors) for details.

Security
--------

[](#security)

If you've found a bug regarding security please mail  instead of using the issue tracker.

Alternatives
------------

[](#alternatives)

- [adrobinoga/zk-protocol](https://github.com/adrobinoga/zk-protocol)
- [dnaextrim/python\_zklib](https://github.com/dnaextrim/python_zklib)
- [caobo171/node-zklib](https://github.com/caobo171/node-zklib)\#- [agile-bm/zk-lib](https://github.com/agile-bm/zk-lib)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance57

Moderate activity, may be stable

Popularity31

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 93.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~11 days

Recently: every ~5 days

Total

34

Last Release

280d ago

PHP version history (3 changes)v0.0.1PHP ^8.2

v0.0.3PHP ^8.1

v0.0.19PHP ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/818d3cced43d6bc3ca0e1d6292d19c4289ec9ff3d30720db2b93ec2a5ed4a008?d=identicon)[coding-libs](/maintainers/coding-libs)

---

Top Contributors

[![anwarx4u](https://avatars.githubusercontent.com/u/21153921?v=4)](https://github.com/anwarx4u "anwarx4u (44 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (2 commits)")[![coding-libs](https://avatars.githubusercontent.com/u/174326474?v=4)](https://github.com/coding-libs "coding-libs (1 commits)")

---

Tags

laravelFingerprintzktecoattendances

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/coding-libs-zkteco-php/health.svg)

```
[![Health](https://phpackages.com/badges/coding-libs-zkteco-php/health.svg)](https://phpackages.com/packages/coding-libs-zkteco-php)
```

###  Alternatives

[mehedijaman/laravel-zkteco

Connect any zkteco fingerprint attendance machine to laravel application with no effort.

454.1k](/packages/mehedijaman-laravel-zkteco)[stephenjude/filament-blog

Filament Blog Builder

20317.8k](/packages/stephenjude-filament-blog)[datomatic/nova-detached-actions

A Laravel Nova tool to allow for placing actions in the Nova toolbar detached from the checkbox selection mechanism.

11229.2k](/packages/datomatic-nova-detached-actions)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
