GitHub Access Token became invalid

It seems like the GitHub access token used for retrieving details about this repository from GitHub became invalid. This might prevent certain types of inspections from being run (in particular, everything related to pull requests).
Please ask an admin of your repository to re-new the access token on this website.

GridFS::deleteFileById()   A
last analyzed

Complexity

Conditions 4
Paths 6

Size

Total Lines 17
Code Lines 11

Duplication

Lines 3
Ratio 17.65 %

Importance

Changes 0
Metric Value
c 0
b 0
f 0
dl 3
loc 17
rs 9.2
cc 4
eloc 11
nc 6
nop 1
1
<?php
2
3
/**
4
 * This file is part of the PHPMongo package.
5
 *
6
 * (c) Dmytro Sokil <[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 Sokil\Mongo;
13
14
/**
15
 * Representation of GridFS as collection of files
16
 *
17
 * @property \MongoGridFS $collection MongoGridFS Instance
18
 */
19
class GridFS extends Collection
20
{
21
    protected $mongoCollectionClassName = '\MongoGridFS';
22
    
23
    /**
24
     * Factory method to get document object from array of stored document
25
     * @param \MongoGridFSFile $data
26
     * @return \Sokil\Mongo\GridFsFile
27
     */
28
    public function hydrate($data, $useDocumentPool = true)
29
    {
30
        if (($data instanceof \MongoGridFSFile) === false) {
31
            throw new Exception('Must be \MongoGridFSFile');
32
        }
33
        
34
        $className = $this->getFileClassName($data);
35
        
36
        return new $className($this, $data);
37
    }
38
    
39
    /**
40
     * Override to define class name of file by file data
41
     *
42
     * @param \MongoGridFSFile $fileData
43
     * @return string Document class data
44
     */
45
    public function getFileClassName(\MongoGridFSFile $fileData = null)
0 ignored issues
show
Unused Code introduced by
The parameter $fileData 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...
46
    {
47
        return '\Sokil\Mongo\GridFSFile';
48
    }
49
    
50
    /**
51
     * Create file in GridFS from file in filesystem
52
     *
53
     * @param string $filename name of source file
54
     * @param array $metadata metadata stored with file
55
     * @return \MongoId Id of stored file
56
     */
57
    public function storeFile($filename, $metadata = array())
58
    {
59
        return $this->getMongoCollection()->storeFile($filename, $metadata);
0 ignored issues
show
Bug introduced by
It seems like you code against a specific sub-type and not the parent class MongoCollection as the method storeFile() does only exist in the following sub-classes of MongoCollection: MongoGridFS. 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...
60
    }
61
    
62
    /**
63
     * Create file in GridFS from binary data
64
     *
65
     * @param string $bytes binary data to store in GridFS
66
     * @param array $metadata metadata stored with file
67
     * @return \MongoId Id of stored file
68
     */
69
    public function storeBytes($bytes, $metadata = array())
70
    {
71
        return $this->getMongoCollection()->storeBytes($bytes, $metadata);
0 ignored issues
show
Bug introduced by
It seems like you code against a specific sub-type and not the parent class MongoCollection as the method storeBytes() does only exist in the following sub-classes of MongoCollection: MongoGridFS. 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...
72
    }
73
74
    /**
75
     * Get file instance by id of document
76
     * Used \MongoGridFS::findOne() instead of \MongoGridFS::get() due
77
     * to backward compatibility with old mongo extensions
78
     *
79
     * @param \MongoId|string|int $id
80
     * @return \Sokil\Mongo\GridFSFile|null
81
     */
82
    public function getFileById($id)
83
    {
84
        if ($id instanceof \MongoId) {
85
            $file = $this->getMongoCollection()->findOne(array('_id' => $id));
86
        } else {
87
            try {
88
                $file = $this->getMongoCollection()->findOne(array('_id' => new \MongoId($id)));
89
            } catch (\MongoException $e) {
90
                $file = $this->getMongoCollection()->findOne(array('_id' => $id));
91
            }
92
        }
93
        
94
        if (!$file) {
0 ignored issues
show
Bug Best Practice introduced by
The expression $file of type array is implicitly converted to a boolean; are you sure this is intended? If so, consider using empty($expr) instead to make it clear that you intend to check for an array without elements.

This check marks implicit conversions of arrays to boolean values in a comparison. While in PHP an empty array is considered to be equal (but not identical) to false, this is not always apparent.

Consider making the comparison explicit by using empty(..) or ! empty(...) instead.

Loading history...
95
            return null;
96
        }
97
        
98
        $fileClassName = $this->getFileClassName($file);
0 ignored issues
show
Documentation introduced by
$file is of type array, but the function expects a null|object<MongoGridFSFile>.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

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

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
99
        return new $fileClassName($this, $file);
100
    }
101
    
102
    /**
103
     * Delete file by id
104
     *
105
     * @param string|\MongoId $id id of file's document
106
     * @return \Sokil\Mongo\GridFS
107
     * @throws Exception
108
     */
109
    public function deleteFileById($id)
110
    {
111
        if ($id instanceof \MongoId) {
112
            $result = $this->getMongoCollection()->delete($id);
0 ignored issues
show
Bug introduced by
The method delete() does not exist on MongoCollection. Did you maybe mean deleteIndex()?

This check marks calls to methods that do not seem to exist on an object.

This is most likely the result of a method being renamed without all references to it being renamed likewise.

Loading history...
113
        } else {
114
            try {
115
                $result = $this->getMongoCollection()->delete(new \MongoId($id));
0 ignored issues
show
Bug introduced by
The method delete() does not exist on MongoCollection. Did you maybe mean deleteIndex()?

This check marks calls to methods that do not seem to exist on an object.

This is most likely the result of a method being renamed without all references to it being renamed likewise.

Loading history...
116
            } catch (\MongoException $e) {
117
                $result = $this->getMongoCollection()->delete($id);
0 ignored issues
show
Bug introduced by
The method delete() does not exist on MongoCollection. Did you maybe mean deleteIndex()?

This check marks calls to methods that do not seem to exist on an object.

This is most likely the result of a method being renamed without all references to it being renamed likewise.

Loading history...
118
            }
119
        }
120 View Code Duplication
        if ($result['ok'] !== (double) 1) {
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...
121
            throw new Exception('Error deleting file: ' . $result['err'] . ': ' . $result['errmsg']);
122
        }
123
        
124
        return $this;
125
    }
126
}
127