ActiveRecordModel::update() - Code Metrics - MagnusGreiff/Comment - Measure and Improve Code Quality continuously with Scrutinizer

ActiveRecordModel::update() A
last analyzed 2017-10-24 13:45 UTC

↳ Parent: ActiveRecordModel

Complexity

Conditions	3
Paths	4

Size

Total Lines	15
Code Lines	12

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
dl	0
loc	15
rs	9.4285
c	0
b	0
f	0
cc	3
eloc	12
nc	4
nop	2

<?php

namespace Anax\Database;

use \Anax\Database\DatabaseQueryBuilder;
use \Anax\Database\Exception\ActiveRecordException;

/**
 * An implementation of the Active Record pattern to be used as
 * base class for database driven models.
 *
 * @SuppressWarnings(PHPMD.TooManyPublicMethods)
 */
class ActiveRecordModel
{
    /**
     * @var DatabaseQueryBuilder $db the object for persistent
     *                               storage.
     */
    protected $db = null;

    /**
     * @var string $tableName name of the database table.
     */
    protected $tableName = null;



    /**
     * Set the database object to use for accessing storage.
     *
     * @param DatabaseQueryBuilder $db as database access object.
     *
     * @return void
     */
    public function setDb(DatabaseQueryBuilder $db)
    {
        $this->db = $db;
    }



    /**
     * Check if database is injected or throw an exception.
     *
     * @throws ActiveRecordException when database is not set.
     *
     * @return void
     */
    protected function checkDb()
    {
        if (!$this->db) {
            throw new ActiveRecordException("Missing \$db, did you forget to inject/set is?");
        }
    }



    /**
     * Get essential object properties.
     *
     * @return array with object properties.
     */
    protected function getProperties()
    {
        $properties = get_object_vars($this);
        unset($properties['tableName']);
        unset($properties['db']);
        unset($properties['di']);
        return $properties;
    }



    /**
     * Find and return first object found by search criteria and use
     * its data to populate this instance.
     *
     * @param string $column to use in where statement.
     * @param mixed  $value  to use in where statement.
     *
     * @return this
     */
    public function find($column, $value)
    {
        return $this->findWhere("$column = ?", $value);
    }



    /**
     * Find and return first object by its tableIdColumn and use
     * its data to populate this instance.
     *
     * @param integer $id to find or use $this->{$this->tableIdColumn}
     *                    as default.
     *
     * @return this
     */
    public function findById($id = null)
    {
        $id = $id ?: $this->{$this->tableIdColumn};
class MyClass { }

$x = new MyClass();
$x->foo = true;
        return $this->findWhere("{$this->tableIdColumn} = ?", $id);
    }



    /**
     * Find and return first object found by search criteria and use
     * its data to populate this instance.
     *
     * The search criteria `$where` of can be set up like this:
     *  `id = ?`
     *  `id1 = ? and id2 = ?`
     *
     * The `$value` can be a single value or an array of values.
     *
     * @param string $where to use in where statement.
     * @param mixed  $value to use in where statement.
     *
     * @return this
     */
    public function findWhere($where, $value)

    {
        $this->checkDb();
        $params = is_array($value) ? $value : [$value];
        return $this->db->connect()
                        ->select()
                        ->from($this->tableName)
                        ->where($where)
                        ->execute($params)
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
                        ->fetchInto($this);
    }



    /**
     * Find and return all.
     *
     * @return array of object of this class
     */
    public function findAll()
    {
        $this->checkDb();
        return $this->db->connect()
                        ->select()
                        ->from($this->tableName)
                        ->execute()
                        ->fetchAllClass(get_class($this));
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
    }



    public function findAllLimitOrderBy($order, $number)

    {
        $this->checkDb();
        return $this->db->connect()
                        ->select()
                        ->from($this->tableName)
                        ->orderBy($order)
                        ->limit($number)
                        ->execute()
                        ->fetchAllClass(get_class($this));
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
    }

    public function findAllLimit($number)

    {
        $this->checkDb();
        return $this->db->connect()
                        ->select()
                        ->from($this->tableName)
                        ->limit($number)
                        ->execute()
                        ->fetchAllClass(get_class($this));
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
    }




    /**
     * Find and return all matching the search criteria.
     *
     * The search criteria `$where` of can be set up like this:
     *  `id = ?`
     *  `id IN [?, ?]`
     *
     * The `$value` can be a single value or an array of values.
     *
     * @param string $where to use in where statement.
     * @param mixed  $value to use in where statement.
     *
     * @return array of object of this class
     */
    public function findAllWhere($where, $value)

