/usr/share/php/Horde/Kolab/Server/Object/Groupofnames.php is in php-horde-kolab-server 2.0.5-1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 | <?php
/**
* Representation of a group.
*
* PHP version 5
*
* @category Kolab
* @package Kolab_Server
* @author Gunnar Wrobel <wrobel@pardus.de>
* @license http://www.horde.org/licenses/lgpl21 LGPL 2.1
* @link http://pear.horde.org/index.php?package=Kolab_Server
*/
/**
* This class provides methods to deal with groups.
*
* Copyright 2008-2016 Horde LLC (http://www.horde.org/)
*
* See the enclosed file COPYING for license information (LGPL). If you
* did not receive this file, see http://www.horde.org/licenses/lgpl21.
*
* @category Kolab
* @package Kolab_Server
* @author Gunnar Wrobel <wrobel@pardus.de>
* @license http://www.horde.org/licenses/lgpl21 LGPL 2.1
* @link http://pear.horde.org/index.php?package=Kolab_Server
*/
class Horde_Kolab_Server_Object_Groupofnames extends Horde_Kolab_Server_Object_Top
{
/** The specific object class of this object type */
const OBJECTCLASS_GROUPOFNAMES = 'groupOfNames';
/** Define attributes specific to this object type */
/** The common name */
const ATTRIBUTE_CN = 'cn';
/** The members of this group */
const ATTRIBUTE_MEMBER = 'member';
/**
* A structure to initialize the attribute structure for this class.
*
* @var array
*/
public static $init_attributes = array(
'required' => array(
self::ATTRIBUTE_CN,
self::ATTRIBUTE_MEMBER,
),
'defined' => array(
self::ATTRIBUTE_CN,
self::ATTRIBUTE_MEMBER,
),
'object_classes' => array(
self::OBJECTCLASS_GROUPOFNAMES,
),
);
/**
* Return the filter string to retrieve this object type.
*
* @static
*
* @return string The filter to retrieve this object type from the server
* database.
*/
public static function getFilter()
{
return '(' . self::ATTRIBUTE_OC . '=' . self::OBJECTCLASS_GROUPOFNAMES . ')';
}
/**
* Generates an ID for the given information.
*
* @param array &$info The data of the object.
*
* @static
*
* @return string|PEAR_Error The ID.
*/
public function generateId(array &$info)
{
$id = $info[self::ATTRIBUTE_CN];
if (is_array($id)) {
$id = $id[0];
}
return trim(self::ATTRIBUTE_CN . '=' . $id, " \t\n\r\0\x0B,");
}
/**
* Retrieve the member list for this group.
*
* @return array|PEAR_Error The list of members in this group.
*/
public function getMembers()
{
return $this->get(self::ATTRIBUTE_MEMBER, false);
}
/**
* Add a member to this group.
*
* @param string $member The UID of the member to add.
*
* @return array|PEAR_Error True if successful.
*/
public function addMember($member)
{
if (!in_array($member, $this->getMembers())) {
$this->_cache[self::ATTRIBUTE_MEMBER][] = $member;
} else {
throw new Horde_Kolab_Server_Exception("The UID %s is already a member of the group %s!",
$member, $this->_uid);
}
return $this->save($this->_cache);
}
/**
* Delete a member from this group.
*
* @param string $member The UID of the member to delete.
*
* @return array|PEAR_Error True if successful.
*/
public function deleteMember($member)
{
$members = $this->getMembers();
if (in_array($member, $members)) {
//@todo: As the member attribute is required we may not remove the last member
$this->_cache[self::ATTRIBUTE_MEMBER] =
array_diff($this->_cache[self::ATTRIBUTE_MEMBER],
array($member));
} else {
throw new Horde_Kolab_Server_Exception("The UID %s is no member of the group %s!",
$member, $this->_uid);
}
return $this->save($this->_cache);
}
/**
* Is the specified UID member of this group?
*
* @param string $member The UID of the member to check.
*
* @return boolean|PEAR_Error True if the UID is a member of the group,
* false otherwise.
*/
public function isMember($member)
{
$members = $this->getMembers();
if (!is_array($members)) {
return $member == $members;
}
if (!in_array($member, $members)) {
return false;
} else {
return true;
}
}
}
|