Completed
Pull Request — master (#12)
by
unknown
02:42
created

MongoClient::switchSlave()   A

Complexity

Conditions 1
Paths 1

Size

Total Lines 4
Code Lines 2

Duplication

Lines 0
Ratio 0 %
Metric Value
dl 0
loc 4
rs 10
cc 1
eloc 2
nc 1
nop 0
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
16
use Alcaeus\MongoDbAdapter\Helper;
17
use MongoDB\Client;
18
19
/**
20
 * A connection between PHP and MongoDB. This class is used to create and manage connections
21
 * See MongoClient::__construct() and the section on connecting for more information about creating connections.
22
 * @link http://www.php.net/manual/en/class.mongoclient.php
23
 */
24
class MongoClient
1 ignored issue
show
Coding Style Compatibility introduced by
PSR1 recommends that each class must be in a namespace of at least one level to avoid collisions.

You can fix this by adding a namespace to your class:

namespace YourVendor;

class YourClass { }

When choosing a vendor namespace, try to pick something that is not too generic to avoid conflicts with other libraries.

Loading history...
25
{
26
    use Helper\ReadPreference;
27
    use Helper\WriteConcern;
28
    
29
30
    const VERSION = '1.6.12';
31
    const DEFAULT_HOST = "localhost" ;
32
    const DEFAULT_PORT = 27017 ;
33
    const RP_PRIMARY = "primary" ;
34
    const RP_PRIMARY_PREFERRED = "primaryPreferred" ;
35
    const RP_SECONDARY = "secondary" ;
36
    const RP_SECONDARY_PREFERRED = "secondaryPreferred" ;
37
    const RP_NEAREST = "nearest" ;
38
39
    /**
40
     * @var bool
41
     * @deprecated This will not properly work as the underlying driver connects lazily
42
     */
43
    public $connected = false;
44
45
    /**
46
     * @var
47
     */
48
    public $status;
49
50
    /**
51
     * @var string
52
     */
53
    protected $server;
54
55
    /**
56
     * @var
57
     */
58
    protected $persistent;
59
60
    /**
61
     * @var Client
62
     */
63
    private $client;
64
65
    /**
66
     * @var \MongoDB\Driver\Manager
67
     */
68
    private $manager;
69
70
71
    /**
72
     * Creates a new database connection object
73
     *
74
     * @link http://php.net/manual/en/mongo.construct.php
75
     * @param string $server The server name.
76
     * @param array $options An array of options for the connection.
77
     * @param array $driverOptions An array of options for the MongoDB driver.
78
     * @throws MongoConnectionException
79
     */
80
    public function __construct($server = 'default', array $options = ["connect" => true], array $driverOptions = [])
81
    {
82
        if ($server === 'default') {
83
            $server = 'mongodb://' . self::DEFAULT_HOST . ':' . self::DEFAULT_PORT;
84
        }
85
86
        $this->server = $server;
87
        $this->client = new Client($server, $options, $driverOptions);
88
        // Have to have this or Mongo test crash
89
        $this->readPreference = new \MongoDB\Driver\ReadPreference(\MongoDB\Driver\ReadPreference::RP_PRIMARY);
90
        $info = $this->client->__debugInfo();
91
        $this->manager = $info['manager'];
92
93
        if (isset($options['connect']) && $options['connect']) {
94
            $this->connect();
95
        }
96
    }
97
98
    /**
99
     * Closes this database connection
100
     *
101
     * @link http://www.php.net/manual/en/mongoclient.close.php
102
     * @param  boolean|string $connection
103
     * @return boolean If the connection was successfully closed.
104
     */
105
    public function close($connection = null)
0 ignored issues
show
Unused Code introduced by
The parameter $connection is not used and could be removed.

This check looks from parameters that have been defined for a function or method, but which are not used in the method body.

Loading history...
106
    {
107
        $this->connected = false;
1 ignored issue
show
Deprecated Code introduced by
The property MongoClient::$connected has been deprecated with message: This will not properly work as the underlying driver connects lazily

This property has been deprecated. The supplier of the class has supplied an explanatory message.

The explanatory message should give you some clue as to whether and when the property will be removed from the class and what other property to use instead.

Loading history...
108
109
        return false;
110
    }
111
112
    /**
113
     * Connects to a database server
114
     *
115
     * @link http://www.php.net/manual/en/mongoclient.connect.php
116
     *
117
     * @throws MongoConnectionException
118
     * @return boolean If the connection was successful.
119
     */
120
    public function connect()
121
    {
122
        $this->connected = true;
1 ignored issue
show
Deprecated Code introduced by
The property MongoClient::$connected has been deprecated with message: This will not properly work as the underlying driver connects lazily

This property has been deprecated. The supplier of the class has supplied an explanatory message.

The explanatory message should give you some clue as to whether and when the property will be removed from the class and what other property to use instead.

Loading history...
123
124
        return true;
125
    }
126
127
    /**
128
     * Drops a database
129
     *
130
     * @link http://www.php.net/manual/en/mongoclient.dropdb.php
131
     * @param mixed $db The database to drop. Can be a MongoDB object or the name of the database.
132
     * @return array The database response.
133
     * @deprecated Use MongoDB::drop() instead.
134
     */
135
    public function dropDB($db)
136
    {
137
        return $this->selectDB($db)->drop();
138
    }
139
140
    /**
141
     * Gets a database
142
     *
143
     * @link http://php.net/manual/en/mongoclient.get.php
144
     * @param string $dbname The database name.
145
     * @return MongoDB The database name.
146
     */
147
    public function __get($dbname)
148
    {
149
        return $this->selectDB($dbname);
150
    }
151
152
    /**
153
     * Gets the client for this object
154
     *
155
     * @internal This part is not of the ext-mongo API and should not be used
156
     * @return Client
157
     */
158
    public function getClient()
159
    {
160
        return $this->client;
161
    }
162
163
    /**
164
     * Get connections
165
     *
166
     * Returns an array of all open connections, and information about each of the servers
167
     *
168
     * @return array
169
     */
170
    static public function getConnections()
0 ignored issues
show
Coding Style introduced by
As per PSR2, the static declaration should come after the visibility declaration.
Loading history...
171
    {
172
        return [];
173
    }
174
175
    /**
176
     * Get hosts
177
     *
178
     * This method is only useful with a connection to a replica set. It returns the status of all of the hosts in the
179
     * set. Without a replica set, it will just return an array with one element containing the host that you are
180
     * connected to.
181
     *
182
     * @return array
183
     */
184
    public function getHosts()
185
    {
186
        $this->forceConnect();
187
        $servers = $this->manager->getServers();
188
        $results = [];
189
        foreach ($servers as $server) {
190
            $key = sprintf('%s:%d', $server->getHost(), $server->getPort());
191
            $info = $server->getInfo();
192
            $results[$key] = [
193
                'host'     => $server->getHost(),
194
                'port'     => $server->getPort(),
195
                'health'   => (int)$info['ok'], // Not totally sure about this
196
                'state'    => $server->getType(),
197
                'ping'     => $server->getLatency(),
198
                'lastPing' => null,
199
            ];
200
        }
201
        return $results;
202
    }
203
204
    /**
205
     * Kills a specific cursor on the server
206
     *
207
     * @link http://www.php.net/manual/en/mongoclient.killcursor.php
208
     * @param string $server_hash The server hash that has the cursor. This can be obtained through
209
     * {@link http://www.php.net/manual/en/mongocursor.info.php MongoCursor::info()}.
210
     * @param int|MongoInt64 $id The ID of the cursor to kill. You can either supply an {@link http://www.php.net/manual/en/language.types.integer.php int}
211
     * containing the 64 bit cursor ID, or an object of the
212
     * {@link http://www.php.net/manual/en/class.mongoint64.php MongoInt64} class. The latter is necessary on 32
213
     * bit platforms (and Windows).
214
     */
215
    public function killCursor($server_hash , $id)
0 ignored issues
show
Unused Code introduced by
The parameter $server_hash is not used and could be removed.

This check looks from parameters that have been defined for a function or method, but which are not used in the method body.

Loading history...
Unused Code introduced by
The parameter $id is not used and could be removed.

This check looks from parameters that have been defined for a function or method, but which are not used in the method body.

Loading history...
216
    {
217
        throw new \Exception('Not implemented');
218
    }
219
220
    /**
221
     * Lists all of the databases available
222
     *
223
     * @link http://php.net/manual/en/mongoclient.listdbs.php
224
     * @return array Returns an associative array containing three fields. The first field is databases, which in turn contains an array. Each element of the array is an associative array corresponding to a database, giving the database's name, size, and if it's empty. The other two fields are totalSize (in bytes) and ok, which is 1 if this method ran successfully.
225
     */
226
    public function listDBs()
227
    {
228
        return $this->client->listDatabases();
229
    }
230
231
    /**
232
     * Gets a database collection
233
     *
234
     * @link http://www.php.net/manual/en/mongoclient.selectcollection.php
235
     * @param string $db The database name.
236
     * @param string $collection The collection name.
237
     * @return MongoCollection Returns a new collection object.
238
     * @throws Exception Throws Exception if the database or collection name is invalid.
239
     */
240
    public function selectCollection($db, $collection)
241
    {
242
        return new MongoCollection($this->selectDB($db), $collection);
243
    }
244
245
    /**
246
     * Gets a database
247
     *
248
     * @link http://www.php.net/manual/en/mongo.selectdb.php
249
     * @param string $name The database name.
250
     * @return MongoDB Returns a new db object.
251
     * @throws InvalidArgumentException
252
     */
253
    public function selectDB($name)
254
    {
255
        return new MongoDB($this, $name);
256
    }
257
258
    /**
259
     * {@inheritdoc}
260
     */
261
    public function setReadPreference($readPreference, array $tags = null)
262
    {
263
        return $this->setReadPreferenceFromParameters($readPreference, $tags);
264
    }
265
266
    /**
267
     * {@inheritdoc}
268
     */
269
    public function setWriteConcern($wstring, $wtimeout = 0)
270
    {
271
        return $this->setWriteConcernFromParameters($wstring, $wtimeout);
272
    }
273
274
    /**
275
     * String representation of this connection
276
     *
277
     * @link http://www.php.net/manual/en/mongoclient.tostring.php
278
     * @return string Returns hostname and port for this connection.
279
     */
280
    public function __toString()
281
    {
282
        return $this->server;
283
    }
284
285
    private function forceConnect()
286
    {
287
        $command = new \MongoDB\Driver\Command(['ping' => 1]);
288
        $this->manager->executeCommand('db', $command);
289
    }
290
291
}
292
293