Filters - Code Metrics - Inspection of "Merge branch 'master' of https://github.com/Larave..." - Laravel-Backpack/CRUD - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( c624b6...f7db1c )

by Cristian

created 2016-11-11 10:27 UTC

Filters A

↳ Parent: Project

Complexity

Total Complexity

Size/Duplication

Total Lines	141
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	3

Importance

Changes

Metric	Value
dl	0
loc	141
rs	10
c	0
b	0
f	0
wmc	27
lcom	1
cbo	3

7 Methods

Rating	Name	Size	Complexity
A	__construct()	4	1
D	addFilter()	33	9
C	addDefaultFilterLogic()	46	11
A	filters()	4	1
A	removeFilter()	6	1
A	removeAllFilters()	4	1
A	doingListOperation()	18	3

<?php

namespace Backpack\CRUD\PanelTraits;

use Illuminate\Http\Request;

trait Filters
{
    // ------------
    // FILTERS
    // ------------

    public $filters = [];

    public function __construct()
    {
        $this->filters = new FiltersCollection;

    }

    /**
     * Add a filter to the CRUD table view.
     *
     * @param array         $options        Name, type, label, etc.
     * @param array/closure $values         The HTML for the filter.

     * @param closure       $filter_logic   Query modification (filtering) logic.

     */
    public function addFilter($options, $values = false, $filter_logic = false)

    {
        // if a closure was passed as "values"
        if (is_callable($values)) {
            // get its results
            $values = $values();
        }

        // check if another filter with the same name exists
        if (! isset($options['name'])) {
            abort(500, 'All your filters need names.');
        }
        if ($this->filters->contains('name', $options['name'])) {
            abort(500, "Sorry, you can't have two filters with the same name.");
        }

        // add a new filter to the interface
        $filter = new CrudFilter($options, $values, $filter_logic);
        $this->filters->push($filter);

        // if a closure was passed as "filter_logic"
        if ($this->doingListOperation() &&
            $this->request->input($options['name']) &&
            $this->request->input($options['name']) != null &&
            $this->request->input($options['name']) != 'null') {
            if (is_callable($filter_logic)) {
                // apply it
                $filter_logic($this->request->input($options['name']));
class MyClass { }

$x = new MyClass();
$x->foo = true;
            } else {
                $this->addDefaultFilterLogic($filter->name, $filter_logic);
            }
        }
    }

    public function addDefaultFilterLogic($name, $operator)
    {
        $input = \Request::all();

        // if this filter is active (the URL has it as a GET parameter)
        switch ($operator) {
            // if no operator was passed, just use the equals operator
            case false:
                $this->addClause('where', $name, $input[$name]);
trait Idable {
    public function equalIds(Idable $other) {
        return $this->getId() === $other->getId();
    }
}
                break;

            case 'scope':
                $this->addClause($operator);
trait Idable {
    public function equalIds(Idable $other) {
        return $this->getId() === $other->getId();
    }
}
                break;

            // TODO:
            // whereBetween
            // whereNotBetween
            // whereIn
            // whereNotIn
            // whereNull
            // whereNotNull
            // whereDate
            // whereMonth
            // whereDay
            // whereYear
            // whereColumn
            // like

            // sql comparison operators
            case '=':
            case '<=>':
            case '<>':
            case '!=':
            case '>':
            case '>=':
            case '<':
            case '<=':
                $this->addClause('where', $name, $operator, $input[$name]);
trait Idable {
    public function equalIds(Idable $other) {
        return $this->getId() === $other->getId();
    }
}
                break;

            default:
                abort(500, 'Unknown filter operator.');
                break;
        }
    }

    public function filters()

    {
        return $this->filters;
    }

    public function removeFilter($name)
    {
        $this->filters = $this->filters->reject(function ($filter) use ($name) {
            return $filter->name == $name;
        });
    }

    public function removeAllFilters()
    {
        $this->filters = collect([]);

    }

