User

CalDAV principal.

This is a standard user-principal for CalDAV. This principal is also a collection and returns the caldav-proxy-read and caldav-proxy-write child principals.

• Full name: \Sabre\CalDAV\Principal\User
• Parent class: \Sabre\DAVACL\Principal
• This class implements: \Sabre\DAV\ICollection

Methods

createFile

Creates a new file in the directory.

public createFile(string $name, resource $data = null): string|null

Parameters:

Parameter	Type	Description
$name	string	Name of the file
$data	resource	initial payload, passed as a readable stream resource

Throws:

• Forbidden

---

createDirectory

Creates a new subdirectory.

public createDirectory(string $name): mixed

Parameters:

Parameter	Type	Description
$name	string

Throws:

• Forbidden

---

getChild

Returns a specific child node, referenced by its name.

public getChild(string $name): \Sabre\DAV\INode

Parameters:

Parameter	Type	Description
$name	string

---

getChildren

Returns an array with all the child nodes.

public getChildren(): \Sabre\DAV\INode[]

---

childExists

Returns whether or not the child node exists.

public childExists(string $name): bool

Parameters:

Parameter	Type	Description
$name	string

---

getACL

Returns a list of ACE's for this node.

public getACL(): array

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.

---

Inherited methods

getLastModified

Returns the last modification time as a unix timestamp.

public getLastModified(): int

If the information is not available, return null.

---

delete

Deletes the current node.

public delete(): mixed

Throws:

• Forbidden

---

setName

Renames the node.

public setName(string $name): mixed

Parameters:

Parameter	Type	Description
$name	string	The new name

Throws:

• Forbidden

---

getOwner

Returns the owner principal.

public getOwner(): string|null

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

---

getGroup

Returns a group principal.

public getGroup(): string|null

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

---

getACL

Returns a list of ACE's for this node.

public getACL(): array

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.

---

setACL

Updates the ACL.

public setACL(array $acl): mixed

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

Parameters:

Parameter	Type	Description
$acl	array

---

getSupportedPrivilegeSet

Returns the list of supported privileges for this node.

public getSupportedPrivilegeSet(): array|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.

---

__construct

Creates the principal object.

public __construct(\Sabre\DAVACL\PrincipalBackend\BackendInterface $principalBackend, array $principalProperties = []): mixed

Parameters:

Parameter	Type	Description
$principalBackend	\Sabre\DAVACL\PrincipalBackend\BackendInterface
$principalProperties	array

---

getPrincipalUrl

Returns the full principal url.

public getPrincipalUrl(): string

---

getAlternateUriSet

Returns a list of alternative urls for a principal.

public getAlternateUriSet(): array

This can for example be an email address, or ldap url.

---

getGroupMemberSet

Returns the list of group members.

public getGroupMemberSet(): array

If this principal is a group, this function should return all member principal uri's for the group.

---

getGroupMembership

Returns the list of groups this principal is member of.

public getGroupMembership(): array

If this principal is a member of a (list of) groups, this function should return a list of principal uri's for it's members.

---

setGroupMemberSet

Sets a list of group members.

public setGroupMemberSet(array $groupMembers): mixed

If this principal is a group, this method sets all the group members. The list of members is always overwritten, never appended to.

This method should throw an exception if the members could not be set.

Parameters:

Parameter	Type	Description
$groupMembers	array

---

getName

Returns this principals name.

public getName(): string

---

getDisplayName

Returns the name of the user.

public getDisplayName(): string

---

getProperties

Returns a list of properties.

public getProperties(array $requestedProperties): array

Parameters:

Parameter	Type	Description
$requestedProperties	array

---

propPatch

Updates properties on this node.

public propPatch(\Sabre\DAV\PropPatch $propPatch): mixed

This method received a PropPatch object, which contains all the information about the update.

To update specific properties, call the 'handle' method on this object. Read the PropPatch documentation for more information.

Parameters:

Parameter	Type	Description
$propPatch	\Sabre\DAV\PropPatch

---

---

Automatically generated on 2025-03-18