dusterio / prettyhp
PrettyHP is an opinionated PHP code formatter
Requires
- php: >=5.5.0
- nikic/php-parser: ^3.0
- symfony/console: ^3.3
Requires (Dev)
- codeclimate/php-test-reporter: dev-master
- phpunit/phpunit: 3.7.*
This package is auto-updated.
Last update: 2024-10-28 07:20:00 UTC
README
PrettyHP is an opinionated PHP code formatter
It removes all original styling and ensures that all outputted code conforms to a consistent style.
PrettyHP will try to comply with PSR as much as possible.
Inspired by JavaScript's prettier
But why?
Your IDE or editor may already have some basic formatting built-in, but:
- At least PhpStorm cannot re-format code automatically before committing to VCS;
- Different team members may have different editors, views and standards;
- At least PhpStorm doesn't really enforce styling, it just does some basic indenting.
Why not use existing PHP code formatters?
phpfmt
phpfmt is officially closed, the repo is deleted by the authors.
php-cs-fixer
I'm a very experienced developer and Linux user, yet I couldn't get it up and running in 10+ minutes. Something is just wrong about it. Since the tool's verbose mode is not implemented, I couldn't debug it any further.
Installation
$ composer require --dev dusterio/prettyhp
We recommend to add a pre-commit Git hook so that any modified PHP files are prettified right before the commit:
$ cat .git/hooks/pre-commit git diff --staged --diff-filter=dx --name-only HEAD | grep ".*\.php$" | xargs -I % sh -c 'vendor/bin/prettyhp format %; git add %'
Manual usage
PrettyHP is meant for PSR 4 compliant files – one file should contain one PHP class.
$ vendor/bin/prettyhp [filename]