coc-php-cs-fixer

PHP CS Fixer (PHP Coding Standards Fixer) and Laravel Pint extension for coc.nvim

Install

:CocInstall coc-php-cs-fixer

Features

php-cs-fixer and laravel/pint are supported.

- Formatter
- Command
- Code Action
- Status Bar
- pint.json Auto Completion and JSON validation
- Downloader

Note

The formatter tool used is php-cs-fixer by default. If you want to use laravel/pint, change the php-cs-fixer.activateTool setting in coc-settings.json.

``json
{
"php-cs-fixer.activateTool": "pint"
}
`

- DEMO

---

Detects the php-cs-fixer or pint tool. They are prioritized in order from the top.

1. php-cs-fixer.toolPath or php-cs-fixer.pint.toolPath
1. vendor/bin/php-cs-fixer or vendor/bin/pint
1. php-cs-fixer or pint retrieved by the download feature (:CocCommand php-cs-fixer.download or php-cs-fixer.pintDownload)
- php-cs-fixer:
- Mac/Linux: ~/.config/coc/extensions/coc-php-cs-fixer-data/php-cs-fixer
- Windows: ~/AppData/Local/coc/extensions/coc-php-cs-fixer-data/php-cs-fixer
- pint:
- Mac/Linux: ~/.config/coc/extensions/coc-php-cs-fixer-data/pint
- Windows: ~/AppData/Local/coc/extensions/coc-php-cs-fixer-data/pint

If "1" and "2" above are not detected, the download feature will be executed (The prompt will be displayed)

Usage

coc-php-cs-fixer can be executed in multiple ways.

$3

Add the settings to coc-settings.json.

`jsonc
{
"[php]": {
"coc.preferences.formatOnSave": true
},
}
`

If the file size is large or the tool (php-cs-fixer or pint) is slow in your environment, formatting may not work properly when saving. In coc.nvim, time-consuming formatting on save is canceled.

In that case, please perform the formatting in another way.

$3

- If the php-cs-fixer.activateTool setting is php-cs-fixer
- :CocCommand php-cs-fixer.fix
- If the php-cs-fixer.activateTool setting is pint
- :CocCommand php-cs-fixer.pintFix

$3

- :call CocAction('format')

$3

- :call CocAction('codeAction')
- If the php-cs-fixer.activateTool setting is php-cs-fixer
- Choose action: "Run: php-cs-fixer.fix"
- If the php-cs-fixer.activateTool setting is pint
- Choose action: "Run: php-cs-fixer.pintFix"

Precedence of "php-cs-fixer" and "laravel/pint" configuration files and options

$3

1. php-cs-fixer.config setting for this extension.
2. .php-cs-fixer.php or .php-cs-fixer.dist.php config file in the workspace (project) root.
3. options-reated settings for this extension. e.g. php-cs-fixer.rules and more.

$3

1. php-cs-fixer.pint.config setting for this extension.
2. pint.json config file in the workspace (project) root.
3. options-reated settings for this extension. php-cs-fixer.pint.preset.

Configuration options

- php-cs-fixer.enable: Enable coc-php-cs-fixer extension, default: true
- php-cs-fixer.activateTool: Formatter tool to be used, valid option ["php-cs-fixer", "pint"], default: "php-cs-fixer"
- php-cs-fixer.toolPath: The path to the php-cs-fixer tool, default: ""
- php-cs-fixer.config: Path to php-cs-fixer config file (--config), default: ""
- php-cs-fixer.useCache: Use a cache file when fixing files (--using-cache), default: false
- php-cs-fixer.allowRisky: Determines whether risky rules are allowed (--allow-risky), default: false
- php-cs-fixer.rules: Rules to use when fixing files (--rules), e.g. "@PSR12,@Symfony", default: "@PSR12"
- php-cs-fixer.enableIgnoreEnv: Add the environment variable PHP_CS_FIXER_IGNORE_ENV=1 and run php-cs-fixer, default: false
- php-cs-fixer.pint.toolPath: The path to the pint tool, default: ""
- php-cs-fixer.pint.config: Path to pint.json config file (--config), default: ""
- php-cs-fixer.pint.preset: Presets define a set of rules that can be used to fix code style issues in your code (--preset), valid option ["laravel", "psr12", "symfony"], default: "laravel"
- php-cs-fixer.downloadCheckOnStartup: If php-cs-fixer or pint is not present at startup, run the built-in download. The tool to be downloaded will follow the php-cs-fixer.activateTool configuration, default: true
- php-cs-fixer.downloadMajorVersion: Specify the major version of php-cs-fixer to download for the extension, valid option [2, 3], default: 3
- php-cs-fixer.enableFormatProvider: Enable format provider, default: true
- php-cs-fixer.enableActionProvider: Enable codeAction provider, default: true
- php-cs-fixer.terminal.enableSplitRight: Use vertical belowright for dryRunDiff and pintTest terminal window, default: false

Commands

- php-cs-fixer.fix: Run php-cs-fixer fix
- php-cs-fixer.dryRunDiff: Run php-cs-fixer fix with --dry-run and --diff in a terminal window | DEMO
- php-cs-fixer.pintFix: Run pint
- php-cs-fixer.pintTest: Run pint with --test in a terminal window | DEMO
- php-cs-fixer.download: Download php-cs-fixer
- By default, the "v3" series will be downloaded. If you want to download "v2" series, please change the php-cs-fixer.downloadMajorVersion setting.
- php-cs-fixer.pintDownload: Download pint
- php-cs-fixer.showOutput: Show php-cs-fixer output channel

Code Actions

- Run: php-cs-fixer.fix
- Run: php-cs-fixer.pintFix`

Thanks

-
-
-
-

License

MIT

---

> This extension is built with create-coc-extension