Documentation

ACLTrait

This trait is a default implementation of the IACL interface.

In many cases you only want to implement 1 or to of the IACL functions, this trait allows you to be a bit lazier.

By default this trait grants all privileges to the owner of the resource.

Tags
copyright

Copyright (C) fruux GmbH (https://fruux.com/)

author

Evert Pot (https://evertpot.com/)

license

http://sabre.io/license/ Modified BSD License

Table of Contents

getACL()  : array<string|int, mixed>
Returns a list of ACE's for this node.
getGroup()  : string|null
Returns a group principal.
getOwner()  : string|null
Returns the owner principal.
getSupportedPrivilegeSet()  : array<string|int, mixed>|null
Returns the list of supported privileges for this node.
setACL()  : mixed
Updates the ACL.

Methods

getACL()

Returns a list of ACE's for this node.

public getACL() : array<string|int, mixed>

Each ACE has the following properties:

  • 'privilege', a string such as {DAV:}read or {DAV:}write. These are currently the only supported privileges
  • 'principal', a url to the principal who owns the node
  • 'protected' (optional), indicating that this ACE is not allowed to be updated.
Return values
array<string|int, mixed>

getGroup()

Returns a group principal.

public getGroup() : string|null

This must be a url to a principal, or null if there's no owner

Return values
string|null

getOwner()

Returns the owner principal.

public getOwner() : string|null

This must be a url to a principal, or null if there's no owner

Return values
string|null

getSupportedPrivilegeSet()

Returns the list of supported privileges for this node.

public getSupportedPrivilegeSet() : array<string|int, mixed>|null

The returned data structure is a list of nested privileges. See Sabre\DAVACL\Plugin::getDefaultSupportedPrivilegeSet for a simple standard structure.

If null is returned from this method, the default privilege set is used, which is fine for most common usecases.

Return values
array<string|int, mixed>|null

setACL()

Updates the ACL.

public setACL(array<string|int, mixed> $acl) : mixed

This method will receive a list of new ACE's as an array argument.

Parameters
$acl : array<string|int, mixed>
Return values
mixed

Search results