ampache/ampache

View on GitHub
src/Module/Playback/Localplay/Mpd/mpd.php

Summary

Maintainability
F
3 days
Test Coverage

Remove this hard-coded password.
Open

    public const COMMAND_PASSWORD = 'password';

Because it is easy to extract strings from a compiled application, credentials should never be hard-coded. Do so, and they're almost guaranteed to end up in the hands of an attacker. This is particularly true for applications that are distributed.

Credentials should be stored outside of the code in a strongly-protected encrypted configuration file or database.

Noncompliant Code Example

$uname = "steve";
$password = "blue";
connect($uname, $password);

Compliant Solution

$uname = getEncryptedUser();
$password = getEncryptedPass();
connect($uname, $password);

See

File mpd.php has 641 lines of code (exceeds 500 allowed). Consider refactoring.
Open

<?php

declare(strict_types=0);

/**
Severity: Major
Found in src/Module/Playback/Localplay/Mpd/mpd.php - About 5 hrs to fix

    mpd has 39 functions (exceeds 20 allowed). Consider refactoring.
    Open

    class mpd
    {
        // Command names
        // Status queries
        public const COMMAND_CLEARERROR  = 'clearerror';
    Severity: Minor
    Found in src/Module/Playback/Localplay/Mpd/mpd.php - About 5 hrs to fix

      Function SendCommand has a Cognitive Complexity of 24 (exceeds 5 allowed). Consider refactoring.
      Open

          public function SendCommand($command, $arguments = null, $refresh_info = true)
          {
              $this->_debug('SendCommand', "cmd: $command, args: " . json_encode($arguments), 5);
              if (!$this->connected) {
                  $this->_error('SendCommand', 'Not connected');
      Severity: Minor
      Found in src/Module/Playback/Localplay/Mpd/mpd.php - About 3 hrs to fix

      Cognitive Complexity

      Cognitive Complexity is a measure of how difficult a unit of code is to intuitively understand. Unlike Cyclomatic Complexity, which determines how difficult your code will be to test, Cognitive Complexity tells you how difficult your code will be to read and comprehend.

      A method's cognitive complexity is based on a few simple rules:

      • Code is not considered more complex when it uses shorthand that the language provides for collapsing multiple statements into one
      • Code is considered more complex for each "break in the linear flow of the code"
      • Code is considered more complex when "flow breaking structures are nested"

      Further reading

      The class mpd has an overall complexity of 118 which is very high. The configured complexity threshold is 50.
      Open

      class mpd
      {
          // Command names
          // Status queries
          public const COMMAND_CLEARERROR  = 'clearerror';

      The class mpd has 33 non-getter- and setter-methods. Consider refactoring mpd to keep number of methods under 25.
      Open

      class mpd
      {
          // Command names
          // Status queries
          public const COMMAND_CLEARERROR  = 'clearerror';

      TooManyMethods

      Since: 0.1

      A class with too many methods is probably a good suspect for refactoring, in order to reduce its complexity and find a way to have more fine grained objects.

      By default it ignores methods starting with 'get' or 'set'.

      The default was changed from 10 to 25 in PHPMD 2.3.

      Example

      Source https://phpmd.org/rules/codesize.html#toomanymethods

      The class mpd has 27 public methods. Consider refactoring mpd to keep number of public methods under 10.
      Open

      class mpd
      {
          // Command names
          // Status queries
          public const COMMAND_CLEARERROR  = 'clearerror';

      TooManyPublicMethods

      Since: 0.1

      A class with too many public methods is probably a good suspect for refactoring, in order to reduce its complexity and find a way to have more fine grained objects.

      By default it ignores methods starting with 'get' or 'set'.

      Example

      Source https://phpmd.org/rules/codesize.html#toomanypublicmethods

      The class mpd has 16 fields. Consider redesigning mpd to keep the number of fields under 15.
      Open

      class mpd
      {
          // Command names
          // Status queries
          public const COMMAND_CLEARERROR  = 'clearerror';

      TooManyFields

      Since: 0.1

      Classes that have too many fields could be redesigned to have fewer fields, possibly through some nested object grouping of some of the information. For example, a class with city/state/zip fields could instead have one Address field.

      Example

      class Person {
         protected $one;
         private $two;
         private $three;
         [... many more fields ...]
      }

      Source https://phpmd.org/rules/codesize.html#toomanyfields

      Function _checkCompatibility has a Cognitive Complexity of 11 (exceeds 5 allowed). Consider refactoring.
      Open

          private function _checkCompatibility($cmd, $mpd_version): bool
          {
              $mpd = self::_computeVersionValue($mpd_version);
      
              if (isset(self::$_COMPATIBILITY_TABLE[$cmd])) {
      Severity: Minor
      Found in src/Module/Playback/Localplay/Mpd/mpd.php - About 1 hr to fix

      Cognitive Complexity

      Cognitive Complexity is a measure of how difficult a unit of code is to intuitively understand. Unlike Cyclomatic Complexity, which determines how difficult your code will be to test, Cognitive Complexity tells you how difficult your code will be to read and comprehend.

      A method's cognitive complexity is based on a few simple rules:

      • Code is not considered more complex when it uses shorthand that the language provides for collapsing multiple statements into one
      • Code is considered more complex for each "break in the linear flow of the code"
      • Code is considered more complex when "flow breaking structures are nested"

      Further reading

      Function QueueCommand has a Cognitive Complexity of 9 (exceeds 5 allowed). Consider refactoring.
      Open

          public function QueueCommand($command, $arguments = ''): bool
          {
              $this->_debug('QueueCommand', "start; cmd: $command args: " . json_encode($arguments), 5);
              if (!$this->connected) {
                  $this->_error('QueueCommand', 'Not connected');
      Severity: Minor
      Found in src/Module/Playback/Localplay/Mpd/mpd.php - About 55 mins to fix

      Cognitive Complexity

      Cognitive Complexity is a measure of how difficult a unit of code is to intuitively understand. Unlike Cyclomatic Complexity, which determines how difficult your code will be to test, Cognitive Complexity tells you how difficult your code will be to read and comprehend.

      A method's cognitive complexity is based on a few simple rules:

      • Code is not considered more complex when it uses shorthand that the language provides for collapsing multiple statements into one
      • Code is considered more complex for each "break in the linear flow of the code"
      • Code is considered more complex when "flow breaking structures are nested"

      Further reading

      Function connect has a Cognitive Complexity of 9 (exceeds 5 allowed). Consider refactoring.
      Open

          public function connect()
          {
              $this->_debug(self::class, "host: " . $this->host . ", port: " . $this->port, 5);
              $this->_mpd_sock = fsockopen($this->host, (int) $this->port, $err, $err_str, 6);
      
      
      Severity: Minor
      Found in src/Module/Playback/Localplay/Mpd/mpd.php - About 55 mins to fix

      Cognitive Complexity

      Cognitive Complexity is a measure of how difficult a unit of code is to intuitively understand. Unlike Cyclomatic Complexity, which determines how difficult your code will be to test, Cognitive Complexity tells you how difficult your code will be to read and comprehend.

      A method's cognitive complexity is based on a few simple rules:

      • Code is not considered more complex when it uses shorthand that the language provides for collapsing multiple statements into one
      • Code is considered more complex for each "break in the linear flow of the code"
      • Code is considered more complex when "flow breaking structures are nested"

      Further reading

      Function __construct has a Cognitive Complexity of 7 (exceeds 5 allowed). Consider refactoring.
      Open

          public function __construct($server, $port, $password = null, $debug_callback = null)
          {
              $this->host     = trim($server);
              $this->port     = trim($port);
              $this->password = $password;
      Severity: Minor
      Found in src/Module/Playback/Localplay/Mpd/mpd.php - About 35 mins to fix

      Cognitive Complexity

      Cognitive Complexity is a measure of how difficult a unit of code is to intuitively understand. Unlike Cyclomatic Complexity, which determines how difficult your code will be to test, Cognitive Complexity tells you how difficult your code will be to read and comprehend.

      A method's cognitive complexity is based on a few simple rules:

      • Code is not considered more complex when it uses shorthand that the language provides for collapsing multiple statements into one
      • Code is considered more complex for each "break in the linear flow of the code"
      • Code is considered more complex when "flow breaking structures are nested"

      Further reading

      Function _parseFileListResponse has a Cognitive Complexity of 7 (exceeds 5 allowed). Consider refactoring.
      Open

          private static function _parseFileListResponse($response)
          {
              if (is_bool($response)) {
                  return false;
              }
      Severity: Minor
      Found in src/Module/Playback/Localplay/Mpd/mpd.php - About 35 mins to fix

      Cognitive Complexity

      Cognitive Complexity is a measure of how difficult a unit of code is to intuitively understand. Unlike Cyclomatic Complexity, which determines how difficult your code will be to test, Cognitive Complexity tells you how difficult your code will be to read and comprehend.

      A method's cognitive complexity is based on a few simple rules:

      • Code is not considered more complex when it uses shorthand that the language provides for collapsing multiple statements into one
      • Code is considered more complex for each "break in the linear flow of the code"
      • Code is considered more complex when "flow breaking structures are nested"

      Further reading

      Function SetVolume has a Cognitive Complexity of 6 (exceeds 5 allowed). Consider refactoring.
      Open

          public function SetVolume($value)
          {
              $this->_debug('SetVolume', 'start', 5);
              if (!is_numeric($value)) {
                  $this->_error('SetVolume', "argument must be numeric: $value");
      Severity: Minor
      Found in src/Module/Playback/Localplay/Mpd/mpd.php - About 25 mins to fix

      Cognitive Complexity

      Cognitive Complexity is a measure of how difficult a unit of code is to intuitively understand. Unlike Cyclomatic Complexity, which determines how difficult your code will be to test, Cognitive Complexity tells you how difficult your code will be to read and comprehend.

      A method's cognitive complexity is based on a few simple rules:

      • Code is not considered more complex when it uses shorthand that the language provides for collapsing multiple statements into one
      • Code is considered more complex for each "break in the linear flow of the code"
      • Code is considered more complex when "flow breaking structures are nested"

      Further reading

      The class mpd has 1155 lines of code. Current threshold is 1000. Avoid really long classes.
      Open

      class mpd
      {
          // Command names
          // Status queries
          public const COMMAND_CLEARERROR  = 'clearerror';

      The method SendCommand() has a Cyclomatic Complexity of 11. The configured cyclomatic complexity threshold is 10.
      Open

          public function SendCommand($command, $arguments = null, $refresh_info = true)
          {
              $this->_debug('SendCommand', "cmd: $command, args: " . json_encode($arguments), 5);
              if (!$this->connected) {
                  $this->_error('SendCommand', 'Not connected');

      CyclomaticComplexity

      Since: 0.1

      Complexity is determined by the number of decision points in a method plus one for the method entry. The decision points are 'if', 'while', 'for', and 'case labels'. Generally, 1-4 is low complexity, 5-7 indicates moderate complexity, 8-10 is high complexity, and 11+ is very high complexity.

      Example

      // Cyclomatic Complexity = 11
      class Foo {
      1   public function example() {
      2       if ($a == $b) {
      3           if ($a1 == $b1) {
                      fiddle();
      4           } elseif ($a2 == $b2) {
                      fiddle();
                  } else {
                      fiddle();
                  }
      5       } elseif ($c == $d) {
      6           while ($c == $d) {
                      fiddle();
                  }
      7        } elseif ($e == $f) {
      8           for ($n = 0; $n < $h; $n++) {
                      fiddle();
                  }
              } else {
                  switch ($z) {
      9               case 1:
                          fiddle();
                          break;
      10              case 2:
                          fiddle();
                          break;
      11              case 3:
                          fiddle();
                          break;
                      default:
                          fiddle();
                          break;
                  }
              }
          }
      }

      Source https://phpmd.org/rules/codesize.html#cyclomaticcomplexity

      Reduce the number of returns of this function 4, down to the maximum allowed 3.
      Open

          public function SendCommand($command, $arguments = null, $refresh_info = true)

      Having too many return statements in a function increases the function's essential complexity because the flow of execution is broken each time a return statement is encountered. This makes it harder to read and understand the logic of the function.

      Noncompliant Code Example

      With the default threshold of 3:

      function myFunction(){ // Noncompliant as there are 4 return statements
        if (condition1) {
          return true;
        } else {
          if (condition2) {
            return false;
          } else {
            return true;
          }
        }
        return false;
      }
      

      Refactor this function to reduce its Cognitive Complexity from 24 to the 15 allowed.
      Open

          public function SendCommand($command, $arguments = null, $refresh_info = true)

      Cognitive Complexity is a measure of how hard the control flow of a function is to understand. Functions with high Cognitive Complexity will be difficult to maintain.

      See

      Class "mpd" has 39 methods, which is greater than 20 authorized. Split it into smaller classes.
      Open

      class mpd

      A class that grows too much tends to aggregate too many responsibilities and inevitably becomes harder to understand and therefore to maintain. Above a specific threshold, it is strongly advised to refactor the class into smaller ones which focus on well defined topics.

      Reduce the number of returns of this function 4, down to the maximum allowed 3.
      Open

          public function connect()

      Having too many return statements in a function increases the function's essential complexity because the flow of execution is broken each time a return statement is encountered. This makes it harder to read and understand the logic of the function.

      Noncompliant Code Example

      With the default threshold of 3:

      function myFunction(){ // Noncompliant as there are 4 return statements
        if (condition1) {
          return true;
        } else {
          if (condition2) {
            return false;
          } else {
            return true;
          }
        }
        return false;
      }
      

      The method SetVolume uses an else expression. Else clauses are basically not necessary and you can simplify the code by not using them.
      Open

                  } else {
                      $command = self::COMMAND_VOLUME;
                      $value   = $value - $this->status['volume'];
                  }

      ElseExpression

      Since: 1.4.0

      An if expression with an else branch is basically not necessary. You can rewrite the conditions in a way that the else clause is not necessary and the code becomes simpler to read. To achieve this, use early return statements, though you may need to split the code it several smaller methods. For very simple assignments you could also use the ternary operations.

      Example

      class Foo
      {
          public function bar($flag)
          {
              if ($flag) {
                  // one branch
              } else {
                  // another branch
              }
          }
      }

      Source https://phpmd.org/rules/cleancode.html#elseexpression

      The method SetVolume uses an else expression. Else clauses are basically not necessary and you can simplify the code by not using them.
      Open

              } else {
                  $this->RefreshInfo(); // Get the latest volume
                  if ($this->status['volume'] === null) {
                      return false;
                  } else {

      ElseExpression

      Since: 1.4.0

      An if expression with an else branch is basically not necessary. You can rewrite the conditions in a way that the else clause is not necessary and the code becomes simpler to read. To achieve this, use early return statements, though you may need to split the code it several smaller methods. For very simple assignments you could also use the ternary operations.

      Example

      class Foo
      {
          public function bar($flag)
          {
              if ($flag) {
                  // one branch
              } else {
                  // another branch
              }
          }
      }

      Source https://phpmd.org/rules/cleancode.html#elseexpression

      Avoid assigning values to variables in if clauses and the like (line '1007', column '14').
      Open

          public function GetArtists()
          {
              $this->_debug('GetArtists', 'start', 5);
              if (!$response = $this->SendCommand(self::COMMAND_TABLE, self::TABLE_ARTIST, false)) {
                  return false;

      IfStatementAssignment

      Since: 2.7.0

      Assignments in if clauses and the like are considered a code smell. Assignments in PHP return the right operand as their result. In many cases, this is an expected behavior, but can lead to many difficult to spot bugs, especially when the right operand could result in zero, null or an empty string and the like.

      Example

      class Foo
      {
          public function bar($flag)
          {
              if ($foo = 'bar') { // possible typo
                  // ...
              }
              if ($baz = 0) { // always false
                  // ...
              }
          }
      }

      Source http://phpmd.org/rules/cleancode.html#ifstatementassignment

      The method SendCommand uses an else expression. Else clauses are basically not necessary and you can simplify the code by not using them.
      Open

              } else {
                  $response_string = '';
      
                  // Check the command compatibility:
                  if (!$this->_checkCompatibility($command, $this->mpd_version)) {

      ElseExpression

      Since: 1.4.0

      An if expression with an else branch is basically not necessary. You can rewrite the conditions in a way that the else clause is not necessary and the code becomes simpler to read. To achieve this, use early return statements, though you may need to split the code it several smaller methods. For very simple assignments you could also use the ternary operations.

      Example

      class Foo
      {
          public function bar($flag)
          {
              if ($flag) {
                  // one branch
              } else {
                  // another branch
              }
          }
      }

      Source https://phpmd.org/rules/cleancode.html#elseexpression

      The method SendCommand uses an else expression. Else clauses are basically not necessary and you can simplify the code by not using them.
      Open

                      } else {
                          $command .= ' "' . $arguments . '"';
                      }

      ElseExpression

      Since: 1.4.0

      An if expression with an else branch is basically not necessary. You can rewrite the conditions in a way that the else clause is not necessary and the code becomes simpler to read. To achieve this, use early return statements, though you may need to split the code it several smaller methods. For very simple assignments you could also use the ternary operations.

      Example

      class Foo
      {
          public function bar($flag)
          {
              if ($flag) {
                  // one branch
              } else {
                  // another branch
              }
          }
      }

      Source https://phpmd.org/rules/cleancode.html#elseexpression

      The method QueueCommand uses an else expression. Else clauses are basically not necessary and you can simplify the code by not using them.
      Open

                  } else {
                      $command .= ' "' . $arguments . '"';
                  }

      ElseExpression

      Since: 1.4.0

      An if expression with an else branch is basically not necessary. You can rewrite the conditions in a way that the else clause is not necessary and the code becomes simpler to read. To achieve this, use early return statements, though you may need to split the code it several smaller methods. For very simple assignments you could also use the ternary operations.

      Example

      class Foo
      {
          public function bar($flag)
          {
              if ($flag) {
                  // one branch
              } else {
                  // another branch
              }
          }
      }

      Source https://phpmd.org/rules/cleancode.html#elseexpression

      Avoid assigning values to variables in if clauses and the like (line '1043', column '14').
      Open

          public function GetAlbums($artist = null)
          {
              $this->_debug('GetAlbums', 'start', 5);
      
              $params = array(self::TABLE_ALBUM);

      IfStatementAssignment

      Since: 2.7.0

      Assignments in if clauses and the like are considered a code smell. Assignments in PHP return the right operand as their result. In many cases, this is an expected behavior, but can lead to many difficult to spot bugs, especially when the right operand could result in zero, null or an empty string and the like.

      Example

      class Foo
      {
          public function bar($flag)
          {
              if ($foo = 'bar') { // possible typo
                  // ...
              }
              if ($baz = 0) { // always false
                  // ...
              }
          }
      }

      Source http://phpmd.org/rules/cleancode.html#ifstatementassignment

      Rename "$status" which has the same name as the field declared at line 190.
      Open

              $status = $this->SendCommand(self::COMMAND_STATUS, null, false);

      Shadowing fields with a local variable is a bad practice that reduces code readability: it makes it confusing to know whether the field or the variable is being used.

      Noncompliant Code Example

      class Foo {
        public $myField;
      
        public function doSomething() {
          $myField = 0;
          ...
        }
      }
      

      See

      Define a constant instead of duplicating this literal "Not connected" 3 times.
      Open

                  $this->_error('SendCommand', 'Not connected');

      Duplicated string literals make the process of refactoring error-prone, since you must be sure to update all occurrences.

      On the other hand, constants can be referenced from many places, but only need to be updated in a single place.

      Noncompliant Code Example

      With the default threshold of 3:

      function run() {
        prepare('action1');                              // Non-Compliant - 'action1' is duplicated 3 times
        execute('action1');
        release('action1');
      }
      

      Compliant Solution

      ACTION_1 = 'action1';
      
      function run() {
        prepare(ACTION_1);
        execute(ACTION_1);
        release(ACTION_1);
      }
      

      Exceptions

      To prevent generating some false-positives, literals having less than 5 characters are excluded.

      Define a constant instead of duplicating this literal "QueueCommand" 3 times.
      Open

              $this->_debug('QueueCommand', "start; cmd: $command args: " . json_encode($arguments), 5);

      Duplicated string literals make the process of refactoring error-prone, since you must be sure to update all occurrences.

      On the other hand, constants can be referenced from many places, but only need to be updated in a single place.

      Noncompliant Code Example

      With the default threshold of 3:

      function run() {
        prepare('action1');                              // Non-Compliant - 'action1' is duplicated 3 times
        execute('action1');
        release('action1');
      }
      

      Compliant Solution

      ACTION_1 = 'action1';
      
      function run() {
        prepare(ACTION_1);
        execute(ACTION_1);
        release(ACTION_1);
      }
      

      Exceptions

      To prevent generating some false-positives, literals having less than 5 characters are excluded.

      Define a constant instead of duplicating this literal "AdjustVolume" 3 times.
      Open

              $this->_debug('AdjustVolume', 'start', 5);

      Duplicated string literals make the process of refactoring error-prone, since you must be sure to update all occurrences.

      On the other hand, constants can be referenced from many places, but only need to be updated in a single place.

      Noncompliant Code Example

      With the default threshold of 3:

      function run() {
        prepare('action1');                              // Non-Compliant - 'action1' is duplicated 3 times
        execute('action1');
        release('action1');
      }
      

      Compliant Solution

      ACTION_1 = 'action1';
      
      function run() {
        prepare(ACTION_1);
        execute(ACTION_1);
        release(ACTION_1);
      }
      

      Exceptions

      To prevent generating some false-positives, literals having less than 5 characters are excluded.

      Rename "$stats" which has the same name as the field declared at line 189.
      Open

              $stats  = $this->SendCommand(self::COMMAND_STATISTICS, null, false);

      Shadowing fields with a local variable is a bad practice that reduces code readability: it makes it confusing to know whether the field or the variable is being used.

      Noncompliant Code Example

      class Foo {
        public $myField;
      
        public function doSomething() {
          $myField = 0;
          ...
        }
      }
      

      See

      Define a constant instead of duplicating this literal "SendCommandQueue" 3 times.
      Open

              $this->_debug('SendCommandQueue', 'start', 5);

      Duplicated string literals make the process of refactoring error-prone, since you must be sure to update all occurrences.

      On the other hand, constants can be referenced from many places, but only need to be updated in a single place.

      Noncompliant Code Example

      With the default threshold of 3:

      function run() {
        prepare('action1');                              // Non-Compliant - 'action1' is duplicated 3 times
        execute('action1');
        release('action1');
      }
      

      Compliant Solution

      ACTION_1 = 'action1';
      
      function run() {
        prepare(ACTION_1);
        execute(ACTION_1);
        release(ACTION_1);
      }
      

      Exceptions

      To prevent generating some false-positives, literals having less than 5 characters are excluded.

      Define a constant instead of duplicating this literal "SkipTo" 3 times.
      Open

              $this->_debug('SkipTo', 'start', 5);

      Duplicated string literals make the process of refactoring error-prone, since you must be sure to update all occurrences.

      On the other hand, constants can be referenced from many places, but only need to be updated in a single place.

      Noncompliant Code Example

      With the default threshold of 3:

      function run() {
        prepare('action1');                              // Non-Compliant - 'action1' is duplicated 3 times
        execute('action1');
        release('action1');
      }
      

      Compliant Solution

      ACTION_1 = 'action1';
      
      function run() {
        prepare(ACTION_1);
        execute(ACTION_1);
        release(ACTION_1);
      }
      

      Exceptions

      To prevent generating some false-positives, literals having less than 5 characters are excluded.

      Rename "$status" which has the same name as the field declared at line 190.
      Open

              $status = socket_get_status($this->_mpd_sock);

      Shadowing fields with a local variable is a bad practice that reduces code readability: it makes it confusing to know whether the field or the variable is being used.

      Noncompliant Code Example

      class Foo {
        public $myField;
      
        public function doSomething() {
          $myField = 0;
          ...
        }
      }
      

      See

      Define a constant instead of duplicating this literal "PLMoveTrack" 4 times.
      Open

              $this->_debug('PLMoveTrack', 'start', 5);

      Duplicated string literals make the process of refactoring error-prone, since you must be sure to update all occurrences.

      On the other hand, constants can be referenced from many places, but only need to be updated in a single place.

      Noncompliant Code Example

      With the default threshold of 3:

      function run() {
        prepare('action1');                              // Non-Compliant - 'action1' is duplicated 3 times
        execute('action1');
        release('action1');
      }
      

      Compliant Solution

      ACTION_1 = 'action1';
      
      function run() {
        prepare(ACTION_1);
        execute(ACTION_1);
        release(ACTION_1);
      }
      

      Exceptions

      To prevent generating some false-positives, literals having less than 5 characters are excluded.

      Define a constant instead of duplicating this literal "volume" 4 times.
      Open

          public const COMMAND_VOLUME = 'volume';

      Duplicated string literals make the process of refactoring error-prone, since you must be sure to update all occurrences.

      On the other hand, constants can be referenced from many places, but only need to be updated in a single place.

      Noncompliant Code Example

      With the default threshold of 3:

      function run() {
        prepare('action1');                              // Non-Compliant - 'action1' is duplicated 3 times
        execute('action1');
        release('action1');
      }
      

      Compliant Solution

      ACTION_1 = 'action1';
      
      function run() {
        prepare(ACTION_1);
        execute(ACTION_1);
        release(ACTION_1);
      }
      

      Exceptions

      To prevent generating some false-positives, literals having less than 5 characters are excluded.

      Define a constant instead of duplicating this literal "0.10.0" 3 times.
      Open

              self::COMMAND_PASSWORD => array('min' => '0.10.0', 'max' => false),

      Duplicated string literals make the process of refactoring error-prone, since you must be sure to update all occurrences.

      On the other hand, constants can be referenced from many places, but only need to be updated in a single place.

      Noncompliant Code Example

      With the default threshold of 3:

      function run() {
        prepare('action1');                              // Non-Compliant - 'action1' is duplicated 3 times
        execute('action1');
        release('action1');
      }
      

      Compliant Solution

      ACTION_1 = 'action1';
      
      function run() {
        prepare(ACTION_1);
        execute(ACTION_1);
        release(ACTION_1);
      }
      

      Exceptions

      To prevent generating some false-positives, literals having less than 5 characters are excluded.

      Define a constant instead of duplicating this literal "0.9.1" 4 times.
      Open

              self::COMMAND_MOVETRACK => array('min' => '0.9.1', 'max' => false),

      Duplicated string literals make the process of refactoring error-prone, since you must be sure to update all occurrences.

      On the other hand, constants can be referenced from many places, but only need to be updated in a single place.

      Noncompliant Code Example

      With the default threshold of 3:

      function run() {
        prepare('action1');                              // Non-Compliant - 'action1' is duplicated 3 times
        execute('action1');
        release('action1');
      }
      

      Compliant Solution

      ACTION_1 = 'action1';
      
      function run() {
        prepare(ACTION_1);
        execute(ACTION_1);
        release(ACTION_1);
      }
      

      Exceptions

      To prevent generating some false-positives, literals having less than 5 characters are excluded.

      Define a constant instead of duplicating this literal "return: " 5 times.
      Open

              $this->_debug('GetDir', 'return: ' . json_encode($dirlist), 5);

      Duplicated string literals make the process of refactoring error-prone, since you must be sure to update all occurrences.

      On the other hand, constants can be referenced from many places, but only need to be updated in a single place.

      Noncompliant Code Example

      With the default threshold of 3:

      function run() {
        prepare('action1');                              // Non-Compliant - 'action1' is duplicated 3 times
        execute('action1');
        release('action1');
      }
      

      Compliant Solution

      ACTION_1 = 'action1';
      
      function run() {
        prepare(ACTION_1);
        execute(ACTION_1);
        release(ACTION_1);
      }
      

      Exceptions

      To prevent generating some false-positives, literals having less than 5 characters are excluded.

      Rename "$playlist" which has the same name as the field declared at line 191.
      Open

              $playlist       = $this->SendCommand(self::COMMAND_PLINFO, null, false);

      Shadowing fields with a local variable is a bad practice that reduces code readability: it makes it confusing to know whether the field or the variable is being used.

      Noncompliant Code Example

      class Foo {
        public $myField;
      
        public function doSomething() {
          $myField = 0;
          ...
        }
      }
      

      See

      Define a constant instead of duplicating this literal "SeekTo" 4 times.
      Open

              $this->_debug('SeekTo', 'start', 5);

      Duplicated string literals make the process of refactoring error-prone, since you must be sure to update all occurrences.

      On the other hand, constants can be referenced from many places, but only need to be updated in a single place.

      Noncompliant Code Example

      With the default threshold of 3:

      function run() {
        prepare('action1');                              // Non-Compliant - 'action1' is duplicated 3 times
        execute('action1');
        release('action1');
      }
      

      Compliant Solution

      ACTION_1 = 'action1';
      
      function run() {
        prepare(ACTION_1);
        execute(ACTION_1);
        release(ACTION_1);
      }
      

      Exceptions

      To prevent generating some false-positives, literals having less than 5 characters are excluded.

      Define a constant instead of duplicating this literal "0.15.0" 3 times.
      Open

              self::COMMAND_CONSUME => array('min' => '0.15.0', 'max' => false),

      Duplicated string literals make the process of refactoring error-prone, since you must be sure to update all occurrences.

      On the other hand, constants can be referenced from many places, but only need to be updated in a single place.

      Noncompliant Code Example

      With the default threshold of 3:

      function run() {
        prepare('action1');                              // Non-Compliant - 'action1' is duplicated 3 times
        execute('action1');
        release('action1');
      }
      

      Compliant Solution

      ACTION_1 = 'action1';
      
      function run() {
        prepare(ACTION_1);
        execute(ACTION_1);
        release(ACTION_1);
      }
      

      Exceptions

      To prevent generating some false-positives, literals having less than 5 characters are excluded.

      Define a constant instead of duplicating this literal "Connect" 3 times.
      Open

                  $this->_error('Connect', "Socket Error: $err_str ($err)");

      Duplicated string literals make the process of refactoring error-prone, since you must be sure to update all occurrences.

      On the other hand, constants can be referenced from many places, but only need to be updated in a single place.

      Noncompliant Code Example

      With the default threshold of 3:

      function run() {
        prepare('action1');                              // Non-Compliant - 'action1' is duplicated 3 times
        execute('action1');
        release('action1');
      }
      

      Compliant Solution

      ACTION_1 = 'action1';
      
      function run() {
        prepare(ACTION_1);
        execute(ACTION_1);
        release(ACTION_1);
      }
      

      Exceptions

      To prevent generating some false-positives, literals having less than 5 characters are excluded.

      Define a constant instead of duplicating this literal "Search" 3 times.
      Open

              $this->_debug('Search', 'start', 5);

      Duplicated string literals make the process of refactoring error-prone, since you must be sure to update all occurrences.

      On the other hand, constants can be referenced from many places, but only need to be updated in a single place.

      Noncompliant Code Example

      With the default threshold of 3:

      function run() {
        prepare('action1');                              // Non-Compliant - 'action1' is duplicated 3 times
        execute('action1');
        release('action1');
      }
      

      Compliant Solution

      ACTION_1 = 'action1';
      
      function run() {
        prepare(ACTION_1);
        execute(ACTION_1);
        release(ACTION_1);
      }
      

      Exceptions

      To prevent generating some false-positives, literals having less than 5 characters are excluded.

      Define a constant instead of duplicating this literal "SendCommand" 4 times.
      Open

              $this->_debug('SendCommand', "cmd: $command, args: " . json_encode($arguments), 5);

      Duplicated string literals make the process of refactoring error-prone, since you must be sure to update all occurrences.

      On the other hand, constants can be referenced from many places, but only need to be updated in a single place.

      Noncompliant Code Example

      With the default threshold of 3:

      function run() {
        prepare('action1');                              // Non-Compliant - 'action1' is duplicated 3 times
        execute('action1');
        release('action1');
      }
      

      Compliant Solution

      ACTION_1 = 'action1';
      
      function run() {
        prepare(ACTION_1);
        execute(ACTION_1);
        release(ACTION_1);
      }
      

      Exceptions

      To prevent generating some false-positives, literals having less than 5 characters are excluded.

      Define a constant instead of duplicating this literal "construct" 5 times.
      Open

              $this->_debug('construct', 'constructor called', 5);

      Duplicated string literals make the process of refactoring error-prone, since you must be sure to update all occurrences.

      On the other hand, constants can be referenced from many places, but only need to be updated in a single place.

      Noncompliant Code Example

      With the default threshold of 3:

      function run() {
        prepare('action1');                              // Non-Compliant - 'action1' is duplicated 3 times
        execute('action1');
        release('action1');
      }
      

      Compliant Solution

      ACTION_1 = 'action1';
      
      function run() {
        prepare(ACTION_1);
        execute(ACTION_1);
        release(ACTION_1);
      }
      

      Exceptions

      To prevent generating some false-positives, literals having less than 5 characters are excluded.

      Define a constant instead of duplicating this literal "SetVolume" 3 times.
      Open

              $this->_debug('SetVolume', 'start', 5);

      Duplicated string literals make the process of refactoring error-prone, since you must be sure to update all occurrences.

      On the other hand, constants can be referenced from many places, but only need to be updated in a single place.

      Noncompliant Code Example

      With the default threshold of 3:

      function run() {
        prepare('action1');                              // Non-Compliant - 'action1' is duplicated 3 times
        execute('action1');
        release('action1');
      }
      

      Compliant Solution

      ACTION_1 = 'action1';
      
      function run() {
        prepare(ACTION_1);
        execute(ACTION_1);
        release(ACTION_1);
      }
      

      Exceptions

      To prevent generating some false-positives, literals having less than 5 characters are excluded.

      Define a constant instead of duplicating this literal "start" 27 times.
      Open

              $this->_debug('SendCommandQueue', 'start', 5);

      Duplicated string literals make the process of refactoring error-prone, since you must be sure to update all occurrences.

      On the other hand, constants can be referenced from many places, but only need to be updated in a single place.

      Noncompliant Code Example

      With the default threshold of 3:

      function run() {
        prepare('action1');                              // Non-Compliant - 'action1' is duplicated 3 times
        execute('action1');
        release('action1');
      }
      

      Compliant Solution

      ACTION_1 = 'action1';
      
      function run() {
        prepare(ACTION_1);
        execute(ACTION_1);
        release(ACTION_1);
      }
      

      Exceptions

      To prevent generating some false-positives, literals having less than 5 characters are excluded.

      Avoid unused local variables such as '$response'.
      Open

              $response = $this->SendCommand(self::COMMAND_PLAY, $idx);

      UnusedLocalVariable

      Since: 0.2

      Detects when a local variable is declared and/or assigned, but not used.

      Example

      class Foo {
          public function doSomething()
          {
              $i = 5; // Unused
          }
      }

      Source https://phpmd.org/rules/unusedcode.html#unusedlocalvariable

      Avoid unused local variables such as '$response'.
      Open

              $response = $this->SendCommand(self::COMMAND_SEEK, array($track, $pos));

      UnusedLocalVariable

      Since: 0.2

      Detects when a local variable is declared and/or assigned, but not used.

      Example

      class Foo {
          public function doSomething()
          {
              $i = 5; // Unused
          }
      }

      Source https://phpmd.org/rules/unusedcode.html#unusedlocalvariable

      Suspicious attempt to unset class \Ampache\Module\Playback\Localplay\Mpd\mpd's property mpd_version declared at /code/src/Module/Playback/Localplay/Mpd/mpd.php:187 (This can be done, but is more commonly done for dynamic properties and Phan does not expect this)
      Open

              unset($this->mpd_version);

      Suspicious attempt to unset class \Ampache\Module\Playback\Localplay\Mpd\mpd's property mpd_version declared at /code/src/Module/Playback/Localplay/Mpd/mpd.php:187 (This can be done, but is more commonly done for dynamic properties and Phan does not expect this)
      Open

              unset($this->mpd_version);

      Suspicious attempt to unset class \Ampache\Module\Playback\Localplay\Mpd\mpd's property _mpd_sock declared at /code/src/Module/Playback/Localplay/Mpd/mpd.php:183 (This can be done, but is more commonly done for dynamic properties and Phan does not expect this)
      Open

              unset($this->_mpd_sock);

      Suspicious attempt to unset class \Ampache\Module\Playback\Localplay\Mpd\mpd's property err_str declared at /code/src/Module/Playback/Localplay/Mpd/mpd.php:196 (This can be done, but is more commonly done for dynamic properties and Phan does not expect this)
      Open

              unset($this->err_str);

      Suspicious attempt to unset class \Ampache\Module\Playback\Localplay\Mpd\mpd's property _mpd_sock declared at /code/src/Module/Playback/Localplay/Mpd/mpd.php:183 (This can be done, but is more commonly done for dynamic properties and Phan does not expect this)
      Open

              unset($this->_mpd_sock);

      Returning type float|int|string but SkipTo() is declared to return bool
      Open

              return $idx;

      Suspicious attempt to unset class \Ampache\Module\Playback\Localplay\Mpd\mpd's property err_str declared at /code/src/Module/Playback/Localplay/Mpd/mpd.php:196 (This can be done, but is more commonly done for dynamic properties and Phan does not expect this)
      Open

              unset($this->err_str);

      Assigning null to property but \Ampache\Module\Playback\Localplay\Mpd\mpd->_command_queue is string
      Open

                  $this->_command_queue = null;

      Returning type float|int|string but SeekTo() is declared to return bool
      Open

              return $pos;

      Similar blocks of code found in 2 locations. Consider refactoring.
      Open

          public function Search($type, $string)
          {
              $this->_debug('Search', 'start', 5);
      
              if ($type != self::SEARCH_ARTIST && $type != self::SEARCH_ALBUM && $type != self::SEARCH_TITLE) {
      Severity: Major
      Found in src/Module/Playback/Localplay/Mpd/mpd.php and 1 other location - About 4 hrs to fix
      src/Module/Playback/Localplay/Mpd/mpd.php on lines 960..980

      Duplicated Code

      Duplicated code can lead to software that is hard to understand and difficult to change. The Don't Repeat Yourself (DRY) principle states:

      Every piece of knowledge must have a single, unambiguous, authoritative representation within a system.

      When you violate DRY, bugs and maintenance problems are sure to follow. Duplicated code has a tendency to both continue to replicate and also to diverge (leaving bugs as two similar implementations differ in subtle ways).

      Tuning

      This issue has a mass of 169.

      We set useful threshold defaults for the languages we support but you may want to adjust these settings based on your project guidelines.

      The threshold configuration represents the minimum mass a code block must have to be analyzed for duplication. The lower the threshold, the more fine-grained the comparison.

      If the engine is too easily reporting duplication, try raising the threshold. If you suspect that the engine isn't catching enough duplication, try lowering the threshold. The best setting tends to differ from language to language.

      See codeclimate-duplication's documentation for more information about tuning the mass threshold in your .codeclimate.yml.

      Refactorings

      Further Reading

      Similar blocks of code found in 2 locations. Consider refactoring.
      Open

          public function Find($type, $string)
          {
              $this->_debug('Find', 'start', 5);
              if ($type != self::SEARCH_ARTIST && $type != self::SEARCH_ALBUM && $type != self::SEARCH_TITLE) {
                  $this->_error('Find', 'invalid find type');
      Severity: Major
      Found in src/Module/Playback/Localplay/Mpd/mpd.php and 1 other location - About 4 hrs to fix
      src/Module/Playback/Localplay/Mpd/mpd.php on lines 926..946

      Duplicated Code

      Duplicated code can lead to software that is hard to understand and difficult to change. The Don't Repeat Yourself (DRY) principle states:

      Every piece of knowledge must have a single, unambiguous, authoritative representation within a system.

      When you violate DRY, bugs and maintenance problems are sure to follow. Duplicated code has a tendency to both continue to replicate and also to diverge (leaving bugs as two similar implementations differ in subtle ways).

      Tuning

      This issue has a mass of 169.

      We set useful threshold defaults for the languages we support but you may want to adjust these settings based on your project guidelines.

      The threshold configuration represents the minimum mass a code block must have to be analyzed for duplication. The lower the threshold, the more fine-grained the comparison.

      If the engine is too easily reporting duplication, try raising the threshold. If you suspect that the engine isn't catching enough duplication, try lowering the threshold. The best setting tends to differ from language to language.

      See codeclimate-duplication's documentation for more information about tuning the mass threshold in your .codeclimate.yml.

      Refactorings

      Further Reading

      The class mpd is not named in CamelCase.
      Open

      class mpd
      {
          // Command names
          // Status queries
          public const COMMAND_CLEARERROR  = 'clearerror';

      CamelCaseClassName

      Since: 0.2

      It is considered best practice to use the CamelCase notation to name classes.

      Example

      class class_name {
      }

      Source

      The parameter $debug_callback is not named in camelCase.
      Open

          public function __construct($server, $port, $password = null, $debug_callback = null)
          {
              $this->host     = trim($server);
              $this->port     = trim($port);
              $this->password = $password;

      CamelCaseParameterName

      Since: 0.2

      It is considered best practice to use the camelCase notation to name parameters.

      Example

      class ClassName {
          public function doSomething($user_name) {
          }
      }

      Source

      Avoid variables with short names like $id. Configured minimum length is 3.
      Open

          public function PLRemove($id)

      ShortVariable

      Since: 0.2

      Detects when a field, local, or parameter has a very short name.

      Example

      class Something {
          private $q = 15; // VIOLATION - Field
          public static function main( array $as ) { // VIOLATION - Formal
              $r = 20 + $this->q; // VIOLATION - Local
              for (int $i = 0; $i < 10; $i++) { // Not a Violation (inside FOR)
                  $r += $this->q;
              }
          }
      }

      Source https://phpmd.org/rules/naming.html#shortvariable

      The parameter $current_position is not named in camelCase.
      Open

          public function PLMoveTrack($current_position, $new_position)
          {
              $this->_debug('PLMoveTrack', 'start', 5);
              if (!is_numeric($current_position)) {
                  $this->_error('PLMoveTrack', "current_position must be numeric: $current_position");

      CamelCaseParameterName

      Since: 0.2

      It is considered best practice to use the camelCase notation to name parameters.

      Example

      class ClassName {
          public function doSomething($user_name) {
          }
      }

      Source

      The parameter $new_position is not named in camelCase.
      Open

          public function PLMoveTrack($current_position, $new_position)
          {
              $this->_debug('PLMoveTrack', 'start', 5);
              if (!is_numeric($current_position)) {
                  $this->_error('PLMoveTrack', "current_position must be numeric: $current_position");

      CamelCaseParameterName

      Since: 0.2

      It is considered best practice to use the camelCase notation to name parameters.

      Example

      class ClassName {
          public function doSomething($user_name) {
          }
      }

      Source

      The parameter $refresh_info is not named in camelCase.
      Open

          public function SendCommand($command, $arguments = null, $refresh_info = true)
          {
              $this->_debug('SendCommand', "cmd: $command, args: " . json_encode($arguments), 5);
              if (!$this->connected) {
                  $this->_error('SendCommand', 'Not connected');

      CamelCaseParameterName

      Since: 0.2

      It is considered best practice to use the camelCase notation to name parameters.

      Example

      class ClassName {
          public function doSomething($user_name) {
          }
      }

      Source

      The parameter $mpd_version is not named in camelCase.
      Open

          private function _checkCompatibility($cmd, $mpd_version): bool
          {
              $mpd = self::_computeVersionValue($mpd_version);
      
              if (isset(self::$_COMPATIBILITY_TABLE[$cmd])) {

      CamelCaseParameterName

      Since: 0.2

      It is considered best practice to use the camelCase notation to name parameters.

      Example

      class ClassName {
          public function doSomething($user_name) {
          }
      }

      Source

      Method name "_computeVersionValue" should not be prefixed with an underscore to indicate visibility
      Open

          private static function _computeVersionValue($string)

      Method name "_debug" should not be prefixed with an underscore to indicate visibility
      Open

          private function _debug($source, $message, $level)

      Method name "_checkCompatibility" should not be prefixed with an underscore to indicate visibility
      Open

          private function _checkCompatibility($cmd, $mpd_version): bool

      Method name "_parseFileListResponse" should not be prefixed with an underscore to indicate visibility
      Open

          private static function _parseFileListResponse($response)

      Method name "_parseResponse" should not be prefixed with an underscore to indicate visibility
      Open

          private static function _parseResponse($response)

      Property name "$_command_queue" should not be prefixed with an underscore to indicate visibility
      Open

          private $_command_queue; // The list of commands for bulk command sending

      Method name "_error" should not be prefixed with an underscore to indicate visibility
      Open

          private function _error($source, $message, $level = 1)

      Property name "$_mpd_sock" should not be prefixed with an underscore to indicate visibility
      Open

          private $_mpd_sock = null;

      Property name "$_COMPATIBILITY_TABLE" should not be prefixed with an underscore to indicate visibility
      Open

          private static $_COMPATIBILITY_TABLE = array(

      Property name "$_debug_callback" should not be prefixed with an underscore to indicate visibility
      Open

          private $_debug_callback = null; // Optional callback to be run on debug

      Class name "mpd" is not in camel caps format
      Open

      class mpd

      There are no issues that match your filters.

      Category
      Status