Download the PHP package rithy/zkteco-adms without Composer

On this page you can find all versions of the php package rithy/zkteco-adms. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

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 PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • 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.
Please rate this library. Is it a good library?

Informations about the package zkteco-adms

Laravel ZKTeco ADMS

A production-ready Laravel package for integrating ZKTeco biometric devices using the ADMS (Push SDK) protocol.

This package is extracted from a real-world production attendance system and preserves the original Laravel implementation while making it reusable across multiple Laravel applications.


Features


Requirements

RequirementVersion

Installation

1. Install Package

If composer require rithy/zkteco-adms is not working

Add the repository manually in your project's composer.json:

Then run:


2. Publish Configuration


3. Publish Database Migrations


4. Publish Views


5. Run Migrations


6. Configure Scheduler (Optional)

The package provides real-time attendance ingestion from device callbacks.

The scheduler is optional, but recommended to ensure attendance sync stays consistent. Use it as a safety net for cases like temporary network issues, delayed device pushes, or missed callbacks.

The package provides the following Artisan command:

Register it in your application's routes/console.php:

Finally, ensure Laravel's scheduler is running by adding the standard cron entry on your server:


7. Configure CSRF Exclusion

Since ZKTeco devices cannot generate Laravel CSRF tokens, exclude the ADMS endpoint in bootstrap/app.php:


Configuration

After publishing, edit:

Example:


Routes

The package automatically registers these endpoints:

MethodEndpointDescriptionGET/iclock/cdataDevice HandshakePOST/iclock/cdataAttendance UploadGET/iclock/getrequestDevice PollingPOST/iclock/devicecmdCommand ResponseVerify:


Database Tables

The package creates the following tables:


Supported Data

Attendance

Users

Biometrics

Device Commands


Package Structure


Typical Data Flow


Multi-device Support

Supports unlimited ZKTeco devices.

Example:

Each device is uniquely identified by its Serial Number (SN).


Production Deployment Checklist


Contributing

Contributions are welcome.

  1. Fork the repository.
  2. Create a feature branch.
  3. Commit your changes.
  4. Open a Pull Request.

License

MIT License


Author

Rithy Sam

Laravel Developer

Email: [email protected]

Cambodia 🇰🇭

# Acknowledgements

Inspired by the work on the adms-server-ZKTeco project:

https://github.com/saifulcoder/adms-server-ZKTeco/tree/main

Special thanks to the Laravel community and to ZKTeco for the ADMS Push SDK protocol.


All versions of zkteco-adms with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
illuminate/support Version ^11.0|^12.0
illuminate/routing Version ^11.0|^12.0
illuminate/database Version ^11.0|^12.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package rithy/zkteco-adms contains the following files

Loading the files please wait ...