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 | 277 | public function getReadPreference() |
|
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 | 277 | 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 | 277 | if (is_array($readPreference)) { |
|
89 | 78 | return $this->setReadPreferenceFromArray($readPreference); |
|
90 | } |
||
91 | |||
92 | switch ($readPreference) { |
||
93 | 277 | case \MongoClient::RP_PRIMARY: |
|
94 | 269 | $mode = \MongoDB\Driver\ReadPreference::RP_PRIMARY; |
|
95 | 269 | break; |
|
96 | 29 | case \MongoClient::RP_PRIMARY_PREFERRED: |
|
97 | $mode = \MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED; |
||
98 | break; |
||
99 | 29 | case \MongoClient::RP_SECONDARY: |
|
100 | 23 | $mode = \MongoDB\Driver\ReadPreference::RP_SECONDARY; |
|
101 | 23 | 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 | 277 | if ($readPreference == \MongoClient::RP_PRIMARY && !empty($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 | 277 | $this->readPreference = new \MongoDB\Driver\ReadPreference($mode, $tags); |
|
119 | |||
120 | 277 | return true; |
|
121 | } |
||
122 | |||
123 | /** |
||
124 | * @param array $readPreferenceArray |
||
125 | * @return bool |
||
126 | */ |
||
127 | 276 | protected function setReadPreferenceFromArray($readPreferenceArray) |
|
134 | |||
135 | /** |
||
136 | * @param bool $ok |
||
137 | * @return bool |
||
138 | */ |
||
139 | 4 | protected function setReadPreferenceFromSlaveOkay($ok = true) |
|
151 | } |
||
152 |