owasp/phprbac

PHP-RBAC is the de-facto authorization library for PHP. It provides developers with NIST Level 2 Standard Role Based Access Control and more, in the fastest implementation yet.

PHP-RBAC v2.x

PHP-RBAC is the de-facto authorization library for PHP. It provides developers with NIST Level 2 Hierarchical Role Based Access Control and more, in the fastest implementation yet., _(*1)

Current Stable Release: PHP-RBAC v2.0, _(*2)

• Home Page: http://phprbac.net/
• OWASP Project Page: https://www.owasp.org/index.php/Phprbac
• User Documentation: http://phprbac.net/docs_contents.php
• Development Documentation: https://github.com/OWASP/rbac/wiki
• Support: https://github.com/OWASP/rbac/issues?state=open

What is an Rbac System?

Take a look at the "Before You Begin" section of our Documentation to learn what an RBAC system is and what PHP-RBAC has to offer you and your project., _(*3)

NIST Level 2 Compliance

For information regarding NIST RBAC Levels, please see This Paper., _(*4)

For more great resources see the NIST RBAC Group Page., _(*5)

Installation

You can now use Composer to install the PHP-RBAC code base., _(*6)

For Installation Instructions please refer to the "Getting Started" section of our Documentation., _(*7)

Usage

Instantiating a PHP-RBAC Object, _(*8)

With a 'use' statement:, _(*9)

use PhpRbac;

$rbac = new Rbac();

Without a 'use' statement, outside of a namespace:, _(*10)

$rbac = new PhpRbac\Rbac();

Without a 'use' statement, inside of another namespace (notice the leading backslash):, _(*11)

$rbac = new \PhpRbac\Rbac();

PHP-RBAC and PSR

PHP-RBAC's Public API is now fully PSR-0, PSR-1 and PSR-2 compliant., _(*12)

You can now:, _(*13)

• Use Composer to install/update PHP-RBAC
• Use any PSR-0 compliant autoloader with PHP-RBAC
• Use the included autoloader to load PHP-RBAC

If you notice any conflicts with PSR compliance please Submit an Issue., _(*14)

The future of PHP-RBAC

We are in the process of refactoring the PHP-RBAC internals. We have two goals in mind while doing this:, _(*15)

• To meet modern PHP OOP "Best Practices"
• To meet PHP-FIG PSR compliance: http://www.php-fig.org/

With a PSR compliant Public API already in place we can continue to work towards our goals one piece at a time without altering the Public API that developers are working with and rely on, making the transition as seamless and invisible as possible., _(*16)

Contributing

We welcome all contributions that will help make PHP-RBAC even better tomorrow than it is today!, _(*17)

How You Can Help:, _(*18)

• Report Bugs, Enhancement Requests or Documentation errors using our Issue Tracker
• Choose a Bug to work on and submit a Pull Request
• Make helpful suggestions and contributions to the Documentation using our Issue Tracker
• Spread the word about PHP-RBAC by:
  • Creating Tutorials
  • Blogging
  • Tweeting
  • Facebooking
  • Google+ing
  • Talking to friends and colleagues about us