Completed
Push — master ( 00fbac...ee7059 )
by Nicolaas
01:26
created

ImagesWithStyleSelection   B

Complexity

Total Complexity 36

Size/Duplication

Total Lines 308
Duplicated Lines 17.53 %

Coupling/Cohesion

Components 1
Dependencies 12

Importance

Changes 0
Metric Value
wmc 36
lcom 1
cbo 12
dl 54
loc 308
rs 8.8
c 0
b 0
f 0

12 Methods

Rating   Name   Duplication   Size   Complexity  
A i18n_singular_name() 0 4 1
A i18n_plural_name() 0 4 1
C validate() 45 45 11
A onBeforeWrite() 0 5 1
B onAfterWrite() 0 24 5
A requireDefaultRecords() 0 5 1
A getExportFields() 0 5 1
A CMSEditLink() 0 6 1
A CMSAddLink() 0 6 1
C getCMSFields() 9 50 8
A RawImages() 0 13 4
A createFolder() 0 8 1

How to fix   Duplicated Code   

Duplicated Code

Duplicate code is one of the most pungent code smells. A rule that is often used is to re-structure code once it is duplicated in three or more places.

Common duplication problems, and corresponding solutions are:

1
<?php
2
3
4
5
class ImagesWithStyleSelection extends DataObject
0 ignored issues
show
Coding Style Compatibility introduced by
PSR1 recommends that each class must be in a namespace of at least one level to avoid collisions.

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

namespace YourVendor;

class YourClass { }

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

