From 255d2db803e5bd8769b8eefcf69cc96875e36373 Mon Sep 17 00:00:00 2001 From: Perreal Guillaume <guillaume.perreal@irstea.fr> Date: Tue, 19 Mar 2019 17:15:02 +0100 Subject: [PATCH] Added a README.md. --- README.md | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..bbcd1e4 --- /dev/null +++ b/README.md @@ -0,0 +1,54 @@ +# irstea/php-cs-fixer-config + +Configuration pour [PHP-CS-Fixer](https://cs.symfony.com/). + +### Installation + +```shell +composer require --dev irstea/php-cs-fixer-config +``` + +### Configuration + +La configuration se fait dans un fichier `.php_cs.dist` comme avec PHP-CS-Fixer, mais en utilisant la classe `Irstea\CS\Config`. + +Exemple : + +```php +<?php + +$finder = PhpCsFixer\Finder::create() + ->exclude('vendor') + ->exclude('var') + ->files() + ->name('*.php') + ->in('.'); + +return Irstea\CS\Config::create() + ->setIndent(' ') + ->setLineEnding("\n") + ->setFinder($finder); +``` + +Pour plus de détails, cf. https://cs.symfony.com/#usage + +Un modèle d'en-tête (cf. règle `header_comment`) peut être défini dans un fichier `.docheader`. Les tags `%package%` et `%yearRange%` sont remplacés automatiquement à partir des informations du dépôt git et de `composer.json`. + +Exemple : + +``` +This file is part of "%package%". +(c) %yearRange% Irstea <dsi.poleis@irstea.fr> + +For the full copyright and license information, please view the LICENSE +file that was distributed with this source code. +``` + + +### Usage + +```shell +vendor/bin/php-cs-fixer fix +``` + +cf. https://cs.symfony.com/#usage -- GitLab