PHPackages                             yacoubalhaidari/zkfinger-laravel - 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 & Helpers](/categories/utility)
4. /
5. yacoubalhaidari/zkfinger-laravel

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

yacoubalhaidari/zkfinger-laravel
================================

Laravel package for ZKTeco ZKFinger SDK via local agent bridge

v1.0.0(1mo ago)02PHPPHP ^8.1|^8.2|^8.3|^8.4|^8.5

Since May 10Pushed 1mo agoCompare

[ Source](https://github.com/YacoubAl-hardari/zk-fingerprint-reader)[ Packagist](https://packagist.org/packages/yacoubalhaidari/zkfinger-laravel)[ RSS](/packages/yacoubalhaidari-zkfinger-laravel/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependencies (2)Versions (2)Used By (0)

[![ZKTeco Laravel Integration Solution](210.png)](210.png)

ZK Fingerprint Reader Laravel Bridge
====================================

[](#zk-fingerprint-reader-laravel-bridge)

A Laravel package to integrate ZKTeco ZKFinger SDK (Biokey.ocx) via a local Windows agent bridge.

⚡ Features
----------

[](#-features)

- Enroll, capture, verify, and identify fingerprints using ZKTeco SDK
- Communicates with a local Windows agent (wraps Biokey.ocx)
- Eloquent model for fingerprint templates
- Migration and config publishing

🛠️ Installation
---------------

[](#️-installation)

1. **Require the package** (if published to Packagist): ```
    composer require yacoubalhaidari/zkfinger-laravel
    ```

    Or add as a local package in `composer.json`: ```
    "repositories": [
      { "type": "path", "url": "packages/zk-fingerprint-reader" }
    ]
    ```

    Then run: ```
    composer require yacoubalhaidari/zkfinger-laravel
    ```
2. **Publish config:**```
    php artisan vendor:publish --tag=zkfinger-config
    ```
3. **Run migration:**```
    php artisan migrate
    ```
4. **Deploy the local Windows agent** (see below).

⚙️ Configuration
----------------

[](#️-configuration)

Edit `config/zkfinger.php` as needed. Set the agent URL in your `.env`:

```
ZKFINGER_AGENT_URL=http://127.0.0.1:8080

```

🖥️ Local Windows Agent
----------------------

[](#️-local-windows-agent)

You must run a local service on each client machine that wraps the ZKTeco Biokey.ocx ActiveX control and exposes an HTTP API. Example endpoints:

- `/enroll` (POST)
- `/capture` (POST)
- `/verify/1:1` (POST)
- `/identify/1:N` (POST)
- `/cache/create` (POST)
- `/cache/add` (POST)

See the package documentation or ask for a sample Node.js, Python, or C# agent.

📖 Usage Example
---------------

[](#-usage-example)

Example controller usage:

```
use Yacoubalhaidari\ZKFinger\Services\ZKFingerAgentClient;
use Yacoubalhaidari\ZKFinger\Models\FingerprintTemplate;

public function enroll(Request $request, ZKFingerAgentClient $zk) {
    $userId = $request->input('user_id');
    $result = $zk->enroll($userId);
    FingerprintTemplate::create([
        'user_id' => $userId,
        'template_b64' => $result['template_b64'],
        'template_type' => config('zkfinger.template_type'),
        'engine_version' => config('zkfinger.engine_version'),
    ]);
    return response()->json(['status' => 'enrolled']);
}
```

📝 License
---------

[](#-license)

MIT

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance94

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

30d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/1fb3960cf6e949bc5401902a09bf597da5bf4aeaf53c382bb55b1843769c0347?d=identicon)[Yacoub\_Al-haidari](/maintainers/Yacoub_Al-haidari)

---

Top Contributors

[![YacoubAl-hardari](https://avatars.githubusercontent.com/u/94101869?v=4)](https://github.com/YacoubAl-hardari "YacoubAl-hardari (2 commits)")

### Embed Badge

![Health badge](/badges/yacoubalhaidari-zkfinger-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/yacoubalhaidari-zkfinger-laravel/health.svg)](https://phpackages.com/packages/yacoubalhaidari-zkfinger-laravel)
```

###  Alternatives

[backpack/crud

Quickly build admin interfaces using Laravel, Bootstrap and JavaScript.

3.4k3.6M217](/packages/backpack-crud)[grumpydictator/firefly-iii

Firefly III: a personal finances manager.

23.6k69.4k](/packages/grumpydictator-firefly-iii)[unopim/unopim

UnoPim Laravel PIM

10.1k2.2k](/packages/unopim-unopim)[backpack/basset

Dead-simple way to load CSS or JS assets only once per page, when using Laravel 10+.

206923.1k10](/packages/backpack-basset)[firefly-iii/data-importer

Firefly III Data Import Tool.

7905.8k](/packages/firefly-iii-data-importer)[nickurt/laravel-akismet

Akismet for Laravel 11.x/12.x/13.x

98145.2k3](/packages/nickurt-laravel-akismet)

PHPackages © 2026

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