Completed
Push — develop ( fce180...423952 )
by Mohamed
07:12
created

SendMessages::getMessageDataForCloseIssue()   A

Complexity

Conditions 2
Paths 2

Size

Total Lines 13
Code Lines 9

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 0
CRAP Score 6

Importance

Changes 1
Bugs 0 Features 0
Metric Value
c 1
b 0
f 0
dl 0
loc 13
ccs 0
cts 3
cp 0
rs 9.4285
cc 2
eloc 9
nc 2
nop 1
crap 6
1
<?php
2
3
/*
4
 * This file is part of the Tinyissue package.
5
 *
6
 * (c) Mohamed Alsharaf <[email protected]>
7
 *
8
 * For the full copyright and license information, please view the LICENSE
9
 * file that was distributed with this source code.
10
 */
11
12
namespace Tinyissue\Model\Project\Issue;
13
14
use Illuminate\Database\Eloquent\Collection;
15
use Tinyissue\Model\Message;
16
use Tinyissue\Model\Message\Queue;
17
use Tinyissue\Model\Project;
18
use Tinyissue\Model\Project\Issue;
19
use Tinyissue\Model\Tag;
20
use Tinyissue\Model\User;
21
use Tinyissue\Services\SendMessagesAbstract;
22
23
/**
24
 * SendMessages is a class to manage & process of sending messages about issue changes.
25
 *
26
 * @author Mohamed Alsharaf <[email protected]>
27
 */
