Download the PHP package athwari/laravel-zkteco-adms without Composer
On this page you can find all versions of the php package athwari/laravel-zkteco-adms. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download athwari/laravel-zkteco-adms
More information about athwari/laravel-zkteco-adms
Files in athwari/laravel-zkteco-adms
Package laravel-zkteco-adms
Short Description Laravel package implementing the ZKTeco ADMS protocol for biometric attendance devices.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package laravel-zkteco-adms
Laravel ZKteco ADMS
This package provides the backend ADMS protocol implementation for ZKTeco biometric devices in Laravel.
It handles device communication, attendance ingestion, user synchronization, and command dispatching. The package is intentionally tenancy-agnostic.
If you need tenant-aware behavior in Filament, use athwari/filament-zkteco-adms, which owns tenancy configuration and tenant column management.
Features
- Device lifecycle management (registration, activity tracking, stale device eviction command)
- ADMS protocol endpoints for cdata, registry, getrequest, devicecmd, inspect, and test
- Attendance log parsing and persistence
- User synchronization from device operation logs and user query responses
- Command queueing, polling, and confirmation handling
- Configurable model bindings via zkteco-adms.models.*
- Optional event dispatching for device, attendance, command, and user sync flows
Installation
Install the package via Composer:
Configuration
Publish the configuration file:
Publish and run the package migrations:
Main configuration areas in config/zkteco-adms.php:
- table_prefix: prefix used for all ZKTeco tables
- routes: endpoint prefix, middleware, and optional domain
- device: registration and limits configuration
- response: handshake defaults
- models: model class overrides for device, user, attendance log, command, and event
- events: per-event dispatch toggles
- enable_inspect: enables the inspect endpoint
- default_timezone: fallback timezone used to interpret device-local attendance times
- storage_timezone: timezone used for normalized
occurred_atvalues (defaults to UTC)
Set the normalized attendance storage timezone with:
Attendance logs retain the device-local time in recorded_at for backward compatibility. The same instant is also stored in occurred_at, converted to storage_timezone; use this field when comparing or reporting attendance across devices in different timezones.
Usage
ADMS Endpoints
By default, routes are mounted under /iclock (configurable via zkteco-adms.routes.prefix):
- GET/POST /iclock/cdata
- GET/POST /iclock/registry
- GET /iclock/getrequest
- POST /iclock/devicecmd
- GET /iclock/inspect (when enabled)
- GET/POST /iclock/test
Services
Core services are container singletons:
- Athwari\LaravelZktecoAdms\Services\DeviceManager
- Athwari\LaravelZktecoAdms\Services\CommandManager
- Athwari\LaravelZktecoAdms\Services\AttendanceParser
- Athwari\LaravelZktecoAdms\Services\DeviceCommandBuilder
Models
Default models:
Athwari\LaravelZktecoAdms\Models\ZktecoDeviceAthwari\LaravelZktecoAdms\Models\ZktecoUserAthwari\LaravelZktecoAdms\Models\ZktecoAttendanceLogAthwari\LaravelZktecoAdms\Models\ZktecoDeviceCommandAthwari\LaravelZktecoAdms\Models\ZktecoDeviceEvent
You can override these through config('zkteco-adms.models.*') in your application.
Facade
The package ships with an auto-discovered facade alias: ZktecoAdms
If you prefer explicit imports:
Testing
Run the test suite with:
Additional useful scripts:
Tenancy Boundary
This package no longer owns multi-tenancy configuration.
- Core package responsibility: protocol and domain logic
- Filament plugin responsibility: tenant ownership, tenant columns, and tenant-scoped UI queries
Contributing
Please see CONTRIBUTING for details.
Security
Please review SECURITY if you discover a vulnerability in this package.
Credits
License
The MIT License (MIT). Please see LICENSE.md for more information.
All versions of laravel-zkteco-adms with dependencies
illuminate/support Version ^8.0|^9.0|^10.0|^11.0|^12.0
illuminate/database Version ^8.0|^9.0|^10.0|^11.0|^12.0
illuminate/http Version ^8.0|^9.0|^10.0|^11.0|^12.0