1 | <?php |
||
21 | trait ReadPreference |
||
22 | { |
||
23 | /** |
||
24 | * @var \MongoDB\Driver\ReadPreference |
||
25 | */ |
||
26 | protected $readPreference; |
||
27 | |||
28 | /** |
||
29 | * @param string $readPreference |
||
30 | * @param array $tags |
||
31 | * @return bool |
||
32 | */ |
||
33 | abstract public function setReadPreference($readPreference, $tags = null); |
||
34 | |||
35 | /** |
||
36 | * @return array |
||
37 | */ |
||
38 | 252 | public function getReadPreference() |
|
39 | { |
||
40 | 252 | if ($this->readPreference === null) { |
|
41 | 245 | $this->readPreference = new \MongoDB\Driver\ReadPreference(\MongoDB\Driver\ReadPreference::RP_PRIMARY); |
|
42 | } |
||
43 | |||
44 | 252 | $mode = $this->readPreference->getMode(); |
|
45 | |||
46 | switch ($mode) { |
||
47 | 252 | case \MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED: |
|
48 | $type = \MongoClient::RP_PRIMARY_PREFERRED; |
||
49 | break; |
||
50 | 252 | case \MongoDB\Driver\ReadPreference::RP_SECONDARY: |
|
51 | 6 | $type = \MongoClient::RP_SECONDARY; |
|
52 | 6 | break; |
|
53 | 251 | case \MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED: |
|
54 | 8 | $type = \MongoClient::RP_SECONDARY_PREFERRED; |
|
55 | 8 | break; |
|
56 | 245 | case \MongoDB\Driver\ReadPreference::RP_NEAREST: |
|
57 | $type = \MongoClient::RP_NEAREST; |
||
58 | break; |
||
59 | default: |
||
60 | 245 | $type = \MongoClient::RP_PRIMARY; |
|
61 | } |
||
62 | |||
63 | 252 | $readPreference = ['type' => $type]; |
|
64 | 252 | if ($this->readPreference->getTagSets() !== null && $this->readPreference->getTagSets() !== []) { |
|
65 | 12 | $readPreference['tagsets'] = $this->readPreference->getTagSets(); |
|
66 | } |
||
67 | |||
68 | 252 | return $readPreference; |
|
69 | } |
||
70 | |||
71 | /** |
||
72 | * @return bool |
||
73 | */ |
||
74 | 4 | protected function getSlaveOkayFromReadPreference() |
|
78 | |||
79 | /** |
||
80 | * @param string $readPreference |
||
81 | * @param array $tags |
||
82 | * @return bool |
||
83 | */ |
||
84 | 252 | protected function setReadPreferenceFromParameters($readPreference, $tags = null) |
|
85 | { |
||
86 | // @internal Passing an array for $readPreference is necessary to avoid conversion voodoo |
||
87 | // It should not be used externally! |
||
88 | 252 | if (is_array($readPreference)) { |
|
89 | 74 | return $this->setReadPreferenceFromArray($readPreference); |
|
90 | } |
||
91 | |||
92 | switch ($readPreference) { |
||
93 | 252 | case \MongoClient::RP_PRIMARY: |
|
94 | 244 | $mode = \MongoDB\Driver\ReadPreference::RP_PRIMARY; |
|
95 | 244 | break; |
|
96 | 15 | case \MongoClient::RP_PRIMARY_PREFERRED: |
|
97 | $mode = \MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED; |
||
98 | break; |
||
99 | 15 | case \MongoClient::RP_SECONDARY: |
|
100 | 9 | $mode = \MongoDB\Driver\ReadPreference::RP_SECONDARY; |
|
101 | 9 | break; |
|
102 | 6 | case \MongoClient::RP_SECONDARY_PREFERRED: |
|
103 | 6 | $mode = \MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED; |
|
104 | 6 | break; |
|
105 | case \MongoClient::RP_NEAREST: |
||
106 | $mode = \MongoDB\Driver\ReadPreference::RP_NEAREST; |
||
107 | break; |
||
108 | default: |
||
109 | trigger_error("The value '$readPreference' is not valid as read preference type", E_USER_WARNING); |
||
110 | return false; |
||
111 | } |
||
112 | |||
113 | 252 | if ($readPreference == \MongoClient::RP_PRIMARY && count($tags)) { |
|
114 | trigger_error("You can't use read preference tags with a read preference of PRIMARY", E_USER_WARNING); |
||
115 | return false; |
||
116 | } |
||
117 | |||
118 | 252 | $this->readPreference = new \MongoDB\Driver\ReadPreference($mode, $tags); |
|
119 | |||
120 | 252 | return true; |
|
121 | } |
||
122 | |||
123 | /** |
||
124 | * @param array $readPreferenceArray |
||
125 | * @return bool |
||
126 | */ |
||
127 | 251 | protected function setReadPreferenceFromArray($readPreferenceArray) |
|
134 | |||
135 | /** |
||
136 | * @param bool $ok |
||
137 | * @return bool |
||
138 | */ |
||
139 | 4 | protected function setReadPreferenceFromSlaveOkay($ok = true) |
|
151 | } |
||
152 |