ReadPreference.php 4.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126
  1. <?php
  2. /*
  3. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  4. * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  5. * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  6. * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  7. * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  8. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  9. * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  10. * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  11. * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  12. * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  13. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  14. */
  15. namespace Alcaeus\MongoDbAdapter\Helper;
  16. /**
  17. * @internal
  18. */
  19. trait ReadPreference
  20. {
  21. /**
  22. * @var \MongoDB\Driver\ReadPreference
  23. */
  24. protected $readPreference;
  25. /**
  26. * @param string $readPreference
  27. * @param array $tags
  28. * @return bool
  29. */
  30. abstract public function setReadPreference($readPreference, $tags = null);
  31. /**
  32. * @return array
  33. */
  34. public function getReadPreference()
  35. {
  36. if ($this->readPreference === null) {
  37. $this->readPreference = new \MongoDB\Driver\ReadPreference(\MongoDB\Driver\ReadPreference::RP_PRIMARY);
  38. }
  39. $mode = $this->readPreference->getMode();
  40. switch ($mode) {
  41. case \MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED:
  42. $type = \MongoClient::RP_PRIMARY_PREFERRED;
  43. break;
  44. case \MongoDB\Driver\ReadPreference::RP_SECONDARY:
  45. $type = \MongoClient::RP_SECONDARY;
  46. break;
  47. case \MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED:
  48. $type = \MongoClient::RP_SECONDARY_PREFERRED;
  49. break;
  50. case \MongoDB\Driver\ReadPreference::RP_NEAREST:
  51. $type = \MongoClient::RP_NEAREST;
  52. break;
  53. default:
  54. $type = \MongoClient::RP_PRIMARY;
  55. }
  56. $readPreference = ['type' => $type];
  57. if ($this->readPreference->getTagSets() !== null && $this->readPreference->getTagSets() !== []) {
  58. $readPreference['tagsets'] = $this->readPreference->getTagSets();
  59. }
  60. return $readPreference;
  61. }
  62. /**
  63. * @param string $readPreference
  64. * @param array $tags
  65. * @return bool
  66. */
  67. protected function setReadPreferenceFromParameters($readPreference, $tags = null)
  68. {
  69. // @internal Passing an array for $readPreference is necessary to avoid conversion voodoo
  70. // It should not be used externally!
  71. if (is_array($readPreference)) {
  72. return $this->setReadPreferenceFromArray($readPreference);
  73. }
  74. switch ($readPreference) {
  75. case \MongoClient::RP_PRIMARY:
  76. $mode = \MongoDB\Driver\ReadPreference::RP_PRIMARY;
  77. break;
  78. case \MongoClient::RP_PRIMARY_PREFERRED:
  79. $mode = \MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED;
  80. break;
  81. case \MongoClient::RP_SECONDARY:
  82. $mode = \MongoDB\Driver\ReadPreference::RP_SECONDARY;
  83. break;
  84. case \MongoClient::RP_SECONDARY_PREFERRED:
  85. $mode = \MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED;
  86. break;
  87. case \MongoClient::RP_NEAREST:
  88. $mode = \MongoDB\Driver\ReadPreference::RP_NEAREST;
  89. break;
  90. default:
  91. trigger_error("The value '$readPreference' is not valid as read preference type", E_WARNING);
  92. return false;
  93. }
  94. if ($readPreference == \MongoClient::RP_PRIMARY && count($tags)) {
  95. trigger_error("You can't use read preference tags with a read preference of PRIMARY", E_WARNING);
  96. return false;
  97. }
  98. $this->readPreference = new \MongoDB\Driver\ReadPreference($mode, $tags);
  99. return true;
  100. }
  101. /**
  102. * @param array $readPreferenceArray
  103. * @return bool
  104. */
  105. protected function setReadPreferenceFromArray($readPreferenceArray)
  106. {
  107. $readPreference = $readPreferenceArray['type'];
  108. $tags = isset($readPreferenceArray['tagsets']) ? $readPreferenceArray['tagsets'] : [];
  109. return $this->setReadPreferenceFromParameters($readPreference, $tags);
  110. }
  111. }