friendica-addons/dav/friendica/dav_friendica_principal.inc.php

<?php


class Sabre_DAVACL_PrincipalBackend_Std implements Sabre_DAVACL_IPrincipalBackend
{

	/**
	 * Principals prefix
	 *
	 * @var string
	 */
	public $prefix = 'principals/users';

	/**
	 * @var Sabre_DAV_Auth_Backend_AbstractBasic $authBackend;
	 */
	protected $authBackend;

	public function __construct(&$authBackend)
	{

		$this->authBackend = &$authBackend;

	}


	/**
	 * @var Sabre_DAVACL_IPrincipalBackend|null
	 */
	private static $intstance = null;

	/**
	 * @static
	 * @return Sabre_DAVACL_IPrincipalBackend
	 */
	public static function &getInstance() {
		if (is_null(self::$intstance)) {
			$authBackend              = Sabre_DAV_Auth_Backend_Std::getInstance();
			self::$intstance = new Sabre_DAVACL_PrincipalBackend_Std($authBackend);
		}
		return self::$intstance;
	}

	/**
	 * Returns a list of principals based on a prefix.
	 *
	 * This prefix will often contain something like 'principals'. You are only
	 * expected to return principals that are in this base path.
	 *
	 * You are expected to return at least a 'uri' for every user, you can
	 * return any additional properties if you wish so. Common properties are:
	 *   {DAV:}displayname
	 *   {http://sabredav.org/ns}email-address - This is a custom SabreDAV
	 *     field that's actualy injected in a number of other properties. If
	 *     you have an email address, use this property.
	 *
	 * @param string $prefixPath
	 * @return array
	 */
	public function getPrincipalsByPrefix($prefixPath)
	{

		// This backend only support principals in one collection
		if ($prefixPath !== $this->prefix) return array();

		$users = array();

		$r = q("SELECT `nickname` FROM `user` WHERE `nickname` = '%s'", escape_tags($this->authBackend->getCurrentUser()) );
		foreach ($r as $t) {
			$users[] = array(
				'uri'               => $this->prefix . '/' . strtolower($t['nickname']),
				'{DAV:}displayname' => $t['nickname'],
			);
		}

		return $users;

	}

	/**
	 * Returns a specific principal, specified by it's path.
	 * The returned structure should be the exact same as from
	 * getPrincipalsByPrefix.
	 *
	 * @param string $path
	 * @return array
	 */
	public function getPrincipalByPath($path)
	{

		list($prefixPath, $userName) = Sabre_DAV_URLUtil::splitPath($path);

		// This backend only support principals in one collection
		if ($prefixPath !== $this->prefix) return null;

		$r = q("SELECT `nickname` FROM `user` WHERE `nickname` = '%s'", escape_tags($userName) );
		if (count($r) == 0) return array();

		return array(
			'uri'               => $this->prefix . '/' . strtolower($r[0]['nickname']),
			'{DAV:}displayname' => $r[0]['nickname'],
		);

	}


	function getGroupMemberSet($principal)
	{
		return array();
	}

	function getGroupMembership($principal)
	{
		return array();
	}


	/**
	 * Updates the list of group members for a group principal.
	 *
	 * The principals should be passed as a list of uri's.
	 *
	 * @param string $principal
	 * @param array $members
	 * @throws Sabre_DAV_Exception
	 * @return void
	 */
	public function setGroupMemberSet($principal, array $members)
	{
		throw new Sabre_DAV_Exception('Operation not supported');
	}

	/**
	 * Updates one ore more webdav properties on a principal.
	 *
	 * The list of mutations is supplied as an array. Each key in the array is
	 * a propertyname, such as {DAV:}displayname.
	 *
	 * Each value is the actual value to be updated. If a value is null, it
	 * must be deleted.
	 *
	 * This method should be atomic. It must either completely succeed, or
	 * completely fail. Success and failure can simply be returned as 'true' or
	 * 'false'.
	 *
	 * It is also possible to return detailed failure information. In that case
	 * an array such as this should be returned:
	 *
	 * array(
	 *   200 => array(
	 *      '{DAV:}prop1' => null,
	 *   ),
	 *   201 => array(
	 *      '{DAV:}prop2' => null,
	 *   ),
	 *   403 => array(
	 *      '{DAV:}prop3' => null,
	 *   ),
	 *   424 => array(
	 *      '{DAV:}prop4' => null,
	 *   ),
	 * );
	 *
	 * In this previous example prop1 was successfully updated or deleted, and
	 * prop2 was succesfully created.
	 *
	 * prop3 failed to update due to '403 Forbidden' and because of this prop4
	 * also could not be updated with '424 Failed dependency'.
	 *
	 * This last example was actually incorrect. While 200 and 201 could appear
	 * in 1 response, if there's any error (403) the other properties should
	 * always fail with 423 (failed dependency).
	 *
	 * But anyway, if you don't want to scratch your head over this, just
	 * return true or false.
	 *
	 * @param string $path
	 * @param array $mutations
	 * @return array|bool
	 */
	function updatePrincipal($path, $mutations)
	{
		// TODO: Implement updatePrincipal() method.
	}

	/**
	 * This method is used to search for principals matching a set of
	 * properties.
	 *
	 * This search is specifically used by RFC3744's principal-property-search
	 * REPORT. You should at least allow searching on
	 * http://sabredav.org/ns}email-address.
	 *
	 * The actual search should be a unicode-non-case-sensitive search. The
	 * keys in searchProperties are the WebDAV property names, while the values
	 * are the property values to search on.
	 *
	 * If multiple properties are being searched on, the search should be
	 * AND'ed.
	 *
	 * This method should simply return an array with full principal uri's.
	 *
	 * If somebody attempted to search on a property the backend does not
	 * support, you should simply return 0 results.
	 *
	 * You can also just return 0 results if you choose to not support
	 * searching at all, but keep in mind that this may stop certain features
	 * from working.
	 *
	 * @param string $prefixPath
	 * @param array $searchProperties
	 * @return array
	 */
	function searchPrincipals($prefixPath, array $searchProperties)
	{
		// TODO: Implement searchPrincipals() method.
	}
}