    {
        $this->checkDb();
        $params = is_array($value) ? $value : [$value];
        return $this->db->connect()
                        ->select()
                        ->from($this->tableName)
                        ->where($where)
                        ->execute($params)
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
                        ->fetchAllClass(get_class($this));
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
    }


    /**
     * Execute rawsql
     *
     * @return array
     */
    public function findAllSql($sql, $params = [])
    {
        $this->checkDb();
        return $this->db->connect()
                        ->execute($sql, $params)
                        ->fetchAllClass(get_class($this));
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
    }


    public function next()
    {
        return $this->db->next();

    }


    /**
     * Execute rawsql
     *
     * @return array
     */
    public function findAllSqlTest($sql, $params)
    {
        $this->checkDb();
        return $this->db->connect()
                        ->executeFetchAll($sql, $params);
    }



    /**
     * Save current object/row, insert if id is missing and do an
     * update if the id exists.
     *
     * @return void
     */
    public function save($idName = null, $id = null)
    {
        if (isset($this->id)) {
            return $this->update();
        } elseif ($idName !== null) {
            return $this->update($idName, $id);
        }

        return $this->create();
    }



    /**
     * Create new row.
     *
     * @return void
     */
    protected function create()
    {
        $this->checkDb();
        $properties = $this->getProperties();
        unset($properties['id']);
        $columns = array_keys($properties);
        $values  = array_values($properties);

        $this->db->connect()
                 ->insert($this->tableName, $columns)
                 ->execute($values);
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);

        $this->id = $this->db->lastInsertId();
class MyClass { }

$x = new MyClass();
$x->foo = true;
    }



    /**
     * Update row.
     *
     * @return void
     */
    protected function update($idName = null, $id = null)
    {
        $this->checkDb();
        $properties = $this->getProperties();
        unset($properties['id']);
        $columns = array_keys($properties);
        $values  = array_values($properties);
        $values[] = isset($this->id) ? $this->id : $id ;
        $setId = $idName !== null ? $idName : "id";

        $this->db->connect()
                 ->update($this->tableName, $columns)
                 ->where("$setId = ?")
                 ->execute($values);
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
    }



    /**
     * Delete row.
     *
     * @param integer $id to delete or use $this->id as default.
     *
     * @return void
     */
    public function delete($idName = null, $id = null)
    {
        $this->checkDb();
        $id = $id ?: $this->id;
        $setId = $idName !== null ? $idName : "id";

        $this->db->connect()
                 ->deleteFrom($this->tableName)
                 ->where("$setId = ?")
                 ->execute([$id]);
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);

        $this->id = null;
    }


    public function lastInsertId()
    {
        return $this->db->lastInsertId();
    }
}