Loading history...
6
{
7
8
9
    #######################
10
    ### Names Section
11
    #######################
12
13
    private static $singular_name = 'Selection of Images';
0 ignored issues
show
Comprehensibility introduced by
Consider using a different property name as you override a private property of the parent class.
Loading history...
Unused Code introduced by
The property $singular_name is not used and could be removed.

This check marks private properties in classes that are never used. Those properties can be removed.

Loading history...
14
15
    public function i18n_singular_name()
16
    {
17
        return _t('ImagesWithStyleSelection.SINGULAR_NAME', 'Selection of Images');
18
    }
19
20
    private static $plural_name = 'Selections of Images';
0 ignored issues
show
Comprehensibility introduced by
Consider using a different property name as you override a private property of the parent class.
Loading history...
Unused Code introduced by
The property $plural_name is not used and could be removed.

This check marks private properties in classes that are never used. Those properties can be removed.

Loading history...
21
22
    public function i18n_plural_name()
23
    {
24
        return _t('ImagesWithStyleSelection.PLURAL_NAME', 'Selections of Images');
25
    }
26
27
28
    #######################
29
    ### Model Section
30
    #######################
31
32
    private static $db = [
0 ignored issues
show
Comprehensibility introduced by
Consider using a different property name as you override a private property of the parent class.
Loading history...
Unused Code introduced by
The property $db is not used and could be removed.

This check marks private properties in classes that are never used. Those properties can be removed.

Loading history...
33
        'Title' => 'Varchar(255)', // this needs to be lengthy to avoid the same names ...
34
        'Description' => 'Text'
35
    ];
36
37
    private static $has_one = [
0 ignored issues
show
Unused Code introduced by
The property $has_one is not used and could be removed.

This check marks private properties in classes that are never used. Those properties can be removed.

Loading history...
Comprehensibility introduced by
Consider using a different property name as you override a private property of the parent class.
Loading history...
38
        'PlaceToStoreImages' => 'Folder'
39
    ];
40
41
    private static $many_many = [
0 ignored issues
show
Unused Code introduced by
The property $many_many is not used and could be removed.

This check marks private properties in classes that are never used. Those properties can be removed.

Loading history...
Comprehensibility introduced by
Consider using a different property name as you override a private property of the parent class.
Loading history...
42
        'StyledImages' => 'ImageWithStyle'
43
    ];
44
45
    private static $many_many_extraFields = [
0 ignored issues
show
Unused Code introduced by
The property $many_many_extraFields is not used and could be removed.

This check marks private properties in classes that are never used. Those properties can be removed.

Loading history...
Comprehensibility introduced by
Consider using a different property name as you override a private property of the parent class.
Loading history...
46
        'StyledImages' => [
47
            'SortOrder' => 'Int',
48
        ]
49
    ];
50
51
52
53
    #######################
54
    ### Further DB Field Details
55
    #######################
56
57
    private static $indexes = [
0 ignored issues
show
Unused Code introduced by
The property $indexes is not used and could be removed.

This check marks private properties in classes that are never used. Those properties can be removed.

Loading history...
Comprehensibility introduced by
Consider using a different property name as you override a private property of the parent class.
Loading history...
58
        'Created' => true,
59
        'Title' => 'unique("Title")'
60
    ];
61
62
    private static $defaults = [
0 ignored issues
show
Unused Code introduced by
The property $defaults is not used and could be removed.

This check marks private properties in classes that are never used. Those properties can be removed.

Loading history...
Comprehensibility introduced by
Consider using a different property name as you override a private property of the parent class.
Loading history...
63
        'Title' => ''
64
    ];
65
66
    private static $default_sort = [
0 ignored issues
show
Unused Code introduced by
The property $default_sort is not used and could be removed.

This check marks private properties in classes that are never used. Those properties can be removed.

Loading history...
Comprehensibility introduced by
Consider using a different property name as you override a private property of the parent class.
Loading history...
67
        'Created' => 'DESC'
68
    ];
69
70
    private static $required_fields = [
0 ignored issues
show
Unused Code introduced by
The property $required_fields is not used and could be removed.

This check marks private properties in classes that are never used. Those properties can be removed.

Loading history...
71
        'Title'
72
    ];
73
74
    private static $searchable_fields = [
0 ignored issues
show
Unused Code introduced by
The property $searchable_fields is not used and could be removed.

This check marks private properties in classes that are never used. Those properties can be removed.

Loading history...
Comprehensibility introduced by
Consider using a different property name as you override a private property of the parent class.
Loading history...
75
        'Title' => 'PartialMatchFilter'
76
    ];
77
78
79
    #######################
80
    ### Field Names and Presentation Section
81
    #######################
82
83
    private static $field_labels = [
0 ignored issues
show
Unused Code introduced by
The property $field_labels is not used and could be removed.

This check marks private properties in classes that are never used. Those properties can be removed.

Loading history...
Comprehensibility introduced by
Consider using a different property name as you override a private property of the parent class.
Loading history...
84
        'StyledImages' => 'Images to be included'
85
    ];
86
87
    private static $field_labels_right = [
0 ignored issues
show
Unused Code introduced by
The property $field_labels_right is not used and could be removed.

This check marks private properties in classes that are never used. Those properties can be removed.

Loading history...
88
        'StyledImages' => 'Select as many as you like and sort them in the right order'
89
    ];
90
91
    private static $summary_fields = [
0 ignored issues
show
Unused Code introduced by
The property $summary_fields is not used and could be removed.

This check marks private properties in classes that are never used. Those properties can be removed.

Loading history...
Comprehensibility introduced by
Consider using a different property name as you override a private property of the parent class.
Loading history...
92
        'Title' => 'Name',
93
        'StyledImages.Count' => 'Number of Images'
94
    ];
95
96
97
    #######################
98
    ### Casting Section
99
    #######################
100
101
102
    #######################
103
    ### can Section
104
    #######################
105
106
107
108
    #######################
109
    ### write Section
110
    #######################
111
112
113
114
115 View Code Duplication
    public function validate()
0 ignored issues
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...
116
    {
117
        $result = parent::validate();
118
        $fieldLabels = $this->FieldLabels();
119
        $indexes = $this->Config()->get('indexes');
120
        $requiredFields = $this->Config()->get('required_fields');
121
        if (is_array($requiredFields)) {
122
            foreach ($requiredFields as $field) {
123
                $value = $this->$field;
124
                if (! $value) {
125
                    $fieldWithoutID = $field;
126
                    if (substr($fieldWithoutID, -2) === 'ID') {
127
                        $fieldWithoutID = substr($fieldWithoutID, 0, -2);
128
                    }
129
                    $myName = isset($fieldLabels[$fieldWithoutID]) ? $fieldLabels[$fieldWithoutID] : $fieldWithoutID;
130
                    $result->error(
131
                        _t(
132
                            'ImagesWithStyleSelection.'.$field.'_REQUIRED',
133
                            $myName.' is required'
134
                        ),
135
                        'REQUIRED_ImagesWithStyleSelection_'.$field
136
                    );
137
                }
138
                if (isset($indexes[$field]) && isset($indexes[$field]['type']) && $indexes[$field]['type'] === 'unique') {
139
                    $id = (empty($this->ID) ? 0 : $this->ID);
140
                    $count = ImagesWithStyleSelection::get()
141
                        ->filter(array($field => $value))
142
                        ->exclude(array('ID' => $id))
143
                        ->count();
144
                    if ($count > 0) {
145
                        $myName = $fieldLabels['$field'];
146
                        $result->error(
147
                            _t(
148
                                'ImagesWithStyleSelection.'.$field.'_UNIQUE',
149
                                $myName.' needs to be unique'
150
                            ),
151
                            'UNIQUE_ImagesWithStyleSelection_'.$field
152
                        );
153
                    }
154
                }
155
            }
156
        }
157
158
        return $result;
159
    }
160
161
    public function onBeforeWrite()
162
    {
163
        parent::onBeforeWrite();
164
        //...
165
    }
166
167
    public function onAfterWrite()
168
    {
169
        parent::onAfterWrite();
170
        if ($this->PlaceToStoreImagesID) {
0 ignored issues
show
Documentation introduced by
The property PlaceToStoreImagesID does not exist on object<ImagesWithStyleSelection>. 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...
171
            $allImages = Image::get()->filter(['ParentID' => $this->PlaceToStoreImagesID])->column('ID');
0 ignored issues
show
Documentation introduced by
The property PlaceToStoreImagesID does not exist on object<ImagesWithStyleSelection>. 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...
172
            $existingImages = $this->RawImages()->column('ID');
173
            $difference = array_diff($allImages, $existingImages);
174
            $list = $this->StyledImages();
0 ignored issues
show
Documentation Bug introduced by
The method StyledImages does not exist on object<ImagesWithStyleSelection>? 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...
175
            if (count($difference)) {
176
                foreach ($difference as $imageID) {
177
                    $image = Image::get()->byID($imageID);
178
                    if ($image) {
179
                        $styledImage = ImageWithStyle::create();
180
                        $styledImage->Title = $image->Name;
0 ignored issues
show
Documentation introduced by
The property Title does not exist on object<ImageWithStyle>. Since you implemented __set, maybe consider adding a @property annotation.

Since your code implements the magic setter _set, this function will be called for any write 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.");
        }
    }

}

Since the property has write access only, you can use the @property-write 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...
181
                        $styledImage->ImageID = $imageID;
0 ignored issues
show
Documentation introduced by
The property ImageID does not exist on object<ImageWithStyle>. Since you implemented __set, maybe consider adding a @property annotation.

Since your code implements the magic setter _set, this function will be called for any write 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.");
        }
    }

}

