Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
feature #27920 Add Zookeeper data store for Lock Component (Ganesh Ch…
…andrasekaran) This PR was merged into the 4.2-dev branch. Discussion ---------- Add Zookeeper data store for Lock Component | Q | A | ------------- | --- | Branch? | master | Bug fix? | no | New feature? | yes | BC breaks? | no | Deprecations? | no | Tests pass? | yes | Fixed tickets | Not applicable | License | MIT | Doc PR | symfony/symfony-docs#10043 This change adds a new feature to the Lock Component to give the capability to store locks in Zookeeper Data Store. The corresponding documentation PR should describe how this works. The change here also adds a functional test to make sure all the basic functionality of the lock using this data store works. Requirements for this to work are having a PHP-Zookeeper extension available to use this. Commits ------- c72c297 Add new Zookeeper Data Store. Add functional test for Zookeeper Data Store. Modify Store Factory to support initialization of Zookeeper Data Store.
- Loading branch information
Showing
8 changed files
with
274 additions
and
2 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,150 @@ | ||
<?php | ||
|
||
/* | ||
* This file is part of the Symfony package. | ||
* | ||
* (c) Fabien Potencier <fabien@symfony.com> | ||
* | ||
* For the full copyright and license information, please view the LICENSE | ||
* file that was distributed with this source code. | ||
*/ | ||
|
||
namespace Symfony\Component\Lock\Store; | ||
|
||
use Symfony\Component\Lock\Exception\LockAcquiringException; | ||
use Symfony\Component\Lock\Exception\LockConflictedException; | ||
use Symfony\Component\Lock\Exception\LockReleasingException; | ||
use Symfony\Component\Lock\Exception\NotSupportedException; | ||
use Symfony\Component\Lock\Key; | ||
use Symfony\Component\Lock\StoreInterface; | ||
|
||
/** | ||
* ZookeeperStore is a StoreInterface implementation using Zookeeper as store engine. | ||
* | ||
* @author Ganesh Chandrasekaran <gchandrasekaran@wayfair.com> | ||
*/ | ||
class ZookeeperStore implements StoreInterface | ||
{ | ||
private $zookeeper; | ||
|
||
public function __construct(\Zookeeper $zookeeper) | ||
{ | ||
$this->zookeeper = $zookeeper; | ||
} | ||
|
||
/** | ||
* {@inheritdoc} | ||
*/ | ||
public function save(Key $key) | ||
{ | ||
if ($this->exists($key)) { | ||
return; | ||
} | ||
|
||
$resource = $this->getKeyResource($key); | ||
$token = $this->getUniqueToken($key); | ||
|
||
$this->createNewLock($resource, $token); | ||
} | ||
|
||
/** | ||
* {@inheritdoc} | ||
*/ | ||
public function delete(Key $key) | ||
{ | ||
if (!$this->exists($key)) { | ||
return; | ||
} | ||
$resource = $this->getKeyResource($key); | ||
try { | ||
$this->zookeeper->delete($resource); | ||
} catch (\ZookeeperException $exception) { | ||
// For Zookeeper Ephemeral Nodes, the node will be deleted upon session death. But, if we want to unlock | ||
// the lock before proceeding further in the session, the client should be aware of this | ||
throw new LockReleasingException($exception); | ||
} | ||
} | ||
|
||
/** | ||
* {@inheritdoc} | ||
*/ | ||
public function exists(Key $key): bool | ||
{ | ||
$resource = $this->getKeyResource($key); | ||
try { | ||
return $this->zookeeper->get($resource) === $this->getUniqueToken($key); | ||
} catch (\ZookeeperException $ex) { | ||
return false; | ||
} | ||
} | ||
|
||
/** | ||
* {@inheritdoc} | ||
*/ | ||
public function waitAndSave(Key $key) | ||
{ | ||
throw new NotSupportedException(); | ||
} | ||
|
||
/** | ||
* {@inheritdoc} | ||
*/ | ||
public function putOffExpiration(Key $key, $ttl) | ||
{ | ||
throw new NotSupportedException(); | ||
} | ||
|
||
/** | ||
* Creates a zookeeper node. | ||
* | ||
* @param string $node The node which needs to be created | ||
* @param string $value The value to be assigned to a zookeeper node | ||
* | ||
* @throws LockConflictedException | ||
* @throws LockAcquiringException | ||
*/ | ||
private function createNewLock(string $node, string $value) | ||
{ | ||
// Default Node Permissions | ||
$acl = array(array('perms' => \Zookeeper::PERM_ALL, 'scheme' => 'world', 'id' => 'anyone')); | ||
// This ensures that the nodes are deleted when the client session to zookeeper server ends. | ||
$type = \Zookeeper::EPHEMERAL; | ||
|
||
try { | ||
$this->zookeeper->create($node, $value, $acl, $type); | ||
} catch (\ZookeeperException $ex) { | ||
if (\Zookeeper::NODEEXISTS === $ex->getCode()) { | ||
throw new LockConflictedException($ex); | ||
} | ||
|
||
throw new LockAcquiringException($ex); | ||
} | ||
} | ||
|
||
private function getKeyResource(Key $key): string | ||
{ | ||
// Since we do not support storing locks as multi-level nodes, we convert them to be stored at root level. | ||
// For example: foo/bar will become /foo-bar and /foo/bar will become /-foo-bar | ||
$resource = (string) $key; | ||
|
||
if (false !== \strpos($resource, '/')) { | ||
$resource = \strtr($resource, array('/' => '-')).'-'.sha1($resource); | ||
} | ||
|
||
if ('' === $resource) { | ||
$resource = sha1($resource); | ||
} | ||
|
||
return '/'.$resource; | ||
} | ||
|
||
private function getUniqueToken(Key $key): string | ||
{ | ||
if (!$key->hasState(self::class)) { | ||
$token = base64_encode(random_bytes(32)); | ||
$key->setState(self::class, $token); | ||
} | ||
|
||
return $key->getState(self::class); | ||
} | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
108 changes: 108 additions & 0 deletions
108
src/Symfony/Component/Lock/Tests/Store/ZookeeperStoreTest.php
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,108 @@ | ||
<?php | ||
|
||
/* | ||
* This file is part of the Symfony package. | ||
* | ||
* (c) Fabien Potencier <fabien@symfony.com> | ||
* | ||
* For the full copyright and license information, please view the LICENSE | ||
* file that was distributed with this source code. | ||
*/ | ||
|
||
namespace Symfony\Component\Lock\Tests\Store; | ||
|
||
use Symfony\Component\Lock\Key; | ||
use Symfony\Component\Lock\Store\StoreFactory; | ||
use Symfony\Component\Lock\Store\ZookeeperStore; | ||
|
||
/** | ||
* @author Ganesh Chandrasekaran <gchandrasekaran@wayfair.com> | ||
* | ||
* @requires extension zookeeper | ||
*/ | ||
class ZookeeperStoreTest extends AbstractStoreTest | ||
{ | ||
public function getStore(): ZookeeperStore | ||
{ | ||
$zookeeper_server = getenv('ZOOKEEPER_HOST').':2181'; | ||
|
||
$zookeeper = new \Zookeeper(implode(',', array($zookeeper_server))); | ||
|
||
return StoreFactory::createStore($zookeeper); | ||
} | ||
|
||
public function testSaveSucceedsWhenPathContainsMoreThanOneNode() | ||
{ | ||
$store = $this->getStore(); | ||
$resource = '/baseNode/lockNode'; | ||
$key = new Key($resource); | ||
|
||
$store->save($key); | ||
$this->assertTrue($store->exists($key)); | ||
|
||
$store->delete($key); | ||
$this->assertFalse($store->exists($key)); | ||
} | ||
|
||
public function testSaveSucceedsWhenPathContainsOneNode() | ||
{ | ||
$store = $this->getStore(); | ||
$resource = '/baseNode'; | ||
$key = new Key($resource); | ||
|
||
$store->save($key); | ||
$this->assertTrue($store->exists($key)); | ||
|
||
$store->delete($key); | ||
$this->assertFalse($store->exists($key)); | ||
} | ||
|
||
public function testSaveSucceedsWhenPathsContainSameFirstNode() | ||
{ | ||
$store = $this->getStore(); | ||
$resource = 'foo/bar'; | ||
$key = new Key($resource); | ||
|
||
$store->save($key); | ||
$this->assertTrue($store->exists($key)); | ||
|
||
$resource2 = 'foo'; | ||
$key2 = new Key($resource2); | ||
|
||
$this->assertFalse($store->exists($key2)); | ||
$store->save($key2); | ||
$this->assertTrue($store->exists($key2)); | ||
|
||
$store->delete($key2); | ||
$this->assertFalse($store->exists($key2)); | ||
|
||
$store->delete($key); | ||
$this->assertFalse($store->exists($key)); | ||
} | ||
|
||
public function testRootPathIsLockable() | ||
{ | ||
$store = $this->getStore(); | ||
$resource = '/'; | ||
$key = new Key($resource); | ||
|
||
$store->save($key); | ||
$this->assertTrue($store->exists($key)); | ||
|
||
$store->delete($key); | ||
$this->assertFalse($store->exists($key)); | ||
} | ||
|
||
public function testEmptyStringIsLockable() | ||
{ | ||
$store = $this->getStore(); | ||
$resource = ''; | ||
$key = new Key($resource); | ||
|
||
$store->save($key); | ||
$this->assertTrue($store->exists($key)); | ||
|
||
$store->delete($key); | ||
$this->assertFalse($store->exists($key)); | ||
} | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters