Coc-phpfmt NPM

coc-phpfmt

phpfmt extension for coc.nvim. Forked from vscode-phpfmt

Install

:CocInstall coc-phpfmt

Commands

name	description
phpfmt.listTransformations	phpfmt: List Transformations
phpfmt.openOutput	phpfmt: Open Output

Q&A

Q: How to use phpfmt.php_bin with spaces such as C:\Program Files\php\php.exe ? A: Wrap your path with quotes like:

{
  "phpfmt.php_bin": "\"C:\\Program Files\\php\\php.exe\""
}

It is recommended to add the directory of the php.exe to the PATH environment variable on Windows. If it still not working, refer to #1 and Stack Overflow Related.

Q: How use tabs instead of spaces with PSR2 enabled ? A: For PSR2, code MUST use 4 spaces for indenting, not tabs. But if you like PSR2, and do not like 4 spaces for indentation, add following configuration:

{
  "phpfmt.passes": [
    "PSR2KeywordsLowerCase",
    "PSR2LnAfterNamespace",
    "PSR2CurlyOpenNextLine",
    "PSR2ModifierVisibilityStaticOrder",
    "PSR2SingleEmptyLineAndStripClosingTag",
    "ReindentSwitchBlocks"
  ],
  "phpfmt.exclude": ["ReindentComments", "StripNewlineWithinClassBody"],
  "phpfmt.psr2": false
}

Q: Is fmt.phar (phpfmt itself) still maintained ? A: Since phpfmt has no maintainers, only Serious bugs will be fixed.

Configuration

Key	Type	Description	Default
phpfmt.php_bin	`string`	php executable path	"php"
phpfmt.detect_indent	`boolean`	auto detecting indent type and size (will ignore indent_with_space)	false
phpfmt.psr1	`boolean`	activate PSR1 style	false
phpfmt.psr1_naming	`boolean`	activate PSR1 style - Section 3 and 4.3 - Class and method names case.	false
phpfmt.psr2	`boolean`	activate PSR2 style	true
phpfmt.indent_with_space	`integer \\| boolean`	use spaces instead of tabs for indentation. Default 4	4
phpfmt.enable_auto_align	`boolean`	enable auto align of ST_EQUAL and T_DOUBLE_ARROW	false
phpfmt.visibility_order	`boolean`	fixes visibiliy order for method in classes - PSR-2 4.2	false
phpfmt.passes	`array`	call specific compiler pass	[]
phpfmt.exclude	`array`	disable specific passes	[]
phpfmt.smart_linebreak_after_curly	`boolean`	convert multistatement blocks into multiline blocks	false
phpfmt.yoda	`boolean`	yoda-style comparisons	false
phpfmt.cakephp	`boolean`	Apply CakePHP coding style	false
phpfmt.custom_arguments	`string`	provide custom arguments to overwrite default arguments generated by config	""

Supported Transformations