Since the property has write access only, you can use the @property-write 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...
182
                        $styledImage->StyleID = ImageStyle::get_default_style()->ID;
0 ignored issues
show
Documentation introduced by
The property StyleID does not exist on object<ImageWithStyle>. Since you implemented __set, maybe consider adding a @property annotation.

Since your code implements the magic setter _set, this function will be called for any write 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.");
        }
    }

}

Since the property has write access only, you can use the @property-write 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...
183
                        $styledImage->write();
184
                        $list->add($styledImage);
185
                    }
186
                }
187
            }
188
        }
189
        //...
190
    }
191
192
    public function requireDefaultRecords()
193
    {
194
        parent::requireDefaultRecords();
195
        //...
196
    }
197
198
199
    #######################
200
    ### Import / Export Section
201
    #######################
202
203
    public function getExportFields()
0 ignored issues
show
Documentation introduced by
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...
204
    {
205
        //..
206
        return parent::getExportFields();
0 ignored issues
show
Bug introduced by
It seems like you code against a specific sub-type and not the parent class DataObject as the method getExportFields() does only exist in the following sub-classes of DataObject: ImageStyle, ImageWithStyle, ImagesWithStyleSelection. Maybe you want to instanceof check for one of these explicitly?

Let’s take a look at an example:

abstract class User
{
    /** @return string */
    abstract public function getPassword();
}

class MyUser extends User
{
    public function getPassword()
    {
        // return something
    }

    public function getDisplayName()
    {
        // return some name.
    }
}

class AuthSystem
{
    public function authenticate(User $user)
    {
        $this->logger->info(sprintf('Authenticating %s.', $user->getDisplayName()));
        // do something.
    }
}

In the above example, the authenticate() method works fine as long as you just pass instances of MyUser. However, if you now also want to pass a different sub-classes of User which does not have a getDisplayName() method, the code will break.

Available Fixes

  1. Change the type-hint for the parameter:

    class AuthSystem
    {
        public function authenticate(MyUser $user) { /* ... */ }
    }
    
  2. Add an additional type-check:

    class AuthSystem
    {
        public function authenticate(User $user)
        {
            if ($user instanceof MyUser) {
                $this->logger->info(/** ... */);
            }
    
            // or alternatively
            if ( ! $user instanceof MyUser) {
                throw new \LogicException(
                    '$user must be an instance of MyUser, '
                   .'other instances are not supported.'
                );
            }
    
        }
    }
    
Note: PHP Analyzer uses reverse abstract interpretation to narrow down the types inside the if block in such a case.
  1. Add the method to the parent class:

    abstract class User
    {
        /** @return string */
        abstract public function getPassword();
    
        /** @return string */
        abstract public function getDisplayName();
    }
    
Loading history...
207
    }
