MongoDbSessionHandler.php 5.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187
  1. <?php
  2. /*
  3. * This file is part of the Symfony package.
  4. *
  5. * (c) Fabien Potencier <fabien@symfony.com>
  6. *
  7. * For the full copyright and license information, please view the LICENSE
  8. * file that was distributed with this source code.
  9. */
  10. namespace Symfony\Component\HttpFoundation\Session\Storage\Handler;
  11. /**
  12. * Session handler using the mongodb/mongodb package and MongoDB driver extension.
  13. *
  14. * @author Markus Bachmann <markus.bachmann@bachi.biz>
  15. *
  16. * @see https://packagist.org/packages/mongodb/mongodb
  17. * @see https://php.net/mongodb
  18. */
  19. class MongoDbSessionHandler extends AbstractSessionHandler
  20. {
  21. private $mongo;
  22. /**
  23. * @var \MongoDB\Collection
  24. */
  25. private $collection;
  26. /**
  27. * @var array
  28. */
  29. private $options;
  30. /**
  31. * Constructor.
  32. *
  33. * List of available options:
  34. * * database: The name of the database [required]
  35. * * collection: The name of the collection [required]
  36. * * id_field: The field name for storing the session id [default: _id]
  37. * * data_field: The field name for storing the session data [default: data]
  38. * * time_field: The field name for storing the timestamp [default: time]
  39. * * expiry_field: The field name for storing the expiry-timestamp [default: expires_at].
  40. *
  41. * It is strongly recommended to put an index on the `expiry_field` for
  42. * garbage-collection. Alternatively it's possible to automatically expire
  43. * the sessions in the database as described below:
  44. *
  45. * A TTL collections can be used on MongoDB 2.2+ to cleanup expired sessions
  46. * automatically. Such an index can for example look like this:
  47. *
  48. * db.<session-collection>.ensureIndex(
  49. * { "<expiry-field>": 1 },
  50. * { "expireAfterSeconds": 0 }
  51. * )
  52. *
  53. * More details on: https://docs.mongodb.org/manual/tutorial/expire-data/
  54. *
  55. * If you use such an index, you can drop `gc_probability` to 0 since
  56. * no garbage-collection is required.
  57. *
  58. * @throws \InvalidArgumentException When "database" or "collection" not provided
  59. */
  60. public function __construct(\MongoDB\Client $mongo, array $options)
  61. {
  62. if (!isset($options['database']) || !isset($options['collection'])) {
  63. throw new \InvalidArgumentException('You must provide the "database" and "collection" option for MongoDBSessionHandler.');
  64. }
  65. $this->mongo = $mongo;
  66. $this->options = array_merge([
  67. 'id_field' => '_id',
  68. 'data_field' => 'data',
  69. 'time_field' => 'time',
  70. 'expiry_field' => 'expires_at',
  71. ], $options);
  72. }
  73. /**
  74. * @return bool
  75. */
  76. public function close()
  77. {
  78. return true;
  79. }
  80. /**
  81. * {@inheritdoc}
  82. */
  83. protected function doDestroy($sessionId)
  84. {
  85. $this->getCollection()->deleteOne([
  86. $this->options['id_field'] => $sessionId,
  87. ]);
  88. return true;
  89. }
  90. /**
  91. * @return bool
  92. */
  93. public function gc($maxlifetime)
  94. {
  95. $this->getCollection()->deleteMany([
  96. $this->options['expiry_field'] => ['$lt' => new \MongoDB\BSON\UTCDateTime()],
  97. ]);
  98. return true;
  99. }
  100. /**
  101. * {@inheritdoc}
  102. */
  103. protected function doWrite($sessionId, $data)
  104. {
  105. $expiry = new \MongoDB\BSON\UTCDateTime((time() + (int) ini_get('session.gc_maxlifetime')) * 1000);
  106. $fields = [
  107. $this->options['time_field'] => new \MongoDB\BSON\UTCDateTime(),
  108. $this->options['expiry_field'] => $expiry,
  109. $this->options['data_field'] => new \MongoDB\BSON\Binary($data, \MongoDB\BSON\Binary::TYPE_OLD_BINARY),
  110. ];
  111. $this->getCollection()->updateOne(
  112. [$this->options['id_field'] => $sessionId],
  113. ['$set' => $fields],
  114. ['upsert' => true]
  115. );
  116. return true;
  117. }
  118. /**
  119. * @return bool
  120. */
  121. public function updateTimestamp($sessionId, $data)
  122. {
  123. $expiry = new \MongoDB\BSON\UTCDateTime((time() + (int) ini_get('session.gc_maxlifetime')) * 1000);
  124. $this->getCollection()->updateOne(
  125. [$this->options['id_field'] => $sessionId],
  126. ['$set' => [
  127. $this->options['time_field'] => new \MongoDB\BSON\UTCDateTime(),
  128. $this->options['expiry_field'] => $expiry,
  129. ]]
  130. );
  131. return true;
  132. }
  133. /**
  134. * {@inheritdoc}
  135. */
  136. protected function doRead($sessionId)
  137. {
  138. $dbData = $this->getCollection()->findOne([
  139. $this->options['id_field'] => $sessionId,
  140. $this->options['expiry_field'] => ['$gte' => new \MongoDB\BSON\UTCDateTime()],
  141. ]);
  142. if (null === $dbData) {
  143. return '';
  144. }
  145. return $dbData[$this->options['data_field']]->getData();
  146. }
  147. private function getCollection(): \MongoDB\Collection
  148. {
  149. if (null === $this->collection) {
  150. $this->collection = $this->mongo->selectCollection($this->options['database'], $this->options['collection']);
  151. }
  152. return $this->collection;
  153. }
  154. /**
  155. * @return \MongoDB\Client
  156. */
  157. protected function getMongo()
  158. {
  159. return $this->mongo;
  160. }
  161. }