    /**
     * Determine if the current CRUD action is a list operation (using standard or ajax DataTables).
     * @return bool

     */
    public function doingListOperation()
    {
        $route = $this->route;
class MyClass { }

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

        switch ($this->request->url()) {
            case url($this->route):
                return true;
                break;
switch ($x) {
    case 1:
        return 'foo';
        break; // This break is not necessary and can be left off.
}

            case url($this->route.'/search'):
                return true;
                break;
switch ($x) {
    case 1:
        return 'foo';
        break; // This break is not necessary and can be left off.
}

            default:
                return false;
                break;
switch ($x) {
    case 1:
        return 'foo';
        break; // This break is not necessary and can be left off.
}
        }
    }
}

class FiltersCollection extends \Illuminate\Support\Collection

{
    public function removeFilter($name)

    {
    }

    // public function count()

    // {
    //     dd($this);

    // }
}

class CrudFilter

{
    public $name; // the name of the filtered variable (db column name)
    public $type = 'select'; // the name of the filter view that will be loaded
    public $label;
    public $placeholder;
    public $values;
    public $options;
    public $currentValue;
    public $view;

    public function __construct($options, $values, $filter_logic)

    {
        $this->checkOptionsIntegrity($options);

        $this->name = $options['name'];
        $this->type = $options['type'];
        $this->label = $options['label'];

        if (! isset($options['placeholder'])) {
            $this->placeholder = '';
        } else {
            $this->placeholder = $options['placeholder'];
        }

        $this->values = $values;
        $this->options = $options;
        $this->view = 'crud::filters.'.$this->type;

        if (\Request::input($this->name)) {
            $this->currentValue = \Request::input($this->name);
        }
    }

    public function checkOptionsIntegrity($options)
    {
        if (! isset($options['name'])) {
            abort(500, 'Please make sure all your filters have names.');
        }
        if (! isset($options['type'])) {
            abort(500, 'Please make sure all your filters have types.');
        }
        if (! \View::exists('crud::filters.'.$options['type'])) {
            abort(500, 'No filter view named "'.$options['type'].'.blade.php" was found.');
        }
        if (! isset($options['label'])) {
            abort(500, 'Please make sure all your filters have labels.');
        }
    }

    public function isActive()
    {
        if (\Request::input($this->name)) {

            return true;
        }

        return false;
    }
}


