/**
* Set whether secondary read queries are allowed for this cursor.
*
* This method wraps setSlaveOkay() for driver versions before 1.3.0. For
* newer drivers, this method either wraps setReadPreference() method and
* specifies SECONDARY_PREFERRED or does nothing, depending on whether
* setReadPreference() exists.
*
* @param boolean $ok
*/
public function setMongoCursorSlaveOkay($ok)
{
if ($ok) {
// Preserve existing tags for non-primary read preferences
$readPref = $this->mongoCursor->getReadPreference();
$this->mongoCursor->setReadPreference(\MongoClient::RP_SECONDARY_PREFERRED, isset($readPref['tagsets']) ? $readPref['tagsets'] : []);
} else {
$this->mongoCursor->setReadPreference(\MongoClient::RP_PRIMARY);
}
}
/**
* Set whether secondary read queries are allowed for this cursor.
*
* This method wraps setSlaveOkay() for driver versions before 1.3.0. For
* newer drivers, this method either wraps setReadPreference() method and
* specifies SECONDARY_PREFERRED or does nothing, depending on whether
* setReadPreference() exists.
*
* @param boolean $ok
*/
public function setMongoCursorSlaveOkay($ok)
{
if (version_compare(phpversion('mongo'), '1.3.0', '<')) {
$this->mongoCursor->slaveOkay($ok);
return;
}
/* MongoCursor::setReadPreference() may not exist until 1.4.0. Although
* we could throw an exception here, it's more user-friendly to NOP.
*/
if (!method_exists($this->mongoCursor, 'setReadPreference')) {
return;
}
if ($ok) {
// Preserve existing tags for non-primary read preferences
$readPref = $this->mongoCursor->getReadPreference();
$tags = !empty($readPref['tagsets']) ? ReadPreference::convertTagSets($readPref['tagsets']) : array();
$this->mongoCursor->setReadPreference(\MongoClient::RP_SECONDARY_PREFERRED, $tags);
} else {
$this->mongoCursor->setReadPreference(\MongoClient::RP_PRIMARY);
}
}
/**
*
* @return \MongoCursor
*/
private function getCursor()
{
if ($this->cursor) {
return $this->cursor;
}
$this->cursor = $this->collection->getMongoCollection()->find($this->expression->toArray(), $this->fields);
if ($this->skip) {
$this->cursor->skip($this->skip);
}
if ($this->limit) {
$this->cursor->limit($this->limit);
}
if ($this->options['batchSize']) {
$this->cursor->batchSize($this->options['batchSize']);
}
if ($this->options['clientTimeout']) {
$this->cursor->timeout($this->options['clientTimeout']);
}
if ($this->options['serverTimeout']) {
$this->cursor->maxTimeMS($this->options['clientTimeout']);
}
if ($this->sort) {
$this->cursor->sort($this->sort);
}
if ($this->hint) {
$this->cursor->hint($this->hint);
}
// log request
if ($this->client->hasLogger()) {
$this->client->getLogger()->debug(get_called_class() . ': ' . json_encode(array('collection' => $this->collection->getName(), 'query' => $this->expression->toArray(), 'project' => $this->fields, 'sort' => $this->sort)));
}
$this->cursor->rewind();
// define read preferences
if ($this->readPreference) {
$this->cursor->setReadPreference($this->readPreference['type'], $this->readPreference['tagsets']);
}
return $this->cursor;
}
/**
* Querys this collection
*
* @link http://www.php.net/manual/en/mongocollection.find.php
* @param array $query The fields for which to search.
* @param array $fields Fields of the results to return.
* @return MongoCursor
*/
public function find(array $query = [], array $fields = [])
{
$cursor = new MongoCursor($this->db->getConnection(), (string) $this, $query, $fields);
$cursor->setReadPreference($this->getReadPreference());
return $cursor;
}
