See Release Notes
Long Term Support Release
<?php /** * Copyright 2012-2017 Horde LLC (http://www.horde.org/) * * See the enclosed file LICENSE for license information (LGPL). If you * did not receive this file, see http://www.horde.org/licenses/lgpl21. * * @category Horde * @copyright 2012-2017 Horde LLC * @license http://www.horde.org/licenses/lgpl21 LGPL 2.1 * @package Imap_Client */ /** * An object implementing lookups between UIDs and message sequence numbers. * * @author Michael Slusarz <slusarz@horde.org> * @category Horde * @copyright 2012-2017 Horde LLC * @license http://www.horde.org/licenses/lgpl21 LGPL 2.1 * @package Imap_Client * @since 2.1.0 * * @property-read array $map The raw ID mapping data. * @property-read Horde_Imap_Client_Ids $seq The sorted sequence values. * @property-read Horde_Imap_Client_Ids $uids The sorted UIDs. */ class Horde_Imap_Client_Ids_Map implements Countable, IteratorAggregate, Serializable { /** * Sequence -> UID mapping. * * @var array */ protected $_ids = array(); /** * Is the array sorted? * * @var boolean */ protected $_sorted = true; /** * Constructor. * * @param array $ids Array of sequence -> UID mapping. */ public function __construct(array $ids = array()) { $this->update($ids); } /** */ public function __get($name) { switch ($name) { case 'map': return $this->_ids; case 'seq': $this->sort(); return new Horde_Imap_Client_Ids(array_keys($this->_ids), true); case 'uids': $this->sort(); return new Horde_Imap_Client_Ids($this->_ids); } } /** * Updates the mapping. * * @param array $ids Array of sequence -> UID mapping. * * @return boolean True if the mapping changed. */ public function update($ids) { if (empty($ids)) { return false; } elseif (empty($this->_ids)) { $this->_ids = $ids; $change = true; } else { $change = false; foreach ($ids as $k => $v) { if (!isset($this->_ids[$k]) || ($this->_ids[$k] != $v)) { $this->_ids[$k] = $v; $change = true; } } } if ($change) { $this->_sorted = false; } return $change; } /** * Create a Sequence <-> UID lookup table. * * @param Horde_Imap_Client_Ids $ids IDs to lookup. * * @return array Keys are sequence numbers, values are UIDs. */ public function lookup(Horde_Imap_Client_Ids $ids) { if ($ids->all) { return $this->_ids; } elseif ($ids->sequence) { return array_intersect_key($this->_ids, array_flip($ids->ids)); } return array_intersect($this->_ids, $ids->ids); } /** * Removes messages from the ID mapping. * * @param Horde_Imap_Client_Ids $ids IDs to remove. */ public function remove(Horde_Imap_Client_Ids $ids) { /* For sequence numbers, we need to reindex anytime we have an index * that appears equal to or after a previously seen index. If an IMAP * server is smart, it will expunge in reverse order instead. */ if ($ids->sequence) { $remove = $ids->ids; } else { $ids->sort(); $remove = array_reverse(array_keys($this->lookup($ids))); } if (empty($remove)) { return; } $this->sort(); if (count($remove) == count($this->_ids) && !array_diff($remove, array_keys($this->_ids))) { $this->_ids = array(); return; } /* Find the minimum sequence number to remove. We know entries before * this are untouched so no need to process them multiple times. */ $first = min($remove); $edit = $newids = array(); foreach (array_keys($this->_ids) as $i => $seq) { if ($seq >= $first) { $i += (($seq == $first) ? 0 : 1); $newids = array_slice($this->_ids, 0, $i, true); $edit = array_slice($this->_ids, $i + (($seq == $first) ? 0 : 1), null, true); break; } } if (!empty($edit)) { foreach ($remove as $val) { $found = false; $tmp = array(); foreach (array_keys($edit) as $i => $seq) { if ($found) { $tmp[$seq - 1] = $edit[$seq]; } elseif ($seq >= $val) { $tmp = array_slice($edit, 0, ($seq == $val) ? $i : $i + 1, true); $found = true; } } $edit = $tmp; } } $this->_ids = $newids + $edit; } /** * Sort the map. */ public function sort() { if (!$this->_sorted) { ksort($this->_ids, SORT_NUMERIC); $this->_sorted = true; } } /* Countable methods. */ /** */> #[ReturnTypeWillChange]public function count() { return count($this->_ids); } /* IteratorAggregate method. */ /** */> #[ReturnTypeWillChange]public function getIterator() { return new ArrayIterator($this->_ids); } /* Serializable methods. */> public function serialize() /** > { */ > return serialize($this->__serialize()); public function serialize() > } { > /* Sort before storing; provides more compressible representation. */ > public function unserialize($data) $this->sort(); > { > $data = @unserialize($data); return json_encode(array( > if (!is_array($data)) { strval(new Horde_Imap_Client_Ids(array_keys($this->_ids))), > throw new Exception('Cache version change.'); strval(new Horde_Imap_Client_Ids(array_values($this->_ids))) > } )); > $this->__unserialize($data); } > } >< public function serialize()> public function __serialize()< return json_encode(array(> return [< ));> ];< public function unserialize($data)> public function __unserialize($data)< $data = json_decode($data, true); <$keys = new Horde_Imap_Client_Ids($data[0]); $vals = new Horde_Imap_Client_Ids($data[1]); $this->_ids = array_combine($keys->ids, $vals->ids); /* Guaranteed to be sorted if unserializing. */ $this->_sorted = true; } }