28
class SendMessages extends SendMessagesAbstract
29
{
30
    protected $template = 'update_issue';
31
32
    /**
33
     * Collection of tags
34
     *
35
     * @var Collection
36
     */
37
    protected $tags;
38
39
    /**
40
     * Returns an instance of Issue.
41
     *
42
     * @return bool
43
     */
44
    protected function getIssue()
45
    {
46
        if (null === $this->issue) {
47
            $this->issue = $this->getModel();
0 ignored issues
show
Documentation Bug introduced by
It seems like $this->getModel() can also be of type object<Tinyissue\Model\Project\Issue\Comment> or object<Tinyissue\Http\Requests\FormRequest\Note>. However, the property $issue is declared as type object<Tinyissue\Model\Project\Issue>. Maybe add an additional type check?

Our type inference engine has found a suspicous assignment of a value to a property. This check raises an issue when a value that can be of a mixed type is assigned to a property that is type hinted more strictly.

For example, imagine you have a variable $accountId that can either hold an Id object or false (if there is no account id yet). Your code now assigns that value to the id property of an instance of the Account class. This class holds a proper account, so the id value must no longer be false.

Either this assignment is in error or a type check should be added for that assignment.

class Id
{
    public $id;

    public function __construct($id)
    {
        $this->id = $id;
    }

}

class Account
{
    /** @var  Id $id */
    public $id;
}

$account_id = false;

if (starsAreRight()) {
    $account_id = new Id(42);
}

$account = new Account();
if ($account instanceof Id)
{
    $account->id = $account_id;
}
Loading history...
48
        }
49
50
        return $this->issue;
0 ignored issues
show
Bug Best Practice introduced by
The return type of return $this->issue; (Tinyissue\Model\Project\...quests\FormRequest\Note) is incompatible with the return type declared by the abstract method Tinyissue\Services\SendMessagesAbstract::getIssue of type Tinyissue\Model\Project\Issue.

If you return a value from a function or method, it should be a sub-type of the type that is given by the parent type f.e. an interface, or abstract method. This is more formally defined by the Lizkov substitution principle, and guarantees that classes that depend on the parent type can use any instance of a child type interchangably. This principle also belongs to the SOLID principles for object oriented design.

Let’s take a look at an example:

class Author {
    private $name;

    public function __construct($name) {
        $this->name = $name;
    }

    public function getName() {
        return $this->name;
    }
}

abstract class Post {
    public function getAuthor() {
        return 'Johannes';
    }
}

class BlogPost extends Post {
    public function getAuthor() {
        return new Author('Johannes');
    }
}

class ForumPost extends Post { /* ... */ }

function my_function(Post $post) {
    echo strtoupper($post->getAuthor());
}

Our function my_function expects a Post object, and outputs the author of the post. The base class Post returns a simple string and outputting a simple string will work just fine. However, the child class BlogPost which is a sub-type of Post instead decided to return an object, and is therefore violating the SOLID principles. If a BlogPost were passed to my_function, PHP would not complain, but ultimately fail when executing the strtoupper call in its body.

Loading history...
51
    }
52
53
    /**
54
     * Returns an instance of Project.
55
     *
56
     * @return Project
57
     */
58
    protected function getProject()
59
    {
60
        return $this->getIssue()->project;
61
    }
62
63
    /**
64
     * Returns the project id.
65
     *
66
     * @return int
67
     */
68
    protected function getProjectId()
69
    {
70
        return $this->getIssue()->project_id;
71
    }
72
73
    /**
74
     * Returns message data belongs to adding an issue.
75
     *
76
     * @param Queue $queue
77
     *
78
     * @return array
79
     */
80
    protected function getMessageDataForAddIssue(Queue $queue)
81
    {
82
        $messageData = ['changes' => []];
83
        $messageData['changeByHeading'] = $queue->changeBy->fullname . ' created a new issue';
0 ignored issues
show
Documentation introduced by
The property fullname does not exist on object<Tinyissue\Model\Project\User>. Since you implemented __get, maybe consider adding a @property annotation.

Since your code implements the magic getter _get, this function will be called for any read access on an undefined variable. You can add the @property annotation to your class or interface to document the existence of this variable.

<?php

/**
 * @property int $x
 * @property int $y
 * @property string $text
 */
class MyLabel
{
    private $properties;

    private $allowedProperties = array('x', 'y', 'text');

    public function __get($name)
    {
        if (isset($properties[$name]) && in_array($name, $this->allowedProperties)) {
            return $properties[$name];
        } else {
            return null;
        }
    }

    public function __set($name, $value)
    {
        if (in_array($name, $this->allowedProperties)) {
            $properties[$name] = $value;
        } else {
            throw new \LogicException("Property $name is not defined.");
        }
    }

}

If the property has read access only, you can use the @property-read annotation instead.

Of course, you may also just have mistyped another name, in which case you should fix the error.

See also the PhpDoc documentation for @property.

Loading history...
84
        if ($this->issue->assigned) {
0 ignored issues
show
Bug introduced by
The property assigned does not seem to exist. Did you mean assigned_to?

An attempt at access to an undefined property has been detected. This may either be a typographical error or the property has been renamed but there are still references to its old name.

If you really want to allow access to undefined properties, you can define magic methods to allow access. See the php core documentation on Overloading.

Loading history...
85
            $messageData['changes']['assignee'] = $this->issue->assigned->fullname;
0 ignored issues
show
Bug introduced by
The property assigned does not seem to exist. Did you mean assigned_to?

An attempt at access to an undefined property has been detected. This may either be a typographical error or the property has been renamed but there are still references to its old name.

If you really want to allow access to undefined properties, you can define magic methods to allow access. See the php core documentation on Overloading.

Loading history...
86
        }
87
88
        $tags = $this->issue->tags()->with('parent')->get();
89
        foreach ($tags as $tag) {
90
            $tagArray = $tag->toShortArray();
91
            $tagArray['now'] = $tagArray['name'];
92
            $messageData['changes'][$tag->name] = $tagArray;
93
        }
94
95
        if ($this->issue->time_quote) {
96
            $messageData['changes']['time_quote'] = \Html::duration($this->issue->time_quote);
97
        }
98
99
        return $messageData;
100
    }
101
102
    /**
103
     * Returns message data belongs to updating an issue.
104
     *
105
     * @param Queue $queue
106
     *
107
     * @return array
108
     */
109
    protected function getMessageDataForUpdateIssue(Queue $queue)
110
    {
111
        $messageData = [];
112
        $messageData['changeByHeading'] = $queue->changeBy->fullname . ' updated an issue';
0 ignored issues
show
Documentation introduced by
The property fullname does not exist on object<Tinyissue\Model\Project\User>. Since you implemented __get, maybe consider adding a @property annotation.

Since your code implements the magic getter _get, this function will be called for any read access on an undefined variable. You can add the @property annotation to your class or interface to document the existence of this variable.

<?php

/**
 * @property int $x
 * @property int $y
 * @property string $text
 */
class MyLabel
{
    private $properties;

    private $allowedProperties = array('x', 'y', 'text');

    public function __get($name)
    {
        if (isset($properties[$name]) && in_array($name, $this->allowedProperties)) {
            return $properties[$name];
        } else {
            return null;
        }
    }

    public function __set($name, $value)
    {
        if (in_array($name, $this->allowedProperties)) {
            $properties[$name] = $value;
        } else {
            throw new \LogicException("Property $name is not defined.");
        }
    }

}

If the property has read access only, you can use the @property-read annotation instead.

Of course, you may also just have mistyped another name, in which case you should fix the error.

See also the PhpDoc documentation for @property.

Loading history...
113
114
        foreach ($queue->payload['dirty'] as $field => $value) {
0 ignored issues
show
Bug introduced by
The expression $queue->payload['dirty'] of type string is not traversable.
Loading history...
115
            // Skip fields that not part of the white list
116
            if (!in_array($field,
117
                ['change_by', 'title', 'body', 'assignee', 'status', 'type', 'resolution', 'time_quote'])
118
            ) {
119
                continue;
120
            }
121
            // Format quote to readable time
122
            $value = $field === 'time_quote' ? \Html::duration($value) : $value;
123
            $value = $field === 'body' ? \Html::format($value) : $value;
124
            $messageData['changes'][$field] = [
125
                'now' => $value,
126
                'was' => $queue->getDataFromPayload('origin.' . $field),
127
            ];
128
129
            if (array_key_exists('id', $value)) {
130
                $messageData['changes'][$field]['id'] = $value['id'];
131
            }
132
        }
133
134
        return $messageData;
135
    }
136
137
    /**
138
     * Returns message data belongs to reopening an issue.
139
     *
140
     * @param Queue $queue
141
     *
142
     * @return array
143
     */
144
    protected function getMessageDataForReopenIssue(Queue $queue)
145
    {
146
        $messageData = [];
147
        $messageData['changeByHeading'] = $queue->changeBy->fullname . ' reopened an issue';
0 ignored issues
show
Documentation introduced by
The property fullname does not exist on object<Tinyissue\Model\Project\User>. Since you implemented __get, maybe consider adding a @property annotation.

Since your code implements the magic getter _get, this function will be called for any read access on an undefined variable. You can add the @property annotation to your class or interface to document the existence of this variable.

<?php

/**
 * @property int $x
 * @property int $y
 * @property string $text
 */
class MyLabel
{
    private $properties;

    private $allowedProperties = array('x', 'y', 'text');

    public function __get($name)
    {
        if (isset($properties[$name]) && in_array($name, $this->allowedProperties)) {
            return $properties[$name];
        } else {
            return null;
        }
    }

    public function __set($name, $value)
    {
        if (in_array($name, $this->allowedProperties)) {
            $properties[$name] = $value;
        } else {
            throw new \LogicException("Property $name is not defined.");
        }
    }

}

If the property has read access only, you can use the @property-read annotation instead.

Of course, you may also just have mistyped another name, in which case you should fix the error.

See also the PhpDoc documentation for @property.

Loading history...
148
        $statusNow = $this->issue
149
            ->tags()->with('parent')->get()->where('parent.name', Tag::GROUP_STATUS)->last();
150
        $messageData['changes']['status'] = [
151
            'was' => trans('tinyissue.closed'),
152
            'now' => ($statusNow ? $statusNow->fullname : ''),
153
            'id' => ($statusNow ? $statusNow->id : ''),
154
        ];
155
156
        return $messageData;
157
    }
158
159
    /**
160
     * Returns message data belongs to closing an issue.
161
     *
162
     * @param Queue $queue
163
     *
164
     * @return array
165
     */
166
    protected function getMessageDataForCloseIssue(Queue $queue)
167
    {
168
        $messageData = [];
169
        $messageData['changeByHeading'] = $queue->changeBy->fullname . ' closed an issue';
0 ignored issues
show
Documentation introduced by
The property fullname does not exist on object<Tinyissue\Model\Project\User>. Since you implemented __get, maybe consider adding a @property annotation.

Since your code implements the magic getter _get, this function will be called for any read access on an undefined variable. You can add the @property annotation to your class or interface to document the existence of this variable.

<?php

/**
 * @property int $x
 * @property int $y
 * @property string $text
 */
class MyLabel
{
    private $properties;

    private $allowedProperties = array('x', 'y', 'text');

    public function __get($name)
    {
        if (isset($properties[$name]) && in_array($name, $this->allowedProperties)) {
            return $properties[$name];
        } else {
            return null;
        }
    }

    public function __set($name, $value)
    {
        if (in_array($name, $this->allowedProperties)) {
            $properties[$name] = $value;
        } else {
            throw new \LogicException("Property $name is not defined.");
        }
    }

}

If the property has read access only, you can use the @property-read annotation instead.

Of course, you may also just have mistyped another name, in which case you should fix the error.

See also the PhpDoc documentation for @property.

Loading history...
170
        $statusWas = $this->issue
171
            ->tags()->with('parent')->get()->where('parent.name', Tag::GROUP_STATUS)->last();
172
        $messageData['changes']['status'] = [
173
            'was' => ($statusWas ? $statusWas->fullname : ''),
174
            'now' => trans('tinyissue.closed'),
175
        ];
176
177
        return $messageData;
178
    }
179
180
    /**
181
     * Returns message data belongs to assigning an issue to a user.
182
     *
183
     * @param Queue $queue
184
     * @param array $extraData
185
     *
186
     * @return array
187
     */
188
    protected function getMessageDataForAssignIssue(Queue $queue, array $extraData)
189
    {
190
        $messageData = [];
191
        if (!array_key_exists('now', $extraData)) {
192
            $assignTo = $this->getUserById($queue->getDataFromPayload('dirty.assigned_to'));
193
            $extraData = ['now' => $assignTo->fullname];
194
        }
195
196
        $messageData['changes']['assignee'] = $extraData;
197
        $messageData['changeByHeading'] = $queue->changeBy->fullname . ' assigned an issue to ' . $extraData['now'];
0 ignored issues
show
Documentation introduced by
The property fullname does not exist on object<Tinyissue\Model\Project\User>. Since you implemented __get, maybe consider adding a @property annotation.

Since your code implements the magic getter _get, this function will be called for any read access on an undefined variable. You can add the @property annotation to your class or interface to document the existence of this variable.

<?php

/**
 * @property int $x
 * @property int $y
 * @property string $text
 */
class MyLabel
{
    private $properties;

    private $allowedProperties = array('x', 'y', 'text');

    public function __get($name)
    {
        if (isset($properties[$name]) && in_array($name, $this->allowedProperties)) {
            return $properties[$name];
        } else {
            return null;
        }
    }

    public function __set($name, $value)
    {
        if (in_array($name, $this->allowedProperties)) {
            $properties[$name] = $value;
        } else {
            throw new \LogicException("Property $name is not defined.");
        }
    }

}

If the property has read access only, you can use the @property-read annotation instead.

Of course, you may also just have mistyped another name, in which case you should fix the error.

See also the PhpDoc documentation for @property.

Loading history...
198
199
        return $messageData;
200
    }
201
202
    /**
203
     * Returns message data belongs to changing an issue tags.
204
     *
205
     * @param Queue $queue
206
     *
207
     * @return array
208
     */
209
    protected function getMessageDataForChangeTagIssue(Queue $queue)
210
    {
211
        $messageData = [];
212
        $messageData['changeByHeading'] = $queue->changeBy->fullname . ' changed an issue tag';
0 ignored issues
show
Documentation introduced by
The property fullname does not exist on object<Tinyissue\Model\Project\User>. Since you implemented __get, maybe consider adding a @property annotation.

Since your code implements the magic getter _get, this function will be called for any read access on an undefined variable. You can add the @property annotation to your class or interface to document the existence of this variable.

<?php

/**
 * @property int $x
 * @property int $y
 * @property string $text
 */
class MyLabel
{
    private $properties;

    private $allowedProperties = array('x', 'y', 'text');

    public function __get($name)
    {
        if (isset($properties[$name]) && in_array($name, $this->allowedProperties)) {
            return $properties[$name];
        } else {
            return null;
        }
    }

    public function __set($name, $value)
    {
        if (in_array($name, $this->allowedProperties)) {
            $properties[$name] = $value;
        } else {
            throw new \LogicException("Property $name is not defined.");
        }
    }

}

If the property has read access only, you can use the @property-read annotation instead.

Of course, you may also just have mistyped another name, in which case you should fix the error.

See also the PhpDoc documentation for @property.

Loading history...
213
214
        foreach ($queue->payload['added'] as $tag) {
0 ignored issues
show
Bug introduced by
The expression $queue->payload['added'] of type string is not traversable.
Loading history...
215
            $group = strtolower($tag['group']);
216
            $messageData['changes'][$group] = [
217
                'now'           => $tag['name'],
218
                'id'            => $tag['id'],
219
                'message_limit' => $tag['message_limit'],
220
            ];
221
        }
222
223
        foreach ($queue->payload['removed'] as $tag) {
0 ignored issues
show
Bug introduced by
The expression $queue->payload['removed'] of type string is not traversable.
Loading history...
224
            $group = strtolower($tag['group']);
225
            $messageData['changes'][$group]['was'] = $tag['name'];
226
        }
227
228
        return $messageData;
229
    }
230
231
    /**
232
     * Check that the issue is load.
233
     *
234
     * @return bool
235
     */
236
    protected function validateData()
237
    {
238
        // if issue closed and last issue not closed, then something is wrong skip
239
        if (!$this->issue->isOpen() && $this->latestMessage->event !== Queue::CLOSE_ISSUE) {
240
            return false;
241
        }
242
243
        return $this->issue;
0 ignored issues
show
Bug Best Practice introduced by
The return type of return $this->issue; (Tinyissue\Model\Project\Issue) is incompatible with the return type declared by the abstract method Tinyissue\Services\SendM...sAbstract::validateData of type boolean.

If you return a value from a function or method, it should be a sub-type of the type that is given by the parent type f.e. an interface, or abstract method. This is more formally defined by the Lizkov substitution principle, and guarantees that classes that depend on the parent type can use any instance of a child type interchangably. This principle also belongs to the SOLID principles for object oriented design.

Let’s take a look at an example:

class Author {
    private $name;

    public function __construct($name) {
        $this->name = $name;
    }

    public function getName() {
        return $this->name;
    }
}

abstract class Post {
    public function getAuthor() {
        return 'Johannes';
    }
}

class BlogPost extends Post {
    public function getAuthor() {
        return new Author('Johannes');
    }
}

class ForumPost extends Post { /* ... */ }

function my_function(Post $post) {
    echo strtoupper($post->getAuthor());
}

Our function my_function expects a Post object, and outputs the author of the post. The base class Post returns a simple string and outputting a simple string will work just fine. However, the child class BlogPost which is a sub-type of Post instead decided to return an object, and is therefore violating the SOLID principles. If a BlogPost were passed to my_function, PHP would not complain, but ultimately fail when executing the strtoupper call in its body.

Loading history...
244
    }
245
246
    /**
247
     * Populate assigned relation in the current issue.
248
     *
249
     * @return void
250
     */
251 View Code Duplication
    protected function populateData()
1 ignored issue
show
Duplication introduced by
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...
252
    {
253
        $this->issue->setRelation('assigned', $this->getUserById($this->issue->assigned_to));
254
        $creator = $this->getUserById($this->issue->created_by);
255
        if ($creator) {
256
            $this->issue->setRelation('user', $creator);
257
        }
258
        $this->loadIssueCreatorToProjectUsers();
259
    }
260
261
    /**
262
     * Check if the latest message is about closing or reopening an issue.
263
     *
264
     * @return bool
265
     */
266
    public function isStatusMessage()
267
    {
268
        return ((!$this->issue->isOpen() && $this->latestMessage->event === Queue::CLOSE_ISSUE)
269
            || ($this->issue->isOpen() && $this->latestMessage->event === Queue::REOPEN_ISSUE));
270
    }
271
272
    /**
273
     * Process assign to user message. Send direct message to new and previous users and full subscribers.
274
     *
275
     * @return void
276
     */
277
    protected function processDirectMessages()
278
    {
279
        // Stop if issue is closed
280
        if (!$this->getIssue()->isOpen()) {
0 ignored issues
show
Bug introduced by
The method isOpen does only exist in Tinyissue\Model\Project\Issue, but not in Tinyissue\Http\Requests\...l\Project\Issue\Comment.

It seems like the method you are trying to call exists only in some of the possible types.

Let’s take a look at an example:

class A
{
    public function foo() { }
}

class B extends A
{
    public function bar() { }
}

/**
 * @param A|B $x
 */
function someFunction($x)
{
    $x->foo(); // This call is fine as the method exists in A and B.
    $x->bar(); // This method only exists in B and might cause an error.
}

Available Fixes

  1. Add an additional type-check:

    /**
     * @param A|B $x
     */
    function someFunction($x)
    {
        $x->foo();
    
        if ($x instanceof B) {
            $x->bar();
        }
    }
    
  2. Only allow a single type to be passed if the variable comes from a parameter:

    function someFunction(B $x) { /** ... */ }
    
Loading history...
281
            return;
282
        }
283
284
        // Fetch all of the assign issue changes
285
        $assignMessages = $this->allMessages->where('event', Queue::ASSIGN_ISSUE);
286
287
        // Skip if no changes
288
        if ($assignMessages->isEmpty()) {
289
            return;
290
        }
291
292
        // Fetch the latest assignee
293
        /** @var Queue $assignMessage */
294
        $assignMessage = $assignMessages->first();
295
296
        // Fetch the user details of the new assignee & previous assignee if this isn't new issue
297
        $assigns = [];
298
        $assigns['new'] = (int)$assignMessage->getDataFromPayload('dirty.assigned_to');
299
        if (!$this->addMessage) {
300
            $previousAssignMessage = $assignMessages->last();
301
            $assigns['old'] = (int)$previousAssignMessage->getDataFromPayload('origin.assigned_to');
302
        }
303
304
        // Fetch users objects for old and new assignee
305
        /** @var \Illuminate\Database\Eloquent\Collection $assignObjects */
306
        $assignObjects = (new User())->whereIn('id', $assigns)->get();
0 ignored issues
show
Documentation Bug introduced by
The method whereIn does not exist on object<Tinyissue\Model\User>? Since you implemented __call, maybe consider adding a @method annotation.

If you implement __call and you know which methods are available, you can improve IDE auto-completion and static analysis by adding a @method annotation to the class.

This is often the case, when __call is implemented by a parent class and only the child class knows which methods exist:

class ParentClass {
    private $data = array();

    public function __call($method, array $args) {
        if (0 === strpos($method, 'get')) {
            return $this->data[strtolower(substr($method, 3))];
        }

        throw new \LogicException(sprintf('Unsupported method: %s', $method));
    }
}

/**
 * If this class knows which fields exist, you can specify the methods here:
 *
 * @method string getName()
 */
class SomeClass extends ParentClass { }
Loading history...
307
308
        // If for what ever reason the user does not exists, skip this change
309
        // or if there is only one user and is not matching the new assignee.
310
        // then skip this message
311
        if ($assignObjects->count() === 0
312
            || ($assignObjects->count() === 1 && (int)$assignObjects->first()->id !== $assigns['new'])
313
        ) {
314
            return;
315
        }
316
317
        // Get the object of the new assignee
318
        $assignTo = $assignObjects->where('id', $assigns['new'], false)->first();
319
        $users = collect([$this->createProjectUserObject($assignTo)]);
320
321
        // Exclude the user from any other message for this issue
322
        $this->addToExcludeUsers($assignTo);
323
324
        // Data about new and previous assignee
325
        $extraMessageData = [
326
            'now' => $assignTo->fullname,
327
        ];
328
329
        // Make sure that the previous assignee was not the same as the new user
330
        if (array_key_exists('old', $assigns) && $assigns['old'] > 0 && $assigns['new'] !== $assigns['old']) {
331
            $previousAssign = $assignObjects->where('id', $assigns['old'], false)->first();
332
            if ($previousAssign) {
333
                $extraMessageData['was'] = $previousAssign->fullname;
334
                $users->push($this->createProjectUserObject($previousAssign));
335
            }
336
        }
337
338
        // Get message data needed for the message & send
339
        $messageData = $this->getMessageData($assignMessage, $extraMessageData);
340
        $this->sendMessages($users, $messageData);
341
    }
342
343
    /**
344
     * Create user project object for a user
345
     *
346
     * @param User $user
347
     *
348
     * @return Project\User
349
     */
350
    protected function createProjectUserObject(User $user)
351
    {
352
        $userProject = new Project\User([
353
            'user_id'    => $user->id,
354
            'project_id' => $this->getProjectId(),
355
        ]);
356
        $userProject->setRelation('user', $user);
357
        $userProject->setRelation('project', $this->getProject());
358
359
        return $userProject;
360
    }
361
362
    /**
363
     * Get collection of tags or one by ID.
364
     *
365
     * @param null|int $tagId
366
     *
367
     * @return \Illuminate\Support\Collection|Tag
368
     */
369
    protected function getTags($tagId = null)
370
    {
371
        if (null === $this->tags) {
372
            $this->tags = collect([]);
373
        }
374
375
        // Load & extract tag by ID
376
        if (null !== $tagId) {
377
            $tag = $this->tags->where('id', $tagId, false)->first();
378
            if (!$tag) {
379
                $tag = (new Tag())->find($tagId);
0 ignored issues
show
Documentation Bug introduced by
The method find does not exist on object<Tinyissue\Model\Tag>? Since you implemented __call, maybe consider adding a @method annotation.

If you implement __call and you know which methods are available, you can improve IDE auto-completion and static analysis by adding a @method annotation to the class.

This is often the case, when __call is implemented by a parent class and only the child class knows which methods exist:

class ParentClass {
    private $data = array();

    public function __call($method, array $args) {
        if (0 === strpos($method, 'get')) {
            return $this->data[strtolower(substr($method, 3))];
        }

        throw new \LogicException(sprintf('Unsupported method: %s', $method));
    }
}

/**
 * If this class knows which fields exist, you can specify the methods here:
 *
 * @method string getName()
 */
class SomeClass extends ParentClass { }
Loading history...
380
                $this->tags->push($tag);
381
            }
382
383
            return $tag;
384
        }
385
386
        return $this->tags;
387
    }
388
389
    /**
390
     * Whether or not the user wants to receive the message.
391
     *
392
     * @param Project\User $user
393
     * @param array        $data
394
     *
395
     * @return bool
396
     */
397
    protected function wantToReceiveMessage(Project\User $user, array $data)
398
    {
399
        $status = parent::wantToReceiveMessage($user, $data);
400
401
        if (!$status) {
402
            return false;
403
        }
404
405
        // Search for tag changes and verify if the user can receive messages
406
        foreach ($data['changes'] as $label => $change) {
407
            // Skip other changes that are not related to tag
408
            if (!in_array($label, Tag::getCoreGroups())) {
409
                continue;
410
            }
411
412
            // If the change was only remove a tag
413
            if (!array_key_exists('now', $change) && array_key_exists('was', $change)) {
414
                return true;
415
            }
416
417
            // If tag id not found
418
            if (!array_key_exists('id', $change)) {
419
                return true;
420
            }
421
422
            // Fetch tag details
423
            $tag = $this->getTags($change['id']);
424
425
            // Check if user allowed to receive the message
426
            if (!$tag->allowMessagesToUser($user->user)) {
0 ignored issues
show
Documentation introduced by
The property user does not exist on object<Tinyissue\Model\Project\User>. Since you implemented __get, maybe consider adding a @property annotation.

Since your code implements the magic getter _get, this function will be called for any read access on an undefined variable. You can add the @property annotation to your class or interface to document the existence of this variable.

<?php

/**
 * @property int $x
 * @property int $y
 * @property string $text
 */
class MyLabel
{
    private $properties;

    private $allowedProperties = array('x', 'y', 'text');

    public function __get($name)
    {
        if (isset($properties[$name]) && in_array($name, $this->allowedProperties)) {
            return $properties[$name];
        } else {
            return null;
        }
    }

    public function __set($name, $value)
    {
        if (in_array($name, $this->allowedProperties)) {
            $properties[$name] = $value;
        } else {
            throw new \LogicException("Property $name is not defined.");
        }
    }

}

If the property has read access only, you can use the @property-read annotation instead.

Of course, you may also just have mistyped another name, in which case you should fix the error.

See also the PhpDoc documentation for @property.

Loading history...
Bug introduced by
The method allowMessagesToUser does only exist in Tinyissue\Model\Tag, but not in Illuminate\Support\Collection.

It seems like the method you are trying to call exists only in some of the possible types.

Let’s take a look at an example:

class A
{
    public function foo() { }
}

class B extends A
{
    public function bar() { }
}

/**
 * @param A|B $x
 */
function someFunction($x)
{
    $x->foo(); // This call is fine as the method exists in A and B.
    $x->bar(); // This method only exists in B and might cause an error.
}

Available Fixes

  1. Add an additional type-check:

    /**
     * @param A|B $x
     */
    function someFunction($x)
    {
        $x->foo();
    
        if ($x instanceof B) {
            $x->bar();
        }
    }
    
  2. Only allow a single type to be passed if the variable comes from a parameter:

    function someFunction(B $x) { /** ... */ }
    
Loading history...
427
                return false;
428
            }
429
        }
430
431
        return true;
432
    }
433
}
434