208
209
210
211
    #######################
212
    ### CMS Edit Section
213
    #######################
214
215
216
    public function CMSEditLink()
217
    {
218
        $controller = singleton("ImageWithStyleAdmin");
219
220
        return $controller->Link().$this->ClassName."/EditForm/field/".$this->ClassName."/item/".$this->ID."/edit";
221
    }
222
223
    public function CMSAddLink()
224
    {
225
        $controller = singleton("ImageWithStyleAdmin");
226
227
        return $controller->Link().$this->ClassName."/EditForm/field/".$this->ClassName."/item/new";
228
    }
229
230
231
    public function getCMSFields()
232
    {
233
        $fields = parent::getCMSFields();
234
        $fields->removeByName('PlaceToStoreImages');
235
        $fields->addFieldToTab(
236
            'Root.Main',
237
            $treeField = TreeDropdownField::create(
238
                'PlaceToStoreImagesID',
239
                'Image Folder',
240
                'Folder'
241
            )->setRightTitle('Optional - set folder ... all images in this folder will automatically be added.')
242
        );
243
        if ($this->PlaceToStoreImagesID) {
0 ignored issues
show
Documentation introduced by
The property PlaceToStoreImagesID does not exist on object<ImagesWithStyleSelection>. 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...
244
            $folder = $this->PlaceToStoreImages();
0 ignored issues
show
Documentation Bug introduced by
The method PlaceToStoreImages does not exist on object<ImagesWithStyleSelection>? 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...
245
            if ($folder && $folder->exists()) {
246
                $rightFieldTitle = $treeField->RightTitle();
247
                $rightFieldTitle .= '
248
                    <br  /><a href="/admin/assets/show/'.$folder->ID.'/" target="_blank">add images directly to folder</a>
249
                    <br />After you have updated the folder make sure to save this list to receive the latest updates.';
250
                $treeField->setRightTitle($rightFieldTitle);
251
            }
252
        }
253
        //do first??
254
        $rightFieldDescriptions = $this->Config()->get('field_labels_right');
255 View Code Duplication
        foreach ($rightFieldDescriptions as $field => $desc) {
0 ignored issues
show
Duplication introduced by
This code seems to be duplicated across 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...
256
            $formField = $fields->DataFieldByName($field);
257
            if (! $formField) {
258
                $formField = $fields->DataFieldByName($field.'ID');
259
            }
260
            if ($formField) {
261
                $formField->setDescription($desc);
262
            }
263
        }
264
        //...
265
        if ($this->exists()) {
266
            $config = GridFieldConfig_RelationEditor::create();
267
            $config->addComponent(new GridFieldSortableRows('SortOrder'));
268
            $fields->removeByName('StyledImages');
269
            $fields->addFieldToTab(
270
                    'Root.Images',
271
                    GridField::create(
272
                        'StyledImages',
273
                        'Images',
274
                        $this->StyledImages(),
0 ignored issues
show
Documentation Bug introduced by
The method StyledImages does not exist on object<ImagesWithStyleSelection>? 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...
275
                        $config
276
                    )
277
                );
278
        }
279
        return $fields;
280
    }
281
282
    /**
283
     * @return DataList
284
     */
285
    public function RawImages()
286
    {
287
        $array = [];
288
        if ($this->StyledImages()->count()) {
0 ignored issues
show
Documentation Bug introduced by
The method StyledImages does not exist on object<ImagesWithStyleSelection>? 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...
289
            foreach ($this->StyledImages()->column('ImageID') as $id) {
0 ignored issues
show
Documentation Bug introduced by
The method StyledImages does not exist on object<ImagesWithStyleSelection>? 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...
290
                if ($id) {
291
                    $array[$id] = $id;
292
                }
293
            }
294
        }
295
296
        return Image::get()->filter(['ID' => $array]);
297
    }
298
299
    /**
300
     * force the list to use a certain folder ...
301
     * @param  string $folderName
302
     * @return ImagesWithStyleSelection
303
     */
304
    public function createFolder($folderName)
305
    {
306
        $folder = Folder::find_or_make($folderName);
307
        $this->PlaceToStoreImagesID = $folder->ID;
0 ignored issues
show
Documentation introduced by
The property PlaceToStoreImagesID does not exist on object<ImagesWithStyleSelection>. Since you implemented __set, maybe consider adding a @property annotation.

Since your code implements the magic setter _set, this function will be called for any write 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.");
        }
    }

}

Since the property has write access only, you can use the @property-write 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...
308
        $folder->write();
309
310
        return $this;
311
    }
312
}
313