<?php namespace Sabre\CalDAV\Principal; use Sabre\DAV; use Sabre\DAVACL; /** * 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. * * @copyright Copyright (C) fruux GmbH (https://fruux.com/) * @author Evert Pot (http://evertpot.com/) * @license http://sabre.io/license/ Modified BSD License */ class User extends DAVACL\Principal implements DAV\ICollection { /** * Creates a new file in the directory * * @param string $name Name of the file * @param resource $data Initial payload, passed as a readable stream resource. * @throws DAV\Exception\Forbidden * @return void */ function createFile($name, $data = null) { throw new DAV\Exception\Forbidden('Permission denied to create file (filename ' . $name . ')'); } /** * Creates a new subdirectory * * @param string $name * @throws DAV\Exception\Forbidden * @return void */ function createDirectory($name) { throw new DAV\Exception\Forbidden('Permission denied to create directory'); } /** * Returns a specific child node, referenced by its name * * @param string $name * @return DAV\INode */ function getChild($name) { $principal = $this->principalBackend->getPrincipalByPath($this->getPrincipalURL() . '/' . $name); if (!$principal) { throw new DAV\Exception\NotFound('Node with name ' . $name . ' was not found'); } if ($name === 'calendar-proxy-read') return new ProxyRead($this->principalBackend, $this->principalProperties); if ($name === 'calendar-proxy-write') return new ProxyWrite($this->principalBackend, $this->principalProperties); throw new DAV\Exception\NotFound('Node with name ' . $name . ' was not found'); } /** * Returns an array with all the child nodes * * @return DAV\INode[] */ function getChildren() { $r = []; if ($this->principalBackend->getPrincipalByPath($this->getPrincipalURL() . '/calendar-proxy-read')) { $r[] = new ProxyRead($this->principalBackend, $this->principalProperties); } if ($this->principalBackend->getPrincipalByPath($this->getPrincipalURL() . '/calendar-proxy-write')) { $r[] = new ProxyWrite($this->principalBackend, $this->principalProperties); } return $r; } /** * Returns whether or not the child node exists * * @param string $name * @return bool */ function childExists($name) { try { $this->getChild($name); return true; } catch (DAV\Exception\NotFound $e) { return false; } } /** * Returns a list of ACE's for this node. * * 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 array */ function getACL() { $acl = parent::getACL(); $acl[] = [ 'privilege' => '{DAV:}read', 'principal' => $this->principalProperties['uri'] . '/calendar-proxy-read', 'protected' => true, ]; $acl[] = [ 'privilege' => '{DAV:}read', 'principal' => $this->principalProperties['uri'] . '/calendar-proxy-write', 'protected' => true, ]; return $acl; } }