nochso / phormat
PHP source formatter with a single style - essentially godoc for PHP
Installs: 7
Dependents: 0
Suggesters: 0
Security: 0
Stars: 4
Watchers: 2
Forks: 0
Open Issues: 1
Type:application
Requires
- php: ^5.6 || ^7.0
- aura/cli: ^2.1
- nette/finder: ^2.3
- nikic/php-parser: ^2.1.0
- nochso/diff: dev-master
- nochso/omni: ^0.3.7
- padraic/phar-updater: ^1.0
Requires (Dev)
- nochso/benchmark: ^0.5.3
- nochso/writeme: dev-master
- phpunit/phpunit: ^5.2
This package is not auto-updated.
Last update: 2024-11-23 20:26:07 UTC
README
Phormat formats PHP source code.
Differences to other fixers or PSR2:
- You can not influence the style, similar to gofmt.
- Tabs for indentation.
- Opening braces
{
on the same line:) {
- No extra whitespacy lines in code or comments.
- Use statements are always sorted.
- Optional re-arranging of class level elements.
- Fast. Check out the benchmarks.
- nochso/phormat
- Introduction, goals and scope
- Requirements
- Installation
- Usage
- Contributing
- Change log
- License
Introduction, goals and scope
Phormat is a pretty printer based on nikic/php-parser. It discards any formatting and prints source code in a uniform style. Custom formatting options are out of scope.
The chosen style is personal preference and attempts to keep the line count low while keeping the code readable.
You're anti-PSR! Why do you hate FIG?
I'm not. I don't. This is not a replacement, improvement or critique of PSR2 but merely an alternative you're free to ignore.
PSR2 is quite widespread for a reason and has helped lots of projects decide on a common style. However it does not mean everybody loves it personally or that it is a de-facto standard you must adhere to. The questions of tabs vs. spaces or placement of braces will always be part of a holy war as it comes down to personal preference.
In the end, it's best for collaboration if a project has a well defined style that is easy for contributors to adhere to. Which is easily possible for both PSR2 and phormat.
See php-cs-fixer for a great way to adhere to PSR2.
Requirements
This project is written for and tested with PHP 5.6, 7.0 and HHVM.
Installation
For end-users the PHAR version is preferred. To install it globally:
- Download the PHAR file from the latest release.
- Make it executable:
chmod +x phormat.phar
- Move it somewhere within your
PATH
:sudo cp phormat.phar /usr/local/bin/phormat
As local Composer development dependency per project:
composer require --dev nochso/phormat
As global Composer dependency:
composer global require nochso/phormat
Usage
As a local dependency php vendor/bin/phormat
or if installed globally just phormat
.
phormat [options] <path>
phormat [options] <path1> <path2> ...
By default PHP files from the specified paths will be overwritten. See the options below to override this behaviour.
If path is a folder it will be searched recursively for files ending with
*.php
.
Native PHP templates will be skipped to avoid messing up their formatting.
Templates are detected by looking for alternative syntax for control structures
like if (true): .. endif;
Command line options
Arguments
<paths>
One or many paths to files or directories.
Options
-d, --diff
Preview diff of formatted code. Implies --no-output.
-s, --summary
Show a status summary for each file.
-o, --order
Change order of class elements:
constants > properties > methods
static > abstract > *
public > protected > private
__* > has* > is* > get* > set* > add* > remove* > enable* > disable* > *
-p, --print
Print full output of formatted code. Implies --no-output.
-n, --no-output
Do not overwrite source files.
-h, --help
Show this help.
--version
Show version information.
--self-update
Update phormat to the latest version.
Contributing
Feedback, bug reports and pull requests are always welcome.
Please read the contributing guide for instructions.
Change log
See CHANGELOG.md for the full history of changes between releases.
[Unreleased]
Changed
- Improved line wrapping: Use a soft limit of 100 characters for lines made of
.
,||
and&&
.
[0.1.5] - 2016-04-23
Changed
- Allow self-update without public key.
[0.1.4] - 2016-04-23
Added
- Show warnings when xdebug or xdebug-profiling is enabled.
Changed
- Put closing parenthesis of multiple lines on a new line.
- Use statements are always sorted.
- Separate classes, interfaces and traits.
- Keep use and group-use statements together.
License
This project is released under the MIT license. See LICENSE.md for the full text.