PHPackages                             diepxuan/laravel-ronaldjack - 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. diepxuan/laravel-ronaldjack

ActiveLibrary

diepxuan/laravel-ronaldjack
===========================

Ronald Jack SDK for Laravel

0.0.8(2mo ago)022.0k—0%1MITPHP

Since Jul 8Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/diepxuan/laravel-ronaldjack)[ Packagist](https://packagist.org/packages/diepxuan/laravel-ronaldjack)[ RSS](/packages/diepxuan-laravel-ronaldjack/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (5)Used By (1)

Laravel Ronald Jack
===================

[](#laravel-ronald-jack)

SDK Ronald Jack cho Laravel.

Mô tả ngắn gọn
--------------

[](#mô-tả-ngắn-gọn)

Ronald Jack SDK for Laravel. Package tích hợp với thiết bị chấm công Ronald Jack thông qua thư viện zkemkeeper.dll (COM object) trên Windows.

Chức năng chính
---------------

[](#chức-năng-chính)

- Tích hợp với thiết bị chấm công Ronald Jack thông qua thư viện zkemkeeper.dll (COM).
- Cung cấp model Machine để kết nối và tương tác với máy chấm công.
- Cung cấp controller RonaldJackController với các action CRUD cơ bản.
- Sử dụng package core (`diepxuan/laravel-core`) để lấy đường dẫn thư viện.
- Route mẫu cho domain `mcc.diepxuan.io.vn` với middleware clearcache.

Cài đặt / Sử dụng
-----------------

[](#cài-đặt--sử-dụng)

```
composer require diepxuan/laravel-ronaldjack
```

Package không có ServiceProvider, cần sử dụng thủ công.

Cần có thư viện zkemkeeper.dll trong thư mục libs của package core (đường dẫn: `diepxuan/laravel-core/libs/zkemkeeper.dll`).

Sử dụng model Machine:

```
use Diepxuan\RonaldJack\Models\Machine;

$machine = new Machine(); // Sẽ khởi tạo COM object từ DLL
```

Controller cung cấp các route để quản lý máy chấm công (cần định nghĩa route riêng nếu không dùng route mặc định). Route mặc định:

```
Route::domain('mcc.diepxuan.io.vn')->middleware('clearcache')->group(static function (): void {
    Route::get('/', [RonaldJackController::class, 'index']);
});
```

Cấu trúc thư mục
----------------

[](#cấu-trúc-thư-mục)

```
laravel-ronaldjack/
├── config/
│   └── config.php                 # Cấu hình package
├── libs/
│   └── zkemkeeper.dll             # Thư viện DLL (Windows)
├── routes/
│   └── web.php                    # Route mẫu
├── src/
│   ├── Http/Controllers/
│   │   └── RonaldJackController.php
│   └── Models/
│       └── Machine.php
├── .editorconfig
├── .gitignore
├── LICENSE
├── README.md
└── composer.json

```

Liên kết đến các package liên quan
----------------------------------

[](#liên-kết-đến-các-package-liên-quan)

- diepxuan/laravel-core (để lấy đường dẫn thư viện)

Ghi chú
-------

[](#ghi-chú)

Package này dành riêng cho tích hợp với thiết bị chấm công Ronald Jack, chỉ hoạt động trên môi trường Windows có hỗ trợ COM và thư viện zkemkeeper.dll. Cần cài đặt driver và phần mềm Ronald Jack tương thích.

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance85

Actively maintained with recent releases

Popularity22

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 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

Every ~198 days

Total

4

Last Release

79d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/90fcb59bfa8097c0e0dacd05f43901adb774dc4adb6172b2b743635f8f3d1d2e?d=identicon)[caothu159](/maintainers/caothu159)

---

Top Contributors

[![caothu159](https://avatars.githubusercontent.com/u/4988663?v=4)](https://github.com/caothu159 "caothu159 (10 commits)")

### Embed Badge

![Health badge](/badges/diepxuan-laravel-ronaldjack/health.svg)

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

PHPackages © 2026

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