Merge branch 'issue-62' of https://github.com/eeree/phpmd into eeree-…

…issue-62

src/main/php/PHPMD/Rule/CleanCode/ErrorControlOperator.php

@@ -0,0 +1,50 @@
+<?php
+/**
+ * This file is part of PHP Mess Detector.
+ *
+ * Copyright (c) Manuel Pichler <mapi@phpmd.org>.
+ * All rights reserved.
+ *
+ * Licensed under BSD License
+ * For full copyright and license information, please see the LICENSE file.
+ * Redistributions of files must retain the above copyright notice.
+ *
+ * @author Manuel Pichler <mapi@phpmd.org>
+ * @copyright Manuel Pichler. All rights reserved.
+ * @license https://opensource.org/licenses/bsd-license.php BSD License
+ * @link http://phpmd.org/
+ */
+
+namespace PHPMD\Rule\CleanCode;
+
+use PHPMD\AbstractNode;
+use PHPMD\AbstractRule;
+use PHPMD\Rule\ClassAware;
+use PHPMD\Rule\FunctionAware;
+use PHPMD\Rule\MethodAware;
+
+/**
+ * Error Control Operators Rule
+ *
+ * This rule detects usage of error control operator (@).
+ *
+ * @author Kamil Szymanaski <kamil.szymanski@gmail.com>
+ * @link http://php.net/manual/en/language.operators.errorcontrol.php
+ */
+class ErrorControlOperator extends AbstractRule implements MethodAware, FunctionAware
+{
+    /**
+     * Loops trough all class or function nodes and looks for '@' sign.
+     *
+     * @param AbstractNode $node
+     * @return void
+     */
+    public function apply(AbstractNode $node)
+    {
+        foreach ($node->findChildrenOfType('UnaryExpression') as $unaryExpression) {
+            if ($unaryExpression->getImage() === '@') {
+                $this->addViolation($node, array($unaryExpression->getBeginLine()));
+            }
+        }
+    }
+}

src/main/resources/rulesets/cleancode.xml

@@ -158,6 +158,28 @@ function createArray() {
         </example>
     </rule>
 
+    <rule name="ErrorControlOperator"
+          message="Remove error control operator '@' on line {0}."
+          class="PHPMD\Rule\CleanCode\ErrorControlOperator"
+          externalInfoUrl="http://phpmd.org/rules/cleancode.html#errorcontroloperator">
+        <description>
+            <![CDATA[
+Error suppression should be avoided if possible as it doesn't just suppress the error, that
+you are trying to stop, but will also suppress errors that you didn't predict would ever occur.
+Consider changing error_reporting() level and/or setting up your own error handler.
+            ]]>
+        </description>
+        <priority>1</priority>
+        <example>
+            <![CDATA[
+function foo($filePath) {
+    $file = @fopen($filPath); // hides exceptions
+    $key = @$array[$notExistingKey]; // assigns null to $key
+}
+            ]]>
+        </example>
+    </rule>
+
     <rule name="MissingImport"
           since="2.7.0"
           message="Missing class import via use statement (line '{0}', column '{1}')."

src/site/rst/rules/cleancode.rst

@@ -105,6 +105,20 @@ Example: ::
       ];
   }
 
+ErrorControlOperator
+====================
+
+Since: PHPMD 2.9.0
+
+Error suppression should be avoided if possible as it doesn't just suppress the error, that you are trying to stop, but will also suppress errors that you didn't predict would ever occur. Moreover it slows down execution of your code by average of 1.75x. Consider changing error_reporting() level and/or setting up your own error handler.
+
+Example: ::
+
+  function foo($filePath) {
+      $file = @fopen($filPath); // hides exceptions
+      $key = @$array[$notExistingKey]; // assigns null to $key
+  }
+
 MissingImport
 =============
 

src/site/rst/rules/index.rst

@@ -21,6 +21,7 @@ Clean Code Rules
 - `DuplicateArrayKey <cleancode.html#duplicatearraykey>`_: Defining another value for the same key in an array literal overrides the previous key/value, which makes it effectively an unused code. If it's known from the beginning that the key will have different value, there is usually no point in defining first one.
 - `MissingImport <cleancode.html#missingimport>`_: Importing all external classes in a file through use statements makes them clearly visible.
 - `UndefinedVariable <cleancode.html#undefinedvariable>`_: Detects when a variable is used that has not been defined before.
+- `ErrorControlOperator <cleancode.html#errorcontroloperator>`_: Error suppression should be avoided if possible as it doesn't just suppress the error, that you are trying to stop, but will also suppress errors that you didn't predict would ever occur. Moreover it slows down execution of your code by average of 1.75x. Consider changing error_reporting() level and/or setting up your own error handler.
 
 Code Size Rules
 ===============

src/test/php/PHPMD/Rule/CleanCode/ErrorControlOperatorTest.php

