php-fmt is an in-progress code formatter built on top of php-parser, which builds an AST (abstract-syntax-tree) for PHP code.

As opposed to other parsers, which fix formatting mistakes, php-fmt establishes one true format. That is, given equivalent code with any formatting whatsoever, php-fmt will return the exact same result, and is idempotent. As a result, it should also be theoretically impossible for it to create incorrect/invalid PHP.

It may at some point be customizable, but the goal is for it to be somewhat opinionated, and not necessarily in-line with PSR-N, whose exact formatting opinions I'm not a fan of. Not to mention, PSR-N leave wiggle room for exact formats in certain areas, whereas php-fmt will spit out all code exactly the same way, which leaves no room for fuzzy or optional formatting decisions.

<?php
 class Foo extends Bar {private function hello() {/* a comment */ $foo = 1; return $foo;}}
 function do_a_thing($with_some_really_really_really_long, $arguments_that_are_way_too_long_for_anybody_to_enjoy, $seriously_guys) {return 'foo';}

<?php

class Foo extends Bar {

    private function hello() {
        /* a comment */
        $foo = 1;
        return $foo;
    }

}

function do_a_thing(
    $with_some_really_really_really_long,
    $arguments_that_are_way_too_long_for_anybody_to_enjoy,
    $seriously_guys
) {
    return 'foo';
}

• Comments have some degenerate cases where they can end up in odd places, or if they are the last thing in a file will be removed entirely.
• Other than that, we're pretty close to a sane initial release