Acl.php
1.59 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
<?php 
namespace Phalcon {
	/**
	 * Phalcon\Acl
	 *
	 * This component allows to manage ACL lists. An access control list (ACL) is a list
	 * of permissions attached to an object. An ACL specifies which users or system processes
	 * are granted access to objects, as well as what operations are allowed on given objects.
	 *
	 *<code>
	 *
	 *	$acl = new Phalcon\Acl\Adapter\Memory();
	 *
	 *	//Default action is deny access
	 *	$acl->setDefaultAction(Phalcon\Acl::DENY);
	 *
	 *	//Create some roles
	 *	$roleAdmins = new Phalcon\Acl\Role('Administrators', 'Super-User role');
	 *	$roleGuests = new Phalcon\Acl\Role('Guests');
	 *
	 *	//Add "Guests" role to acl
	 *	$acl->addRole($roleGuests);
	 *
	 *	//Add "Designers" role to acl
	 *	$acl->addRole('Designers');
	 *
	 *	//Define the "Customers" resource
	 *	$customersResource = new Phalcon\Acl\Resource('Customers', 'Customers management');
	 *
	 *	//Add "customers" resource with a couple of operations
	 *	$acl->addResource($customersResource, 'search');
	 *	$acl->addResource($customersResource, array('create', 'update'));
	 *
	 *	//Set access level for roles into resources
	 *	$acl->allow('Guests', 'Customers', 'search');
	 *	$acl->allow('Guests', 'Customers', 'create');
	 *	$acl->deny('Guests', 'Customers', 'update');
	 *
	 *	//Check whether role has access to the operations
	 *	$acl->isAllowed('Guests', 'Customers', 'edit'); //Returns 0
	 *	$acl->isAllowed('Guests', 'Customers', 'search'); //Returns 1
	 *	$acl->isAllowed('Guests', 'Customers', 'create'); //Returns 1
	 *
	 *</code>
	 */
	
	abstract class Acl {
		const ALLOW = 1;
		const DENY = 0;
	}
}