class PhpRedis in Redis 8

Redis queue implementation using PhpRedis extension backend.

Hierarchy

• class \Drupal\redis\Queue\QueueBase implements QueueInterface
  • class \Drupal\redis\Queue\PhpRedis

4 string references to 'PhpRedis'

ClientFactory::getClientInterface in src/ClientFactory.php

Lazy instantiates client proxy depending on the actual configuration.

PhpRedis::getName in src/Client/PhpRedis.php

Get underlying library name used.

RedisCacheTagsChecksum::doInvalidateTags in src/Cache/RedisCacheTagsChecksum.php

Marks cache items with any of the specified tags as invalid.

RedisTestInterfaceTrait::getRedisInterfaceEnv in tests/src/Traits/RedisTestInterfaceTrait.php

Uses an env variable to set the redis client to use for this test.

File

src/Queue/PhpRedis.php, line 10

Namespace

Drupal\redis\Queue

class PhpRedis extends QueueBase {

  /**
   * The Redis connection.
   *
   * @var \Redis $client
   */
  protected $client;

  /**
   * Constructs a \Drupal\redis\Queue\PhpRedis object.
   *
   * @param string $name
   *   The name of the queue.
   * @param array $settings
   *   Array of Redis-related settings for this queue.
   * @param \Redis $client
   *   The PhpRedis client.
   */
  public function __construct($name, array $settings, \Redis $client) {
    parent::__construct($name, $settings);
    $this->client = $client;
  }

  /**
   * {@inheritdoc}
   */
  public function createItem($data) {
    $record = new \stdClass();
    $record->data = $data;
    $record->qid = $this
      ->incrementId();

    // We cannot rely on REQUEST_TIME because many items might be created
    // by a single request which takes longer than 1 second.
    $record->timestamp = time();
    if (!$this->client
      ->hsetnx($this->availableItems, $record->qid, serialize($record))) {
      return FALSE;
    }
    $start_len = $this->client
      ->lLen($this->availableListKey);
    if ($start_len < $this->client
      ->lpush($this->availableListKey, $record->qid)) {
      return $record->qid;
    }
    return FALSE;
  }

  /**
   * Gets next serial ID for Redis queue items.
   *
   * @return int
   *   Next serial ID for Redis queue item.
   */
  protected function incrementId() {
    return $this->client
      ->incr($this->incrementCounterKey);
  }

  /**
   * {@inheritdoc}
   */
  public function numberOfItems() {
    return $this->client
      ->lLen($this->availableListKey) + $this->client
      ->lLen($this->claimedListKey);
  }

  /**
   * {@inheritdoc}
   */
  public function claimItem($lease_time = 30) {

    // Is it OK to do garbage collection here (we need to loop list of claimed
    // items)?
    $this
      ->garbageCollection();
    $item = FALSE;
    if ($this->reserveTimeout !== NULL) {

      // A blocking version of claimItem to be used with long-running queue workers.
      $qid = $this->client
        ->brpoplpush($this->availableListKey, $this->claimedListKey, $this->reserveTimeout);
    }
    else {
      $qid = $this->client
        ->rpoplpush($this->availableListKey, $this->claimedListKey);
    }
    if ($qid) {
      $job = $this->client
        ->hget($this->availableItems, $qid);
      if ($job) {
        $item = unserialize($job);
        $this->client
          ->setex($this->leasedKeyPrefix . $item->qid, $lease_time, '1');
      }
    }
    return $item;
  }

  /**
   * {@inheritdoc}
   */
  public function releaseItem($item) {
    $this->client
      ->lrem($this->claimedListKey, $item->qid, -1);
    $this->client
      ->lpush($this->availableListKey, $item->qid);
  }

  /**
   * {@inheritdoc}
   */
  public function deleteItem($item) {
    $this->client
      ->lrem($this->claimedListKey, $item->qid, -1);
    $this->client
      ->hdel($this->availableItems, $item->qid);
  }

  /**
   * {@inheritdoc}
   */
  public function deleteQueue() {
    $keys_to_remove = [
      $this->claimedListKey,
      $this->availableListKey,
      $this->availableItems,
      $this->incrementCounterKey,
    ];
    foreach ($this->client
      ->keys($this->leasedKeyPrefix . '*') as $key) {
      $keys_to_remove[] = $key;
    }
    $this->client
      ->del($keys_to_remove);
  }

  /**
   * Automatically release items, that have been claimed and exceeded lease time.
   */
  protected function garbageCollection() {
    foreach ($this->client
      ->lrange($this->claimedListKey, 0, -1) as $qid) {
      if (!$this->client
        ->exists($this->leasedKeyPrefix . $qid)) {

        // The lease expired for this ID.
        $this->client
          ->lrem($this->claimedListKey, $qid, -1);
        $this->client
          ->lpush($this->availableListKey, $qid);
      }
    }
  }

}

Members

Name	Modifiers	Type	Description	Overrides
PhpRedis::$client	protected	property	The Redis connection.
PhpRedis::claimItem	public	function	Claims an item in the queue for processing. Overrides QueueInterface::claimItem
PhpRedis::createItem	public	function	Adds a queue item and store it directly to the queue. Overrides QueueInterface::createItem
PhpRedis::deleteItem	public	function	Deletes a finished item from the queue. Overrides QueueInterface::deleteItem
PhpRedis::deleteQueue	public	function	Deletes a queue and every item in the queue. Overrides QueueInterface::deleteQueue
PhpRedis::garbageCollection	protected	function	Automatically release items, that have been claimed and exceeded lease time.
PhpRedis::incrementId	protected	function	Gets next serial ID for Redis queue items.
PhpRedis::numberOfItems	public	function	Retrieves the number of items in the queue. Overrides QueueInterface::numberOfItems
PhpRedis::releaseItem	public	function	Releases an item that the worker could not process. Overrides QueueInterface::releaseItem
PhpRedis::__construct	public	function	Constructs a \Drupal\redis\Queue\PhpRedis object. Overrides QueueBase::__construct
QueueBase::$availableItems	protected	property	Key for hash table of available queue items.
QueueBase::$availableListKey	protected	property	Key for list of available items.
QueueBase::$claimedListKey	protected	property	Key for list of claimed items.
QueueBase::$incrementCounterKey	protected	property	Key of increment counter key.
QueueBase::$leasedKeyPrefix	protected	property	Key prefix for items that are used to track expiration of leased items.
QueueBase::$name	protected	property	The name of the queue this instance is working with.
QueueBase::$reserveTimeout	protected	property	Reserve timeout for blocking item claim.
QueueBase::createQueue	public	function	Creates a queue. Overrides QueueInterface::createQueue
QueueBase::KEY_PREFIX		constant	Prefix used with all keys.