Add license sniff and fixes

[geerteltink]

The test are executed independent of the standard AbstractSniffUnitTest class. That class is only available if PHP_CodeSniffer is downloaded by composer with prefer-source.

Copyright year detection:

• [x] Detect current copyright year from LICENSE.md and/or COPYRIGHT.md
• [x] Detect current copyright year from all source files
• [x] Globally exclude /TestAssets/

Violation detection (when running phpcs):

• [x] Check file-level docblock
• [x] Check missing/invalid see tag
• [x] Check missing/invalid copyright tag
• [x] Check missing/invalid license tag
• [x] Check order of see, copyright and license tags
• [x] Check for current copyright year in LICENSE.md and COPYRIGHT.md
• [x] Check text in LICENSE.md and COPYRIGHT.md to make sure it's consistence in all components

Fixes (when running phpcbf):

• [x] Create missing LICENSE.md and/or COPYRIGHT.md
• [x] Use the detected copyright year in LICENSE.md and COPYRIGHT.md
• [x] Fix invalid see tag
• [x] Fix invalid copyright tag
• [x] Fix invalid license tag
• [x] Update copyright in LICENSE.md and COPYRIGHT.md to the current year
• [x] Update the entire text in LICENSE.md and COPYRIGHT.md for consistency
• [x] Fix missing newline after comment

TODO:

• [ ] Fix tests
• [ ] Test on zendframework components
  • [ ] zend-expressive
  • [ ] zend-code
  • [ ] zend-expressive-tooling
  • [ ] zend-mvc
  • [ ] zend-http

Discussion:

• [x] Is the text for COPYRIGHT.md correct?
• [x] Is the text for LICENSE.md correct?
• [ ] How to include the ruleset in components?
  1. <rule ref="vendor/zendframework/zend-coding-standard/ruleset.xml"/>
  2. <rule ref="vendor/zendframework/zend-coding-standard/src/ZendCodingStandard/ruleset.xml"/> The first is like a wrapper and loads the second one anyway.

[geerteltink]

@weierophinney There is an inconsistency in the copyright line in the license files throughout the components:

Copyright (c) 2015-2016, Zend Technologies USA, Inc. All rights reserved.

Vs

Copyright (c) 2015-2016, Zend Technologies USA, Inc.

All rights reserved.

Also I've tested this against zend-expressive and all source code files are updated as expected. I've only found some issues with updating the copyright date which needs to be fixed.

[geerteltink]

@weierophinney I've ironed out the issues. The dates in COPYING and LICENSE are now updated correctly. And the text in those files are now forced to be the same as the default so we get consistency between all components. So far I've tested zend-expressive and zend-code. In 14 seconds it updated all source files and created COPYING.md.

I've ran into another consistency issue.

Expressive:

/**
 * @see       https://github.com/zendframework/zend-expressive for the canonical source repository
 * @copyright https://github.com/zendframework/zend-expressive/blob/master/COPYING.md Copyright
 * @license   https://github.com/zendframework/zend-expressive/blob/master/LICENSE.md New BSD License
 */

zend-code:

/**
 * Zend Framework (http://framework.zend.com/)
 *
 * @link      http://github.com/zendframework/zf2 for the canonical source repository
 * @copyright Copyright (c) 2005-2016 Zend Technologies USA Inc. (http://www.zend.com)
 * @license   http://framework.zend.com/license/new-bsd New BSD License
 */

Specifically the extra text and @see Vs @link. This can be fixed as well, but I need to know what the preferred format should be.

EDIT: According to PSR-5 PHPDoc (if it ever gets released), @link is deprecated. I'll enforce the @see tag.

[geerteltink]

• Updated to php_codesniffer 3
• Simplified detection of LICENSE.md and COPYRIGHT.md (no dummy files needed anymore)
• LICENSE.md and COPYRIGHT.md sniffs are now optional.

Example phpcs.xml config file in a component:

<?xml version="1.0"?>
<ruleset name="Zend Framework Coding Standard">
    <!-- Load ruleset -->
    <rule ref="./vendor/zendframework/zend-coding-standard/src/ZendCodingStandard/ruleset.xml"/>

    <!-- Check copyright and license files -->
    <file>./COPYRIGHT.md</file>
    <file>./LICENSE.md</file>
    <!-- Paths to check -->
    <file>./src</file>
    <file>./test</file>

    <!-- Exclude test assets -->
    <exclude-pattern>*/TestAsset/*</exclude-pattern>
</ruleset>

/cc @weierophinney

[geerteltink]

Superseded by #4