Eloquence::getColumnListing()   A
last analyzed

Complexity

Conditions 1
Paths 1

Size

Total Lines 6
Code Lines 3

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 1
eloc 3
nc 1
nop 0
dl 0
loc 6
rs 9.4285
c 0
b 0
f 0
1
<?php
2
3
namespace Sofa\Eloquence;
4
5
use Sofa\Hookable\Hookable;
6
use Sofa\Eloquence\Mutator\Mutator;
7
use Sofa\Hookable\Contracts\ArgumentBag;
8
use Sofa\Eloquence\Query\Builder as QueryBuilder;
9
use Sofa\Eloquence\Contracts\Mutator as MutatorContract;
10
use Sofa\Eloquence\AttributeCleaner\Observer as AttributeCleaner;
11
12
/**
13
 * This trait is an entry point for all the hooks that we want to apply
14
 * on the Eloquent Model and Builder in order to let the magic happen.
15
 *
16
 * It also provides hasColumn and getColumnListing helper methods
17
 * so you can easily list or check columns in the model's table.
18
 *
19
 * @version 5.1
20
 *
21
 * @method \Illuminate\Database\Connection getConnection()
22
 * @method string getTable()
23
 */
24
trait Eloquence
25
{
26
    use Hookable;
27
28
    /**
29
     * Attribute mutator instance.
30
     *
31
     * @var \Sofa\Eloquence\Contracts\Mutator
32
     */
33
    protected static $attributeMutator;
34
35
    /**
36
     * Model's table column listing.
37
     *
38
     * @var array
39
     */
40
    protected static $columnListing = [];
41
42
    /**
43
     * Boot the trait.
44
     *
45
     * @codeCoverageIgnore
46
     *
47
     * @return void
48
     */
49
    public static function bootEloquence()
50
    {
51
        static::observe(new AttributeCleaner);
52
53
        if (!isset(static::$attributeMutator)) {
54
            if (function_exists('app') && app()->bound('eloquence.mutator')) {
55
                static::setAttributeMutator(app('eloquence.mutator'));
56
            } else {
57
                static::setAttributeMutator(new Mutator);
58
            }
59
        }
60
    }
61
62
    /**
63
     * Determine whether where should be treated as whereNull.
64
     *
65
     * @param  string $method
66
     * @param  Sofa\Hookable\Contracts\ArgumentBag $args
67
     * @return boolean
68
     */
69
    protected function isWhereNull($method, ArgumentBag $args)
70
    {
71
        return $method === 'whereNull' || $method === 'where' && $this->isWhereNullByArgs($args);
72
    }
73
74
    /**
75
     * Determine whether where is a whereNull by the arguments passed to where method.
76
     *
77
     * @param  Sofa\Hookable\Contracts\ArgumentBag $args
78
     * @return boolean
79
     */
80
    protected function isWhereNullByArgs(ArgumentBag $args)
81
    {
82
        return is_null($args->get('operator'))
83
            || is_null($args->get('value')) && !in_array($args->get('operator'), ['<>', '!=']);
84
    }
85
86
    /**
87
     * Extract real name and alias from the sql select clause.
88
     *
89
     * @param  string $column
90
     * @return array
91
     */
92
    protected function extractColumnAlias($column)
93
    {
94
        $alias = $column;
95
96
        if (strpos($column, ' as ') !== false) {
97
            list($column, $alias) = explode(' as ', $column);
98
        }
99
100
        return [$column, $alias];
101
    }
102
103
    /**
104
     * Get the target relation and column from the mapping.
105
     *
106
     * @param  string $mapping
107
     * @return array
108
     */
109
    public function parseMappedColumn($mapping)
110
    {
111
        $segments = explode('.', $mapping);
112
113
        $column = array_pop($segments);
114
115
        $target = implode('.', $segments);
116
117
        return [$target, $column];
118
    }
119
120
    /**
121
     * Determine whether the key is meta attribute or actual table field.
122
     *
123
     * @param  string  $key
124
     * @return boolean
125
     */
126
    public static function hasColumn($key)
127
    {
128
        static::loadColumnListing();
129
130
        return in_array((string) $key, static::$columnListing);
131
    }
132
133
    /**
134
     * Get searchable columns defined on the model.
135
     *
136
     * @return array
137
     */
138
    public function getSearchableColumns()
139
    {
140
        return (property_exists($this, 'searchableColumns')) ? $this->searchableColumns : [];
0 ignored issues
show
Bug introduced by
The property searchableColumns 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...
141
    }
142
143
    /**
144
     * Get model table columns.
145
     *
146
     * @return array
147
     */
148
    public static function getColumnListing()
149
    {
150
        static::loadColumnListing();
151
152
        return static::$columnListing;
153
    }
154
155
    /**
156
     * Fetch model table columns.
157
     *
158
     * @return void
159
     */
160
    protected static function loadColumnListing()
161
    {
162
        if (empty(static::$columnListing)) {
163
            $instance = new static;
164
165
            static::$columnListing = $instance->getConnection()
166
                                        ->getSchemaBuilder()
167
                                        ->getColumnListing($instance->getTable());
168
        }
169
    }
170
171
    /**
172
     * Create new Eloquence query builder for the instance.
173
     *
174
     * @param  \Sofa\Eloquence\Query\Builder
175
     * @return \Sofa\Eloquence\Builder
176
     */
177
    public function newEloquentBuilder($query)
178
    {
179
        return new Builder($query);
180
    }
181
182
    /**
183
     * Get a new query builder instance for the connection.
184
     *
185
     * @return \Sofa\Eloquence\Query\Builder
186
     */
187
    protected function newBaseQueryBuilder()
188
    {
189
        $conn = $this->getConnection();
190
191
        $grammar = $conn->getQueryGrammar();
192
193
        return new QueryBuilder($conn, $grammar, $conn->getPostProcessor());
194
    }
195
196
    /**
197
     * Set attribute mutator instance.
198
     *
199
     * @codeCoverageIgnore
200
     *
201
     * @param  \Sofa\Eloquence\Contracts\Mutator $mutator
202
     * @return void
203
     */
204
    public static function setAttributeMutator(MutatorContract $mutator)
205
    {
206
        static::$attributeMutator = $mutator;
207
    }
208
209
    /**
210
     * Get attribute mutator instance.
211
     *
212
     * @codeCoverageIgnore
213
     *
214
     * @return \Sofa\Eloquence\Contracts\Mutator
215
     */
216
    public static function getAttributeMutator()
217
    {
218
        return static::$attributeMutator;
219
    }
220
}
221