1		<?php
2
3		namespace Anax\Database;
4
5		use \Anax\Database\DatabaseQueryBuilder;
6		use \Anax\Database\Exception\ActiveRecordException;
7
8		/**
9		* An implementation of the Active Record pattern to be used as
10		* base class for database driven models.
11		*
12		* @SuppressWarnings(PHPMD.TooManyPublicMethods)
13		*/
14		class ActiveRecordModel
15		{
16		/**
17		* @var DatabaseQueryBuilder $db the object for persistent
18		* storage.
19		*/
20		protected $db = null;
21
22		/**
23		* @var string $tableName name of the database table.
24		*/
25		protected $tableName = null;
26
27
28
29		/**
30		* Set the database object to use for accessing storage.
31		*
32		* @param DatabaseQueryBuilder $db as database access object.
33		*
34		* @return void
35		*/
36		public function setDb(DatabaseQueryBuilder $db)
37		{
38		$this->db = $db;
39		}
40
41
42
43		/**
44		* Check if database is injected or throw an exception.
45		*
46		* @throws ActiveRecordException when database is not set.
47		*
48		* @return void
49		*/
50		protected function checkDb()
51		{
52		if (!$this->db) {
53		throw new ActiveRecordException("Missing \$db, did you forget to inject/set is?");
54		}
55		}
56
57
58
59		/**
60		* Get essential object properties.
61		*
62		* @return array with object properties.
63		*/
64		protected function getProperties()
65		{
66		$properties = get_object_vars($this);
67		unset($properties['tableName']);
68		unset($properties['db']);
69		unset($properties['di']);
70		return $properties;
71		}
72
73
74
75		/**
76		* Find and return first object found by search criteria and use
77		* its data to populate this instance.
78		*
79		* @param string $column to use in where statement.
80		* @param mixed $value to use in where statement.
81		*
82		* @return this
83		*/
84		public function find($column, $value)
85		{
86		return $this->findWhere("$column = ?", $value);
87		}
88
89
90
91		/**
92		* Find and return first object by its tableIdColumn and use
93		* its data to populate this instance.
94		*
95		* @param integer $id to find or use $this->{$this->tableIdColumn}
96		* as default.
97		*
98		* @return this
99		*/
100		public function findById($id = null)
101		{
102		$id = $id ?: $this->{$this->tableIdColumn};
		0 ignored issues – show Bug introduced 2017-10-22 17:16 UTC by Report Bug Copy Issue Report The property `tableIdColumn` does not exist. Did you maybe forget to declare it? In PHP it is possible to write to properties without declaring them. For example, the following is perfectly valid PHP code: class MyClass { } $x = new MyClass(); $x->foo = true; Generally, it is a good practice to explictly declare properties to avoid accidental typos and provide IDE auto-completion: class MyClass { public $foo; } $x = new MyClass(); $x->foo = true; Loading history...
103		return $this->findWhere("{$this->tableIdColumn} = ?", $id);
104		}
105
106
107
108		/**
109		* Find and return first object found by search criteria and use
110		* its data to populate this instance.
111		*
112		* The search criteria `$where` of can be set up like this:
113		* `id = ?`
114		* `id1 = ? and id2 = ?`
115		*
116		* The `$value` can be a single value or an array of values.
117		*
118		* @param string $where to use in where statement.
119		* @param mixed $value to use in where statement.
120		*
121		* @return this
122		*/
123	View Code Duplication	public function findWhere($where, $value)
		0 ignored issues – show Duplication introduced 2017-10-22 17:16 UTC by Report Bug Copy Issue Report This method seems to be duplicated in your project. Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation. You can also find more detailed suggestions in the “Code” section of your repository. Loading history...
124		{
125		$this->checkDb();
126		$params = is_array($value) ? $value : [$value];
127		return $this->db->connect()
128		->select()
129		->from($this->tableName)
130		->where($where)
131		->execute($params)
		0 ignored issues – show Documentation introduced 2017-10-22 17:16 UTC by Report Bug Copy Issue Report `$params` is of type `array`, but the function expects a `string\|null`. It seems like the type of the argument is not accepted by the function/method which you are calling. In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug. We suggest to add an explicit type cast like in the following example: function acceptsInteger($int) { } $x = '123'; // string "123" // Instead of acceptsInteger($x); // we recommend to use acceptsInteger((integer) $x); Loading history...
132		->fetchInto($this);
133		}
134
135
136
137		/**
138		* Find and return all.
139		*
140		* @return array of object of this class
141		*/
142		public function findAll()
143		{
144		$this->checkDb();
145		return $this->db->connect()
146		->select()
147		->from($this->tableName)
148		->execute()
149		->fetchAllClass(get_class($this));
		0 ignored issues – show Documentation introduced 2017-10-12 11:50 UTC by Report Bug Copy Issue Report `get_class($this)` is of type `string`, but the function expects a `object`. It seems like the type of the argument is not accepted by the function/method which you are calling. In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug. We suggest to add an explicit type cast like in the following example: function acceptsInteger($int) { } $x = '123'; // string "123" // Instead of acceptsInteger($x); // we recommend to use acceptsInteger((integer) $x); Loading history...
150		}
151
152
153
154	View Code Duplication	public function findAllLimitOrderBy($order, $number)
		0 ignored issues – show Duplication introduced 2017-10-22 17:16 UTC by Report Bug Copy Issue Report This method seems to be duplicated in your project. Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation. You can also find more detailed suggestions in the “Code” section of your repository. Loading history...
155		{
156		$this->checkDb();
157		return $this->db->connect()
158		->select()
159		->from($this->tableName)
160		->orderBy($order)
161		->limit($number)
162		->execute()
163		->fetchAllClass(get_class($this));
		0 ignored issues – show Documentation introduced 2017-10-12 11:50 UTC by Report Bug Copy Issue Report `get_class($this)` is of type `string`, but the function expects a `object`. It seems like the type of the argument is not accepted by the function/method which you are calling. In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug. We suggest to add an explicit type cast like in the following example: function acceptsInteger($int) { } $x = '123'; // string "123" // Instead of acceptsInteger($x); // we recommend to use acceptsInteger((integer) $x); Loading history...
164		}
165
166	View Code Duplication	public function findAllLimit($number)
		0 ignored issues – show Duplication introduced 2017-10-22 17:16 UTC by Report Bug Copy Issue Report This method seems to be duplicated in your project. Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation. You can also find more detailed suggestions in the “Code” section of your repository. Loading history...
167		{
168		$this->checkDb();
169		return $this->db->connect()
170		->select()
171		->from($this->tableName)
172		->limit($number)
173		->execute()
174		->fetchAllClass(get_class($this));
		0 ignored issues – show Documentation introduced 2017-10-12 11:50 UTC by Report Bug Copy Issue Report `get_class($this)` is of type `string`, but the function expects a `object`. It seems like the type of the argument is not accepted by the function/method which you are calling. In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug. We suggest to add an explicit type cast like in the following example: function acceptsInteger($int) { } $x = '123'; // string "123" // Instead of acceptsInteger($x); // we recommend to use acceptsInteger((integer) $x); Loading history...
175		}
176
177
178
179
180		/**
181		* Find and return all matching the search criteria.
182		*
183		* The search criteria `$where` of can be set up like this:
184		* `id = ?`
185		* `id IN [?, ?]`
186		*
187		* The `$value` can be a single value or an array of values.
188		*
189		* @param string $where to use in where statement.
190		* @param mixed $value to use in where statement.
191		*
192		* @return array of object of this class
193		*/
194	View Code Duplication	public function findAllWhere($where, $value)
		0 ignored issues – show Duplication introduced 2017-10-22 17:16 UTC by Report Bug Copy Issue Report This method seems to be duplicated in your project. Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation. You can also find more detailed suggestions in the “Code” section of your repository. Loading history...
195		{
196		$this->checkDb();
197		$params = is_array($value) ? $value : [$value];
198		return $this->db->connect()
199		->select()
200		->from($this->tableName)
201		->where($where)
202		->execute($params)
		0 ignored issues – show Documentation introduced 2017-10-12 11:50 UTC by Report Bug Copy Issue Report `$params` is of type `array`, but the function expects a `string\|null`. It seems like the type of the argument is not accepted by the function/method which you are calling. In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug. We suggest to add an explicit type cast like in the following example: function acceptsInteger($int) { } $x = '123'; // string "123" // Instead of acceptsInteger($x); // we recommend to use acceptsInteger((integer) $x); Loading history...
203		->fetchAllClass(get_class($this));
		0 ignored issues – show Documentation introduced 2017-10-22 17:16 UTC by Report Bug Copy Issue Report `get_class($this)` is of type `string`, but the function expects a `object`. It seems like the type of the argument is not accepted by the function/method which you are calling. In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug. We suggest to add an explicit type cast like in the following example: function acceptsInteger($int) { } $x = '123'; // string "123" // Instead of acceptsInteger($x); // we recommend to use acceptsInteger((integer) $x); Loading history...
204		}
205
206
207		/**
208		* Execute rawsql
209		*
210		* @return array
211		*/
212		public function findAllSql($sql, $params = [])
213		{
214		$this->checkDb();
215		return $this->db->connect()
216		->execute($sql, $params)
217		->fetchAllClass(get_class($this));
		0 ignored issues – show Documentation introduced 2017-10-22 17:16 UTC by Report Bug Copy Issue Report `get_class($this)` is of type `string`, but the function expects a `object`. It seems like the type of the argument is not accepted by the function/method which you are calling. In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug. We suggest to add an explicit type cast like in the following example: function acceptsInteger($int) { } $x = '123'; // string "123" // Instead of acceptsInteger($x); // we recommend to use acceptsInteger((integer) $x); Loading history...
218		}
219
220
221		public function next()
222		{
223		return $this->db->next();
		0 ignored issues – show Bug introduced 2017-10-22 17:16 UTC by Report Bug Copy Issue Report The method `next()` does not seem to exist on `object<Anax\Database\DatabaseQueryBuilder>`. This check looks for calls to methods that do not seem to exist on a given type. It looks for the method on the type itself as well as in inherited classes or implemented interfaces. This is most likely a typographical error or the method has been renamed. Loading history...
224		}
225
226
227		/**
228		* Execute rawsql
229		*
230		* @return array
231		*/
232		public function findAllSqlTest($sql, $params)
233		{
234		$this->checkDb();
235		return $this->db->connect()
236		->executeFetchAll($sql, $params);
237		}
238
239
240
241		/**
242		* Save current object/row, insert if id is missing and do an
243		* update if the id exists.
244		*
245		* @return void
246		*/
247		public function save($idName = null, $id = null)
248		{
249		if (isset($this->id)) {
250		return $this->update();
251		} elseif ($idName !== null) {
252		return $this->update($idName, $id);
253		}
254
255		return $this->create();
256		}
257
258
259
260		/**
261		* Create new row.
262		*
263		* @return void
264		*/
265		protected function create()
266		{
267		$this->checkDb();
268		$properties = $this->getProperties();
269		unset($properties['id']);
270		$columns = array_keys($properties);
271		$values = array_values($properties);
272
273		$this->db->connect()
274		->insert($this->tableName, $columns)
275		->execute($values);
		0 ignored issues – show Documentation introduced 2017-10-12 11:50 UTC by Report Bug Copy Issue Report `$values` is of type `array<integer,?>`, but the function expects a `string\|null`. It seems like the type of the argument is not accepted by the function/method which you are calling. In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug. We suggest to add an explicit type cast like in the following example: function acceptsInteger($int) { } $x = '123'; // string "123" // Instead of acceptsInteger($x); // we recommend to use acceptsInteger((integer) $x); Loading history...
276
277		$this->id = $this->db->lastInsertId();
		0 ignored issues – show Bug introduced 2017-10-12 11:50 UTC by Report Bug Copy Issue Report The property `id` does not exist. Did you maybe forget to declare it? In PHP it is possible to write to properties without declaring them. For example, the following is perfectly valid PHP code: class MyClass { } $x = new MyClass(); $x->foo = true; Generally, it is a good practice to explictly declare properties to avoid accidental typos and provide IDE auto-completion: class MyClass { public $foo; } $x = new MyClass(); $x->foo = true; Loading history...
278		}
279
280
281
282		/**
283		* Update row.
284		*
285		* @return void
286		*/
287		protected function update($idName = null, $id = null)
288		{
289		$this->checkDb();
290		$properties = $this->getProperties();
291		unset($properties['id']);
292		$columns = array_keys($properties);
293		$values = array_values($properties);
294		$values[] = isset($this->id) ? $this->id : $id ;
295		$setId = $idName !== null ? $idName : "id";
296
297		$this->db->connect()
298		->update($this->tableName, $columns)
299		->where("$setId = ?")
300		->execute($values);
		0 ignored issues – show Documentation introduced 2017-10-12 11:50 UTC by Report Bug Copy Issue Report `$values` is of type `array<integer,?>`, but the function expects a `string\|null`. It seems like the type of the argument is not accepted by the function/method which you are calling. In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug. We suggest to add an explicit type cast like in the following example: function acceptsInteger($int) { } $x = '123'; // string "123" // Instead of acceptsInteger($x); // we recommend to use acceptsInteger((integer) $x); Loading history...
301		}
302
303
304
305		/**
306		* Delete row.
307		*
308		* @param integer $id to delete or use $this->id as default.
309		*
310		* @return void
311		*/
312		public function delete($idName = null, $id = null)
313		{
314		$this->checkDb();
315		$id = $id ?: $this->id;
316		$setId = $idName !== null ? $idName : "id";
317
318		$this->db->connect()
319		->deleteFrom($this->tableName)
320		->where("$setId = ?")
321		->execute([$id]);
		0 ignored issues – show Documentation introduced 2017-10-12 11:50 UTC by Report Bug Copy Issue Report `array($id)` is of type `array<integer,?,{"0":"?"}>`, but the function expects a `string\|null`. It seems like the type of the argument is not accepted by the function/method which you are calling. In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug. We suggest to add an explicit type cast like in the following example: function acceptsInteger($int) { } $x = '123'; // string "123" // Instead of acceptsInteger($x); // we recommend to use acceptsInteger((integer) $x); Loading history...
322
323		$this->id = null;
324		}
325
326
327		public function lastInsertId()
328		{
329		return $this->db->lastInsertId();
330		}
331		}
332

MagnusGreiff / Comment

ActiveRecordModel::update() A last analyzed 2017-10-24 13:45 UTC

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like

ActiveRecordModel::update() A
last analyzed 2017-10-24 13:45 UTC