Most of this can be applied to any PHP project.
Automatically format PHP files #There are excellent paid services to enforce a coding standard, such as StyleCI, but you can also do this in your own project.
An excellent tool for this is PHP-CS-Fixer.
Let’s take a look at how to use it.
You can install the tool globally, but I recommend to install it into your project, so anybody working on the project can make use of it too.
You can install PHP-CS-Fixer with:composer require –dev friendsofphp/php-cs-fixerNext, you can configure it by creating a .
php_cs config file in the root of your project.
Here's the configuration that I use for my Laravel projects.
<?php$finder = SymfonyComponentFinderFinder::create() ->notPath('vendor') ->notPath('bootstrap') ->notPath('storage') ->in(__DIR__) ->name('*.
php') ->notName('*.
blade.
php');return PhpCsFixerConfig::create() ->setRules([ '@PSR2' => true, 'array_syntax' => ['syntax' => 'short'], 'ordered_imports' => ['sortAlgorithm' => 'alpha'], 'no_unused_imports' => true, ]) ->setFinder($finder);In the first statement of this configuration, we’re using Finder object to select some files.
We're going to exclude the vendor because otherwise composer would complain about changes in those files when we upgrade dependencies.
In a Laravel app, the bootstrap directory contains some autogenerated caches.
We aren't going to modify those.
The storage directory will remain untouched as well.
In every other directory, we are going to select files ending on .
php (except .
blade.
php files which are view templates).
The second statement contains what we are going to do with the selected files.
Our base will be the aforementioned PSR-2 code standard.
We’re also going to add some extra rules:any usage of array() will be converted to []all the imports will be sorted alphabeticallyall unused imports will be removed.
PHP-CS-Fixer comes with a bunch of additional rules.
Head over to the usage section of the package on GitHub to see all available rules.
When PHP-CS-Fixer runs it will create a temporary .
php_cs.
cache file.
You should add an entry to ignore this file in your .
gitignore.
You could run PHP-CS-Fixer like this:vendor/bin/php-cs-fixer fixI never run php-cs-fixer with the command above, but using a composer script called.
format.
Of course, you can name it whatever you want.
Using a Composer script has the added benefit that, if you should every change to another tool to auto-format your code, you can change the composer script and still run the same command embedded in your muscle memory.
Add this to your composer.
json file:"scripts": { "format": [ "vendor/bin/php-cs-fixer fix" ],}You can now run the fixer with:composer formatAnd now all your project files are formatted according to PSR-2 and the additional rules you specified.
Automatically format JavaScript, Vue and CSS files #Let’s also set up a tool for auto-formatting JavaScript files.
An excellent choice for this is Prettier.
You can install with yarn by runningyarn add prettier –dev –exactUsers of NPM can run this:npm install –save-dev –save-exact prettierPrettier can be configured by adding a .
prettierrc file in the root of your directory.
The docs contain a list of all available options.
Here is the configuration that I use for most projects.
{ "printWidth": 100, "singleQuote": true, "tabWidth": 4, "trailingComma": "es5"}In a typical project minified versions of your assets will be stored somewhere in your public directory.
You can let Prettier know it should not scan that directory by adding a .
prettierignore file in the root of your project with this content:public/vendor/In a Laravel project, all CSS and JavaScript is typically stored in the resources/assets directory.
To auto format those files you can run this command.
prettier –write 'resources/assets/**/*.
{css,js,vue}'You probably don’t want to type that command every time you need to auto format your files.
Let’s make running Prettier a tad easier by adding a script in the package.
json file.
"scripts": { "format": "prettier –write 'resources/assets/**/*.
{css,js,vue}' 'nova-components/**/*.
{css,js,vue}'",},With this in place you can run Prettier with:yarn formator with:npm run formatIn closing #PHP-CS-Fixer and Prettier can automatically format your code.
If you want to see an example of a Laravel project where both of these tools are being used, head over to the murze.
be repo on GitHub that contains the code that runs this very blog.
Happy formatting!.