PHPackages                             rafgrando/portunus - 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. rafgrando/portunus

ActiveLibrary

rafgrando/portunus
==================

PHP library for physical access control

v1.0.0(1mo ago)00MITPHP

Since Jul 16Pushed 4w agoCompare

[ Source](https://github.com/rafgrando/portunus)[ Packagist](https://packagist.org/packages/rafgrando/portunus)[ RSS](/packages/rafgrando-portunus/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependenciesVersions (2)Used By (0)

Portunus 🗝️
===========

[](#portunus-️)

[![Latest Stable Version](https://camo.githubusercontent.com/d65c66f140f105ec89ffc55396d9c96ed7f3273270ed31a6699618b940302898/68747470733a2f2f706f7365722e707567782e6f72672f7261666772616e646f2f706f7274756e75732f762f737461626c65)](https://packagist.org/packages/rafgrando/portunus)[![License](https://camo.githubusercontent.com/94795a3db34d57f972e2e43eda598286aae066dd0a86126c7144e1c689e70c66/68747470733a2f2f706f7365722e707567782e6f72672f7261666772616e646f2f706f7274756e75732f6c6963656e7365)](https://packagist.org/packages/rafgrando/portunus)

**Portunus** is a modern PHP library designed for seamless integration with physical access control hardware. It currently supports TCP/IP communication with the **Nice / Linear-HCS MG3000 Gatekeeper Module (Módulo Guarita)**, a widely adopted industry standard for condominium and corporate security in Latin America, as well as with Comm5's MA I/O modules.

---

Why "Portunus"?
---------------

[](#why-portunus)

> In ancient Roman religion and mythology, **Portunus** was the god of keys, doors, gates, and cattle. He was traditionally depicted holding a key, guarding the crossings and entryways.
>
> This library acts as a digital key, bridging modern PHP applications with physical entryways, gates, and security barriers.

---

Features
--------

[](#features)

- **TCP/IP Native Socket Connection:** Lightweight, fast, and robust socket-level communication with the MG3000 and Comm5 MA.
- **Command & Frame Parsing:** Built-in abstraction for raw byte frames, saving you from dealing with low-level buffer manipulation manually.
- **PSR-4 Compliant:** Clean, modern, and fully compatible with Composer-based workflows.

---

Installation
------------

[](#installation)

Install the package via [Composer](https://getcomposer.org/):

```
composer require rafgrando/portunus
```

Contributing
------------

[](#contributing)

Contributions are welcome! If you want to add support for other physical access control devices, relay boards, or serial (RS232/RS485) communication, feel free to open a Pull Request or start an Issue.

License
-------

[](#license)

Distributed under the MIT License. See LICENSE for more information. This ensures you are free to use this library in personal, open-source, or proprietary commercial products without licensing friction.

Developed with 💻 and ☕ by Rafael Grando.

###  Health Score

34

—

LowBetter than 74% of packages

Maintenance93

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

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

Unknown

Total

1

Last Release

46d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5fb8238d727eed53a59c2026e2f20e792c394eacd3e83910c76ec191146ab925?d=identicon)[rafgrando](/maintainers/rafgrando)

---

Top Contributors

[![rafgrando](https://avatars.githubusercontent.com/u/289476739?v=4)](https://github.com/rafgrando "rafgrando (15 commits)")

---

Tags

access-controlphp-libraryphysical-access-controlphysical-access-control-systemphysical-access-system

### Embed Badge

![Health badge](/badges/rafgrando-portunus/health.svg)

```
[![Health](https://phpackages.com/badges/rafgrando-portunus/health.svg)](https://phpackages.com/packages/rafgrando-portunus)
```

PHPackages © 2026

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