123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297 |
- <?php
- /**
- * $Id: PHPMDTask.php 905 2010-10-05 16:28:03Z mrook $
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
- * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
- * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
- * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
- * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
- * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
- * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
- * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
- * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
- * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * This software consists of voluntary contributions made by many individuals
- * and is licensed under the LGPL. For more information please see
- * <http://phing.info>.
- */
- require_once 'phing/Task.php';
- /**
- * Runs PHP Mess Detector. Checking PHP files for several potential problems
- * based on rulesets.
- *
- * @package phing.tasks.ext.phpmd
- * @author Benjamin Schultz <bschultz@proqrent.de>
- * @version $Id: PHPMDTask.php 905 2010-10-05 16:28:03Z mrook $
- * @since 2.4.1
- */
- class PHPMDTask extends Task
- {
- /**
- * A php source code filename or directory
- *
- * @var PhingFile
- */
- protected $file = null;
- /**
- * All fileset objects assigned to this task
- *
- * @var array<FileSet>
- */
- protected $filesets = array();
- /**
- * The rule-set filenames or identifier.
- *
- * @var string
- */
- protected $rulesets = 'codesize,unusedcode';
- /**
- * The minimum priority for rules to load.
- *
- * @var integer
- */
- protected $minimumPriority = 5;
- /**
- * List of valid file extensions for analyzed files.
- *
- * @var array
- */
- protected $allowedFileExtensions = array('php');
- /**
- * List of exclude directory patterns.
- *
- * @var array
- */
- protected $ignorePatterns = array('.git', '.svn', 'CVS', '.bzr', '.hg');
- /**
- * The format for the report
- *
- * @var string
- */
- protected $format = 'text';
- /**
- * Formatter elements.
- *
- * @var array<PHPMDFormatterElement>
- */
- protected $formatters = array();
- /**
- * Load the necessary environment for running PHPMD.
- *
- * @throws BuildException - if the phpmd classes can't be loaded.
- */
- public function init()
- {
- /**
- * Determine PHPMD version number
- */
- @include_once 'PHP/PMD.php';
- if (! class_exists('PHP_PMD')) {
- throw new BuildException(
- 'PHPMDTask depends on PHPMD being installed and on include_path.',
- $this->getLocation()
- );
- }
- /*$version = PHP_PMD::VERSION;
- if (version_compare($version, '0.2.1') < 0) {
- throw new BuildException(
- "PHPMDTask requires PHPMD version >= 0.2.1",
- $this->getLocation()
- );
- }*/
- /**
- * Other dependencies that should only be loaded when class is actually used.
- */
- require_once 'phing/tasks/ext/phpmd/PHPMDFormatterElement.php';
- require_once 'PHP/PMD/AbstractRule.php';
- $this->minimumPriority = PHP_PMD_AbstractRule::LOWEST_PRIORITY;
- }
- /**
- * Set the input source file or directory.
- *
- * @param PhingFile $file The input source file or directory.
- *
- * @return void
- */
- public function setFile(PhingFile $file)
- {
- $this->file = $file;
- }
- /**
- * Nested creator, adds a set of files (nested fileset attribute).
- *
- * @return FileSet The created fileset object
- */
- public function createFileSet()
- {
- $num = array_push($this->filesets, new FileSet());
- return $this->filesets[$num-1];
- }
- /**
- * Sets the minimum rule priority.
- *
- * @param integer $minimumPriority Minimum rule priority.
- *
- * @return void
- */
- public function setMinimumPriority($minimumPriority)
- {
- $this->minimumPriority = $minimumPriority;
- }
- /**
- * Sets the rule-sets.
- *
- * @param string $ruleSetFileNames Comma-separated string of rule-set filenames
- * or identifier.
- *
- * @return void
- */
- public function setRulesets($ruleSetFileNames)
- {
- $this->rulesets = $ruleSetFileNames;
- }
- /**
- * Sets a list of filename extensions for valid php source code files.
- *
- * @param string $fileExtensions List of valid file extensions without leading dot.
- *
- * @return void
- */
- public function setAllowedFileExtensions($fileExtensions)
- {
- $this->allowedFileExtensions = array();
- $token = ' ,;';
- $ext = strtok($fileExtensions, $token);
- while ($ext !== false) {
- $this->allowedFileExtensions[] = $ext;
- $ext = strtok($token);
- }
- }
- /**
- * Sets a list of ignore patterns that is used to exclude directories from
- * the source analysis.
- *
- * @param string $ignorePatterns List of ignore patterns.
- *
- * @return void
- */
- public function setIgnorePatterns($ignorePatterns)
- {
- $this->ignorePatterns = array();
- $token = ' ,;';
- $pattern = strtok($ignorePatterns, $token);
- while ($pattern !== false) {
- $this->ignorePatterns[] = $pattern;
- $pattern = strtok($token);
- }
- }
- /**
- * Create object for nested formatter element.
- *
- * @return PHPMDFormatterElement
- */
- public function createFormatter()
- {
- $num = array_push($this->formatters, new PHPMDFormatterElement($this));
- return $this->formatters[$num-1];
- }
- /**
- * Executes PHPMD against PhingFile or a FileSet
- *
- * @return void
- */
- public function main()
- {
- if (!isset($this->file) and count($this->filesets) == 0) {
- throw new BuildException("Missing either a nested fileset or attribute 'file' set");
- }
- if (count($this->formatters) == 0) {
- // turn legacy format attribute into formatter
- $fmt = new PHPMDFormatterElement();
- $fmt->setType($this->format);
- $fmt->setUseFile(false);
- $this->formatters[] = $fmt;
- }
- $reportRenderers = array();
- foreach ($this->formatters as $fe) {
- if ($fe->getType() == '') {
- throw new BuildException("Formatter missing required 'type' attribute.");
- }
- if ($fe->getUsefile() && $fe->getOutfile() === null) {
- throw new BuildException("Formatter requires 'outfile' attribute when 'useFile' is true.");
- }
- $reportRenderers[] = $fe->getRenderer();
- }
- // Create a rule set factory
- $ruleSetFactory = new PHP_PMD_RuleSetFactory();
- $ruleSetFactory->setMinimumPriority($this->minimumPriority);
- $phpmd = new PHP_PMD();
- $phpmd->setFileExtensions($this->allowedFileExtensions);
- $phpmd->setIgnorePattern($this->ignorePatterns);
- $filesToParse = array();
- if ($this->file instanceof PhingFile) {
- $filesToParse[] = $this->file->getPath();
- } else {
- // append any files in filesets
- foreach ($this->filesets as $fs) {
- $files = $fs->getDirectoryScanner($this->project)->getIncludedFiles();
- foreach ($files as $filename) {
- $f = new PhingFile($fs->getDir($this->project), $filename);
- $filesToParse[] = $f->getAbsolutePath();
- }
- }
- }
- $inputPath = implode(',', $filesToParse);
- $this->log('Processing files...');
- $phpmd->processFiles(
- $inputPath,
- $this->rulesets,
- $reportRenderers,
- $ruleSetFactory
- );
- $this->log('Finished processing files');
- }
- }
|