README

This PHP library provides an implementation of macaroons which allow decentralized delegation, attenuation, and verification.

Requirements

• PHP >= 5.4.0
• libsodium 1.x
• libsodium-php 1.x

Note: libsodium-php 2.x may be used with the compatibility layer until this package is updated.

libsodium is available with PHP 7.2

Installing libsodium-php

• OS X using homebrew

  brew tap homebrew/php
  brew install php55-libsodium

• Using pecl

  pecl install libsodium

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

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

php-macaroons is licensed under the MIT license. Please see the license for more information.