1			<?php
2
3			namespace Backpack\CRUD\PanelTraits;
4
5			use Illuminate\Http\Request;
6
7			trait Filters
8			{
9			// ------------
10			// FILTERS
11			// ------------
12
13			public $filters = [];
14
15			public function __construct()
16			{
17			$this->filters = new FiltersCollection;
			0 ignored issues – show Documentation Bug introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report It seems like `new \Backpack\CRUD\PanelTraits\FiltersCollection()` of type `object<Backpack\CRUD\Pan...aits\FiltersCollection>` is incompatible with the declared type `array` of property `$filters`. Our type inference engine has found an assignment to a property that is incompatible with the declared type of that property. Either this assignment is in error or the assigned type should be added to the documentation/type hint for that property.. Loading history...
18			}
19
20			/**
21			* Add a filter to the CRUD table view.
22			*
23			* @param array $options Name, type, label, etc.
24			* @param array/closure $values The HTML for the filter.
			0 ignored issues – show Documentation introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report The doc-type `array/closure` could not be parsed: Unknown type name "array/closure" at position 0. (view supported doc-types) This check marks PHPDoc comments that could not be parsed by our parser. To see which comment annotations we can parse, please refer to our documentation on supported doc-types. Loading history...
25			* @param closure $filter_logic Query modification (filtering) logic.
			0 ignored issues – show Documentation introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report Should the type for parameter `$filter_logic` not be `false\|closure`? This check looks for `@param` annotations where the type inferred by our type inference engine differs from the declared type. It makes a suggestion as to what type it considers more descriptive. Most often this is a case of a parameter that can be null in addition to its declared types. Loading history...
26			*/
27			public function addFilter($options, $values = false, $filter_logic = false)
			0 ignored issues – show Coding Style Naming introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report The parameter $filter_logic is not named in camelCase. This check marks parameter names that have not been written in camelCase. In camelCase names are written without any punctuation, the start of each new word being marked by a capital letter. Thus the name database connection string becomes `databaseConnectionString`. Loading history...
28			{
29			// if a closure was passed as "values"
30			if (is_callable($values)) {
31			// get its results
32			$values = $values();
33			}
34
35			// check if another filter with the same name exists
36			if (! isset($options['name'])) {
37			abort(500, 'All your filters need names.');
38			}
39			if ($this->filters->contains('name', $options['name'])) {
40			abort(500, "Sorry, you can't have two filters with the same name.");
41			}
42
43			// add a new filter to the interface
44			$filter = new CrudFilter($options, $values, $filter_logic);
45			$this->filters->push($filter);
46
47			// if a closure was passed as "filter_logic"
48			if ($this->doingListOperation() &&
49			$this->request->input($options['name']) &&
50			$this->request->input($options['name']) != null &&
51			$this->request->input($options['name']) != 'null') {
52			if (is_callable($filter_logic)) {
53			// apply it
54			$filter_logic($this->request->input($options['name']));
			0 ignored issues – show Bug introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report The property `request` 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...
55			} else {
56			$this->addDefaultFilterLogic($filter->name, $filter_logic);
57			}
58			}
59			}
60
61			public function addDefaultFilterLogic($name, $operator)
62			{
63			$input = \Request::all();
64
65			// if this filter is active (the URL has it as a GET parameter)
66			switch ($operator) {
67			// if no operator was passed, just use the equals operator
68			case false:
69			$this->addClause('where', $name, $input[$name]);
			0 ignored issues – show Bug introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report It seems like `addClause()` must be provided by classes using this trait. How about adding it as abstract method to this trait? This check looks for methods that are used by a trait but not required by it. To illustrate, let’s look at the following code example trait Idable { public function equalIds(Idable $other) { return $this->getId() === $other->getId(); } } The trait `Idable` provides a method `equalsId` that in turn relies on the method `getId()`. If this method does not exist on a class mixing in this trait, the method will fail. Adding the `getId()` as an abstract method to the trait will make sure it is available. Loading history...
70			break;
71
72			case 'scope':
73			$this->addClause($operator);
			0 ignored issues – show Bug introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report It seems like `addClause()` must be provided by classes using this trait. How about adding it as abstract method to this trait? This check looks for methods that are used by a trait but not required by it. To illustrate, let’s look at the following code example trait Idable { public function equalIds(Idable $other) { return $this->getId() === $other->getId(); } } The trait `Idable` provides a method `equalsId` that in turn relies on the method `getId()`. If this method does not exist on a class mixing in this trait, the method will fail. Adding the `getId()` as an abstract method to the trait will make sure it is available. Loading history...
74			break;
75
76			// TODO:
77			// whereBetween
78			// whereNotBetween
79			// whereIn
80			// whereNotIn
81			// whereNull
82			// whereNotNull
83			// whereDate
84			// whereMonth
85			// whereDay
86			// whereYear
87			// whereColumn
88			// like
89
90			// sql comparison operators
91			case '=':
92			case '<=>':
93			case '<>':
94			case '!=':
95			case '>':
96			case '>=':
97			case '<':
98			case '<=':
99			$this->addClause('where', $name, $operator, $input[$name]);
			0 ignored issues – show Bug introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report It seems like `addClause()` must be provided by classes using this trait. How about adding it as abstract method to this trait? This check looks for methods that are used by a trait but not required by it. To illustrate, let’s look at the following code example trait Idable { public function equalIds(Idable $other) { return $this->getId() === $other->getId(); } } The trait `Idable` provides a method `equalsId` that in turn relies on the method `getId()`. If this method does not exist on a class mixing in this trait, the method will fail. Adding the `getId()` as an abstract method to the trait will make sure it is available. Loading history...
100			break;
101
102			default:
103			abort(500, 'Unknown filter operator.');
104			break;
105			}
106			}
107
108			public function filters()
			0 ignored issues – show Documentation introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report The return type could not be reliably inferred; please add a `@return` annotation. Our type inference engine in quite powerful, but sometimes the code does not provide enough clues to go by. In these cases we request you to add a `@return` annotation as described here. Loading history...
109			{
110			return $this->filters;
111			}
112
113			public function removeFilter($name)
114			{
115			$this->filters = $this->filters->reject(function ($filter) use ($name) {
116			return $filter->name == $name;
117			});
118			}
119
120			public function removeAllFilters()
121			{
122			$this->filters = collect([]);
			0 ignored issues – show Documentation Bug introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report It seems like `collect(array())` of type `object<Illuminate\Support\Collection>` is incompatible with the declared type `array` of property `$filters`. Our type inference engine has found an assignment to a property that is incompatible with the declared type of that property. Either this assignment is in error or the assigned type should be added to the documentation/type hint for that property.. Loading history...
123			}
124
125			/**
126			* Determine if the current CRUD action is a list operation (using standard or ajax DataTables).
127			* @return bool
			0 ignored issues – show Documentation introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report Should the return type not be `boolean\|null`? This check compares the return type specified in the `@return` annotation of a function or method doc comment with the types returned by the function and raises an issue if they mismatch. Loading history...
128			*/
129			public function doingListOperation()
130			{
131			$route = $this->route;
			0 ignored issues – show Bug introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report The property `route` 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... Unused Code introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report `$route` is not used, you could remove the assignment. This check looks for variable assignements that are either overwritten by other assignments or where the variable is not used subsequently. $myVar = 'Value'; $higher = false; if (rand(1, 6) > 3) { $higher = true; } else { $higher = false; } Both the `$myVar` assignment in line 1 and the `$higher` assignment in line 2 are dead. The first because `$myVar` is never used and the second because `$higher` is always overwritten for every possible time line. Loading history...
132
133			switch ($this->request->url()) {
134			case url($this->route):
135			return true;
136			break;
			0 ignored issues – show Unused Code introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report `break` is not strictly necessary here and could be removed. The `break` statement is not necessary if it is preceded for example by a `return` statement: switch ($x) { case 1: return 'foo'; break; // This break is not necessary and can be left off. } If you would like to keep this construct to be consistent with other `case` statements, you can safely mark this issue as a false-positive. Loading history...
137
138			case url($this->route.'/search'):
139			return true;
140			break;
			0 ignored issues – show Unused Code introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report `break` is not strictly necessary here and could be removed. The `break` statement is not necessary if it is preceded for example by a `return` statement: switch ($x) { case 1: return 'foo'; break; // This break is not necessary and can be left off. } If you would like to keep this construct to be consistent with other `case` statements, you can safely mark this issue as a false-positive. Loading history...
141
142			default:
143			return false;
144			break;
			0 ignored issues – show Unused Code introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report `break` is not strictly necessary here and could be removed. The `break` statement is not necessary if it is preceded for example by a `return` statement: switch ($x) { case 1: return 'foo'; break; // This break is not necessary and can be left off. } If you would like to keep this construct to be consistent with other `case` statements, you can safely mark this issue as a false-positive. Loading history...
145			}
146			}
147			}
148
149			class FiltersCollection extends \Illuminate\Support\Collection
			0 ignored issues – show Coding Style Compatibility introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report Each trait must be in a file by itself Having each class in a dedicated file usually plays nice with PSR autoloaders and is therefore a well established practice. If you use other autoloaders, you might not want to follow this rule. Loading history...
150			{
151			public function removeFilter($name)
			0 ignored issues – show Unused Code introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report The parameter `$name` 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...
152			{
153			}
154
155			// public function count()
			0 ignored issues – show Unused Code Comprehensibility introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report `50%` of this comment could be valid code. Did you maybe forget this after debugging? Sometimes obsolete code just ends up commented out instead of removed. In this case it is better to remove the code once you have checked you do not need it. The code might also have been commented out for debugging purposes. In this case it is vital that someone uncomments it again or your project may behave in very unexpected ways in production. This check looks for comments that seem to be mostly valid code and reports them. Loading history...
156			// {
157			// dd($this);
			0 ignored issues – show Unused Code Comprehensibility introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report `67%` of this comment could be valid code. Did you maybe forget this after debugging? Sometimes obsolete code just ends up commented out instead of removed. In this case it is better to remove the code once you have checked you do not need it. The code might also have been commented out for debugging purposes. In this case it is vital that someone uncomments it again or your project may behave in very unexpected ways in production. This check looks for comments that seem to be mostly valid code and reports them. Loading history...
158			// }
159			}
160
161			class CrudFilter
			0 ignored issues – show Coding Style Compatibility introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report PSR1 recommends that each class should be in its own file to aid autoloaders. Having each class in a dedicated file usually plays nice with PSR autoloaders and is therefore a well established practice. If you use other autoloaders, you might not want to follow this rule. Loading history...
162			{
163			public $name; // the name of the filtered variable (db column name)
164			public $type = 'select'; // the name of the filter view that will be loaded
165			public $label;
166			public $placeholder;
167			public $values;
168			public $options;
169			public $currentValue;
170			public $view;
171
172			public function __construct($options, $values, $filter_logic)
			0 ignored issues – show Unused Code introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report The parameter `$filter_logic` 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... Coding Style Naming introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report The parameter $filter_logic is not named in camelCase. This check marks parameter names that have not been written in camelCase. In camelCase names are written without any punctuation, the start of each new word being marked by a capital letter. Thus the name database connection string becomes `databaseConnectionString`. Loading history...
173			{
174			$this->checkOptionsIntegrity($options);
175
176			$this->name = $options['name'];
177			$this->type = $options['type'];
178			$this->label = $options['label'];
179
180			if (! isset($options['placeholder'])) {
181			$this->placeholder = '';
182			} else {
183			$this->placeholder = $options['placeholder'];
184			}
185
186			$this->values = $values;
187			$this->options = $options;
188			$this->view = 'crud::filters.'.$this->type;
189
190			if (\Request::input($this->name)) {
191			$this->currentValue = \Request::input($this->name);
192			}
193			}
194
195			public function checkOptionsIntegrity($options)
196			{
197			if (! isset($options['name'])) {
198			abort(500, 'Please make sure all your filters have names.');
199			}
200			if (! isset($options['type'])) {
201			abort(500, 'Please make sure all your filters have types.');
202			}
203			if (! \View::exists('crud::filters.'.$options['type'])) {
204			abort(500, 'No filter view named "'.$options['type'].'.blade.php" was found.');
205			}
206			if (! isset($options['label'])) {
207			abort(500, 'Please make sure all your filters have labels.');
208			}
209			}
210
211			public function isActive()
212			{
213			if (\Request::input($this->name)) {
			0 ignored issues – show Unused Code introduced 2016-11-11 10:29 UTC by Report Bug Copy Issue Report This `if` statement, and the following `return` statement can be replaced with `return (bool) \Request::input($this->name);`. Loading history...
214			return true;
215			}
216
217			return false;
218			}
219			}
220

Laravel-Backpack / CRUD

Scrutinizer GitHub App not installed

Push — master ( c624b6...f7db1c )

Filters A

Complexity

Size/Duplication

Coupling/Cohesion

Importance

7 Methods

Duplication Side-by-Side

Filter issues like