Open source & connected hardware

php-zkteco

v2.1: Laravel-ready biometric integration with TCP/UDP, attendance writing, ADMS push, and signed webhooks.

PHP 8.xLaravel 8-12TCP / UDP SocketsADMS Push
Illustrative interface concept
The context

What needed to work better?

Created and maintain an open-source PHP library that connects ZKTeco biometric terminals directly to business software. The v2.1.0 release adds Laravel auto-discovery, a service provider, Facade, and publishable configuration, alongside a PHP 8.0-8.4 CI matrix. Its native socket engine supports both polling and push workflows without an external C SDK or Python bridge.

The engineering

Connecting the right pieces.

Dual TCP/UDP Engine: Direct socket communication with biometric terminals and native CommKey authentication for protected devices.

Attendance Write & Selective Deletion: Direct hardware ATT_LOG writing (CMD_SET_DATA 3001) and selective attendance deletion (CMD_TIME_ATTLOG_DELE 10005).

Push & Cloud Workflows: Built-in ADMS server, cloud POST synchronization, and HMAC-SHA256 signed webhooks connect device events to application workflows.

Laravel Integration: Auto-discovered service provider, ZKTeco Facade, and publishable configuration for Laravel 8-12.

Automated Compatibility Checks: GitHub Actions CI matrix covers PHP 8.0, 8.1, 8.2, 8.3, and 8.4.

The delivery

What went into the build.

Composer / Packagist Package
Laravel Service Provider & Facade
ADMS Push Server & Signed Webhooks
Device Protocol Documentation & Examples
PHP 8.0-8.4 CI Matrix
Let’s make your next move

Your business.
A better system.

Share your requirements and we’ll discuss a practical scope, approach, and next steps.

Start a conversation
There’s more to explore.Back to all projects