Download the PHP package nexusphp/cs-config without Composer
On this page you can find all versions of the php package nexusphp/cs-config. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download nexusphp/cs-config
More information about nexusphp/cs-config
Files in nexusphp/cs-config
Package cs-config
Short Description A factory for custom rulesets for PHP CS Fixer.
License MIT
Informations about the package cs-config
Nexus CS Config
This library provides a factory for custom rulesets for friendsofphp/php-cs-fixer
.
Installation
You can add this library as a local, per-project dependency to your project using Composer:
composer require nexusphp/cs-config
If you only need this library during development, for instance to run your project's test suite, then you should add it as a development-time dependency:
composer require --dev nexusphp/cs-config
Configuration
-
Create a
.php-cs-fixer.dist.php
at the root of your project: - Include the cache file in your
.gitignore
. By default, the cache file will be saved in the project root.
Advanced Configuration
Adding Preformatted License Header
You can create a preformatted license header to all PHP files by using the public forLibrary()
method
instead of forProjects()
. This method accepts two required arguments (the library name and author) and
two optional arguments (the email address and starting year of license).
- Scenario 1: Providing all arguments
This setting will configure a license header similar to below:
- Scenario 2: Providing only the required arguments
If you opted not to provide any of the optional arguments (i.e., email address, starting license year), these will not be shown on the license header allowing flexibility on the copyright portion.
This will give the following license header:
Overriding Rules in a Ruleset
If you feel that a specific rule in the ruleset is not appropriate for you, you can override it instead of creating a new ruleset:
Specifying Options to PhpCsFixer\Config
The Factory
class returns an instance of PhpCsFixer\Config
and fully supports all of
its properties setup. You can pass an array to the third parameter of Factory::create()
containing your desired options.
Options
Key | Allowed Types | Default |
---|---|---|
cacheFile | string |
.php-cs-fixer.cache |
customFixers | FixerInterface[], iterable, \Traversable |
[] |
finder | iterable, string[], \Traversable |
default PhpCsFixer\Finder instance |
format | string |
txt |
hideProgress | bool |
false |
indent | string |
' ' // 4 spaces |
lineEnding | string |
"\n" |
phpExecutable | null, string |
null |
isRiskyAllowed | bool |
false |
usingCache | bool |
true |
customRules | array |
[] |
Customization of Ruleset
What is the purpose of a configuration factory if not able to create a custom ruleset for an organization-wide usage, right? Well, you are not constrained to use the default rulesets and putting a long array of overrides. That's pretty nasty.
The way to achieve this is dependent on you but the main idea is creating a new ruleset that
extends Nexus\CsConfig\Ruleset\AbstractRuleset
. Yup, it's that easy. Then you just need to
provide details for its required four (4) protected properties.
Then, in creating your .php-cs-fixer.dist.php
, use your own ruleset.
Credits
This project is inspired by and an enhancement of ergebnis/php-cs-fixer-config
.
Contributing
Contributions are very much welcome. If you see an improvement or bugfix, open a PR now!