Key	Description
AddMissingParentheses	Add extra parentheses in new instantiations.
AliasToMaster	Replace function aliases to their masters - only basic syntax alias.
AlignConstVisibilityEquals	Vertically align "=" of visibility and const blocks.
AlignDoubleArrow	Vertically align T_DOUBLE_ARROW (=>).
AlignDoubleSlashComments	Vertically align "//" comments.
AlignEquals	Vertically align "=".
AlignGroupDoubleArrow	Vertically align T_DOUBLE_ARROW (=>) by line groups.
AlignPHPCode	Align PHP code within HTML block.
AlignTypehint	Vertically align function type hints.
AllmanStyleBraces	Transform all curly braces into Allman-style.
AutoPreincrement	Automatically convert postincrement to preincrement.
AutoSemicolon	Add semicolons in statements ends.
CakePHPStyle	Applies CakePHP Coding Style
ClassToSelf	"self" is preferred within class, trait or interface.
ClassToStatic	"static" is preferred within class, trait or interface.
ConvertOpenTagWithEcho	Convert from "<?=" to "<?php echo ".
DocBlockToComment	Replace docblocks with regular comments when used in non structural elements.
DoubleToSingleQuote	Convert from double to single quotes.
EchoToPrint	Convert from T_ECHO to print.
EncapsulateNamespaces	Encapsulate namespaces with curly braces
GeneratePHPDoc	Automatically generates PHPDoc blocks
IndentTernaryConditions	Applies indentation to ternary conditions.
JoinToImplode	Replace implode() alias (join() -> implode()).
LeftWordWrap	Word wrap at 80 columns - left justify.
LongArray	Convert short to long arrays.
MergeElseIf	Merge if with else.
SplitElseIf	Merge if with else.
MergeNamespaceWithOpenTag	Ensure there is no more than one linebreak before namespace
MildAutoPreincrement	Automatically convert postincrement to preincrement. (Deprecated pass. Use AutoPreincrement instead).
NewLineBeforeReturn	Add an empty line before T_RETURN.
OrganizeClass	Organize class, interface and trait structure.
OrderAndRemoveUseClauses	Order use block and remove unused imports.
OnlyOrderUseClauses	Order use block - do not remove unused imports.
OrderMethod	Organize class, interface and trait structure.
OrderMethodAndVisibility	Organize class, interface and trait structure.
PHPDocTypesToFunctionTypehint	Read variable types from PHPDoc blocks and add them in function signatures.
PrettyPrintDocBlocks	Prettify Doc Blocks
PSR2EmptyFunction	Merges in the same line of function header the body of empty functions.
PSR2MultilineFunctionParams	Break function parameters into multiple lines.
ReindentAndAlignObjOps	Align object operators.
ReindentSwitchBlocks	Reindent one level deeper the content of switch blocks.
RemoveIncludeParentheses	Remove parentheses from include declarations.
RemoveSemicolonAfterCurly	Remove semicolon after closing curly brace.
RemoveUseLeadingSlash	Remove leading slash in T_USE imports.
ReplaceBooleanAndOr	Convert from "and"/"or" to "&&"/"	Danger! This pass leads to behavior change.
ReplaceIsNull	Replace is_null($a) with null === $a.
RestoreComments	Revert any formatting of comments content.
ReturnNull	Simplify empty returns.
ShortArray	Convert old array into new array. (array() -> [])
SmartLnAfterCurlyOpen	Add line break when implicit curly block is added.
SortUseNameSpace	Organize use clauses by length and alphabetic order.
SpaceAroundControlStructures	Add space around control structures.
SpaceAfterExclamationMark	Add space after exclamation mark.
SpaceAroundExclamationMark	Add spaces around exclamation mark.
SpaceAroundParentheses	Add spaces inside parentheses.
SpaceBetweenMethods	Put space between methods.
StrictBehavior	Activate strict option in array_search, base64_decode, in_array, array_keys, mb_detect_encoding. Danger! This pass leads to behavior change.
StrictComparison	All comparisons are converted to strict. Danger! This pass leads to behavior change.
StripExtraCommaInArray	Remove trailing commas within array blocks
StripNewlineAfterClassOpen	Strip empty lines after class opening curly brace.
StripNewlineAfterCurlyOpen	Strip empty lines after opening curly brace.
StripNewlineWithinClassBody	Strip empty lines after class opening curly brace.
StripSpaces	Remove all empty spaces
StripSpaceWithinControlStructures	Strip empty lines within control structures.
TightConcat	Ensure string concatenation does not have spaces, except when close to numbers.
TrimSpaceBeforeSemicolon	Remove empty lines before semi-colon.
UpgradeToPreg	Upgrade ereg* calls to preg*
WordWrap	Word wrap at 80 columns.
WrongConstructorName	Update old constructor names into new ones. http://php.net/manual/en/language.oop5.decon.php
YodaComparisons	Execute Yoda Comparisons.

License

MIT

This extension is built with create-coc-extension

coc.nvim

@everything-registry/sub-chunk-1347

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago