PHPackages                             immense/macaroons - 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. [Authentication & Authorization](/categories/authentication)
4. /
5. immense/macaroons

ActiveLibrary[Authentication & Authorization](/categories/authentication)

immense/macaroons
=================

PHP implementation of Macaroons

2.0.0(6y ago)2755.2k↓53.9%3[1 issues](https://github.com/immense/php-macaroons/issues)[1 PRs](https://github.com/immense/php-macaroons/pulls)1MITPHPPHP >=7.2.0

Since Apr 22Pushed 11mo ago9 watchersCompare

[ Source](https://github.com/immense/php-macaroons)[ Packagist](https://packagist.org/packages/immense/macaroons)[ RSS](/packages/immense-macaroons/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependenciesVersions (23)Used By (1)

Macaroons
---------

[](#macaroons)

[![Build Status](https://camo.githubusercontent.com/1c2b8611feaea8d3a80063ffdc4a24bec8d4b398b3f99e05feb403a778118899/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f696d6d656e73652f7068702d6d616361726f6f6e732e737667)](https://travis-ci.org/immense/php-macaroons)[![Latest Stable Version](https://camo.githubusercontent.com/0db7db9a0cbf9f4c095beddf632ca785673f6661f24d16114a3a472911266fe0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f696d6d656e73652f6d616361726f6f6e732e737667)](https://packagist.org/packages/immense/macaroons)[![License](https://camo.githubusercontent.com/1a25b7cabc3a74cb1efdb74ba2ed0696cf74adf7e2491d02b00c0acc289561f0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f696d6d656e73652f6d616361726f6f6e732e737667)](https://packagist.org/packages/immense/macaroons)[![Coverage Status](https://camo.githubusercontent.com/59e13532409cd1115ef8495e2224e642a7c0f5b79c67b24e5d4e2a2bbd81b3c1/68747470733a2f2f696d672e736869656c64732e696f2f636f766572616c6c732f696d6d656e73652f7068702d6d616361726f6f6e732e737667)](https://coveralls.io/r/immense/php-macaroons?branch=master)

This PHP library provides an implementation of [macaroons](http://hackingdistributed.com/2014/05/16/macaroons-are-better-than-cookies) which allow decentralized delegation, attenuation, and verification.

Requirements
------------

[](#requirements)

- [PHP >= 5.4.0](http://php.net)
- [libsodium 1.x](https://github.com/jedisct1/libsodium)
- [libsodium-php 1.x](https://github.com/jedisct1/libsodium-php)

**Note: libsodium-php 2.x may be used with the [compatibility layer](https://github.com/jedisct1/libsodium-php#libsodium-php-1x-compatibility-api-for-libsodium-php-2x) until this package is updated.**

**libsodium is available with PHP 7.2**

Installing `libsodium-php`
--------------------------

[](#installing-libsodium-php)

- OS X using [homebrew](https://github.com/Homebrew/homebrew)

    ```
    brew tap homebrew/php
    brew install php55-libsodium
    ```
- Using `pecl`

    ```
    pecl install libsodium
    ```

Installation via [composer](https://getcomposer.org)
----------------------------------------------------

[](#installation-via-composer)

In your project directory:

- Create a `composer.json` in your project if necessary

    ```
    composer init
    ```
- Install the latest version as a project dependency

    ```
    composer require immense/macaroons
    ```

Tests
-----

[](#tests)

N.B. phpunit 5 requires PHP >= 5.6

Files must end with `Test` e.g. `ClassTest.php`

- From the `php-macaroons` root directory:

    ```
    phpunit
    ```
- Run tests on file change (optional)

    ```
    gem install watchr
    watchr ./autotest-watchr.rb
    ```

License
-------

[](#license)

[php-macaroons](https://github.com/immense/php-macaroons) is licensed under the MIT license. Please see the [license](MIT-LICENSE) for more information.

###  Health Score

44

—

FairBetter than 90% of packages

Maintenance36

Infrequent updates — may be unmaintained

Popularity40

Moderate usage in the ecosystem

Community18

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 97.9% 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 ~86 days

Recently: every ~405 days

Total

20

Last Release

2451d ago

Major Versions

0.5.4 → 1.0.02015-12-24

1.0.0 → 2.0.02019-10-17

PHP version history (3 changes)0.1.0PHP >=5.3.6

0.5.4PHP >=5.3.0

2.0.0PHP >=7.2.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/e9b5099ac53735e6e5482b7b2cbc8063ee2f931643bf311b9969d804ced7bf6e?d=identicon)[immensenet](/maintainers/immensenet)

---

Top Contributors

[![cmckni3](https://avatars.githubusercontent.com/u/735717?v=4)](https://github.com/cmckni3 "cmckni3 (93 commits)")[![bosko-htec](https://avatars.githubusercontent.com/u/54990036?v=4)](https://github.com/bosko-htec "bosko-htec (1 commits)")[![cmbankester](https://avatars.githubusercontent.com/u/337779?v=4)](https://github.com/cmbankester "cmbankester (1 commits)")

---

Tags

Authenticationauthorizationmacaroons

### Embed Badge

![Health badge](/badges/immense-macaroons/health.svg)

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

###  Alternatives

[league/oauth2-server

A lightweight and powerful OAuth 2.0 authorization and resource server library with support for all the core specification grants. This library will allow you to secure your API with OAuth and allow your applications users to approve apps that want to access their data from your API.

6.7k147.0M290](/packages/league-oauth2-server)[league/oauth2-client

OAuth 2.0 Client Library

3.8k128.7M1.3k](/packages/league-oauth2-client)[league/oauth1-client

OAuth 1.0 Client Library

996110.3M118](/packages/league-oauth1-client)[hybridauth/hybridauth

PHP Social Authentication Library

3.4k9.0M108](/packages/hybridauth-hybridauth)[lusitanian/oauth

PHP 7.2 oAuth 1/2 Library

1.1k24.0M133](/packages/lusitanian-oauth)[league/oauth2-google

Google OAuth 2.0 Client Provider for The PHP League OAuth2-Client

42223.4M176](/packages/league-oauth2-google)

PHPackages © 2026

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