/usr/share/php/Horde/Kolab/Storage/Synchronization/TimeBased.php is in php-horde-kolab-storage 2.0.5-1.
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 | <?php
/**
* Synchronization strategy that synchronizes at certain intervals.
*
* PHP version 5
*
* @category Kolab
* @package Kolab_Storage
* @author Thomas Jarosch <thomas.jarosch@intra2net.com>
* @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_Storage
*/
/**
* Synchronization strategy that synchronizes at certain intervals.
*
* Copyright 2012-2013 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_Storage
* @author Thomas Jarosch <thomas.jarosch@intra2net.com>
* @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_Storage
*/
class Horde_Kolab_Storage_Synchronization_TimeBased
extends Horde_Kolab_Storage_Synchronization
{
/**
* Kolab object cache resync interval with the IMAP server (in seconds).
* Default: Two minutes
*
* @var int
*/
private $_interval;
/**
* Random offset added to each folder sync interval to prevent mass sync
* every XX minutes. Otherwise UI latency might get too high.
*
* @var int
*/
private $_random_offset;
/**
* Constructor.
*
* @param int $interval Kolab object cache resync interval with the IMAP server (in seconds).
* @param int $random_offset Random offset added to each folder sync interval.
*/
public function __construct($interval = 120, $random_offset = 90)
{
$this->_interval = $interval;
$this->_random_offset = $random_offset;
}
/**
* Synchronize the provided list in case the selected synchronization
* strategy requires it.
*
* @param Horde_Kolab_Storage_List $list The list to synchronize.
*/
public function synchronizeList(Horde_Kolab_Storage_List_Tools $list)
{
$list_id = $list->getId();
if (empty($_SESSION['kolab_storage']['synchronization']['list'][$list_id])) {
$list->getListSynchronization()->synchronize();
$_SESSION['kolab_storage']['synchronization']['list'][$list_id] = true;
}
}
/**
* Synchronize the provided data in case the selected synchronization
* strategy requires it.
*
* @param Horde_Kolab_Storage_Data $data The data to synchronize.
*/
public function synchronizeData(Horde_Kolab_Storage_Data $data)
{
$data_id = $data->getId();
if ($this->hasNotBeenSynchronizedYet($data_id) || $this->syncTimeHasElapsed($data_id)) {
$data->synchronize();
$_SESSION['kolab_storage']['synchronization']['data'][$data_id] = time() + $this->_interval + rand(0, $this->_random_offset);
}
}
/**
* Check if the data store with the given data ID has been synchronized already during this session.
*
* @param string $data_id The ID of the data store.
*
* @return boolean True, if the store has not been synchronized yet.
*/
private function hasNotBeenSynchronizedYet($data_id)
{
return empty($_SESSION['kolab_storage']['synchronization']['data'][$data_id]);
}
/**
* Check if the data store with the given data ID need to be resynchronized with the backend.
*
* @param string $data_id The ID of the data store.
*
* @return boolean True, if the store needs to be synchronized again.
*/
private function syncTimeHasElapsed($data_id)
{
return $_SESSION['kolab_storage']['synchronization']['data'][$data_id] < time();
}
}
|