@@ -0,0 +1,62 @@
+<?php
+/**
+ * This file is part of PHP Mess Detector.
+ *
+ * Copyright (c) Manuel Pichler <mapi@phpmd.org>.
+ * All rights reserved.
+ *
+ * Licensed under BSD License
+ * For full copyright and license information, please see the LICENSE file.
+ * Redistributions of files must retain the above copyright notice.
+ *
+ * @author Manuel Pichler <mapi@phpmd.org>
+ * @copyright Manuel Pichler. All rights reserved.
+ * @license https://opensource.org/licenses/bsd-license.php BSD License
+ * @link http://phpmd.org/
+ */
+
+namespace PHPMD\Rule\CleanCode;
+
+use PHPMD\AbstractTest;
+
+/**
+ * Error Control Operator Test
+ */
+class ErrorControlOperatorTest extends AbstractTest
+{
+    /**
+     * testAppliedToFunctions
+     *
+     * @return void
+     */
+    public function testDoesNotApplyToOtherUnaryOperatorsInFunction()
+    {
+        $rule = new ErrorControlOperator();
+        $rule->setReport($this->getReportMock(1));
+        $rule->apply($this->getFunction());
+    }
+
+    /**
+     * testAppliedToFunctions
+     *
+     * @return void
+     */
+    public function testAppliesToErrorControlOperatorInFunction()
+    {
+        $rule = new ErrorControlOperator();
+        $rule->setReport($this->getReportMock(3));
+        $rule->apply($this->getFunction());
+    }
+
+    /**
+     * testAppliedToClassesAndMethods
+     *
+     * @return void
+     */
+    public function testAppliedToClassesAndMethods()
+    {
+        $rule = new ErrorControlOperator();
+        $rule->setReport($this->getReportMock(6));
+        $rule->apply($this->getClass());
+    }
+}

src/test/resources/files/Rule/CleanCode/ErrorControlOperator/testAppliedToClassesAndMethods.php

@@ -0,0 +1,55 @@
+<?php
+/**
+ * This file is part of PHP Mess Detector.
+ *
+ * Copyright (c) Manuel Pichler <mapi@phpmd.org>.
+ * All rights reserved.
+ *
+ * Licensed under BSD License
+ * For full copyright and license information, please see the LICENSE file.
+ * Redistributions of files must retain the above copyright notice.
+ *
+ * @author Manuel Pichler <mapi@phpmd.org>
+ * @copyright Manuel Pichler. All rights reserved.
+ * @license https://opensource.org/licenses/bsd-license.php BSD License
+ * @link http://phpmd.org/
+ */
+
+/**
+ * Class testAppliedToClassesAndMethods
+ */
+class testAppliedToClassesAndMethods
+{
+    /**
+     * @var string
+     */
+    private $baz = 'baz';
+
+    /**
+     * testAppliedToClassesAndMethods
+     */
+    public function testAppliedToClassesAndMethods()
+    {
+        $foo = @$this->fooBar();
+        ++$foo;
+        @!$baz = 1 / 0;
+        if (@is_readable(__FILE__)) {
+            $bar = new DateTime('now');
+            @$baz = $bar;
+        }
+        $this->baz = !$foo;
+    }
+
+    /**
+     * fooBar
+     *
+     * @return int
+     */
+    private function fooBar()
+    {
+        @$foo = $this->baz / 0;
+        @$baz = !$foo;
+
+        return 2;
+    }
+}

src/test/resources/files/Rule/CleanCode/ErrorControlOperator/testAppliesToErrorControlOperatorInFunction.php

@@ -0,0 +1,30 @@
+<?php
+/**
+ * This file is part of PHP Mess Detector.
+ *
+ * Copyright (c) Manuel Pichler <mapi@phpmd.org>.
+ * All rights reserved.
+ *
+ * Licensed under BSD License
+ * For full copyright and license information, please see the LICENSE file.
+ * Redistributions of files must retain the above copyright notice.
+ *
+ * @author Manuel Pichler <mapi@phpmd.org>
+ * @copyright Manuel Pichler. All rights reserved.
+ * @license https://opensource.org/licenses/bsd-license.php BSD License
+ * @link http://phpmd.org/
+ */
+
+/**
+ * testAppliesToErrorControlOperatorInFunction
+ *
+ * @return array
+ */
+function testAppliesToErrorControlOperatorInFunction()
+{
+    $foo = @debug_backtrace();
+    $bar = @is_dir(__FILE__);
+    @$average = 3 / 0;
+
+    return [$foo, $bar, $average];
+}

src/test/resources/files/Rule/CleanCode/ErrorControlOperator/testDoesNotApplyToOtherUnaryOperatorsInFunction.php

@@ -0,0 +1,31 @@
+<?php
+/**
+ * This file is part of PHP Mess Detector.
+ *
+ * Copyright (c) Manuel Pichler <mapi@phpmd.org>.
+ * All rights reserved.
+ *
+ * Licensed under BSD License
+ * For full copyright and license information, please see the LICENSE file.
+ * Redistributions of files must retain the above copyright notice.
+ *
+ * @author Manuel Pichler <mapi@phpmd.org>
+ * @copyright Manuel Pichler. All rights reserved.
+ * @license https://opensource.org/licenses/bsd-license.php BSD License
+ * @link http://phpmd.org/
+ */
+
+/**
+ * testDoesNotApplyToOtherUnaryOperatorsInFunction
+ *
+ * @return bool
+ */
+function testDoesNotApplyToOtherUnaryOperatorsInFunction()
+{
+    @$foo = is_dir(__DIR__);
+    $bar = !$foo;
+    ++$bar;
+    $baz = ++$bar;
+
+    return !--$baz;
+}