PhpStorm helper

Scripts to set-up PhpStorm with shared configuration.

Why?

Each of us like to customise our developer experience – shortcuts, layout and other tremendously important things like color schemes. But some of the configuration is usually best to be shared with other team members:

customized code style, inspections, generated code templates;
directories configured by project's structure;
correct SQL dialect;
some plugins enabled for the project;
PHP interpreter as docker with correct image;
integration with any quality control tools;
external tools available to run;
configuration for servers to allow debugging;
some common plugins to be installed.

This allows more consistency in your team and avoids configuring everything for each member separately.

There is Settings repository feature in PhpStorm, but it does not synchronize most of such things, and it does synchronize some stuff that's supposed to be private (like color scheme).

There are also three different places where this configuration should be changed:

in .idea folder – files, that can be versioned. This library helps to make initial configuration easier;
in .idea folder, but in file, which should not be versioned. This requires script to be ran in each machine to modify that file;
in global PhpStorm configuration files – installed plugins and external tools. These are shared for all projects.

Installation

As a library, if you want to reuse PHP code in your own scripts:

composer require paysera/util-phpstorm-helper

As executable:

clone repository;
run ./php-storm-helper --help

You can also install library as global composer dependency:

composer global require paysera/util-phpstorm-helper

# add composer bin directory to PATH – this example is just for this session
PATH=$PATH:`composer global config bin-dir --absolute`

php-storm-helper --help

Usage

TL;DR;

Once:

php-storm-helper set-up-global-configuration

If you have, remove .idea from global gitignore file.

For each project, after project was opened by PhpStorm at least once:

php-storm-helper set-up-configuration
php-storm-helper configure-composer
php-storm-helper set-up-server project-url-address.docker:80 /project-path-inside/container

Commands

There are four commands that can be executed for three different use-cases:

setting up versioned configuration files. This requires structure of template files to use. Library provides the defaults used for repositories made by Paysera – feel free to use those or customise with your own;
two for setting up servers (for debugging support) and configuring composer settings. These are done in workspace.xml file, which cannot be versioned;
configuring external tools and installing common plugins.

Setting up versioned configuration files

php-storm-helper set-up-configuration [project-root-dir] [path-to-configuration-template-structure]

Features of default configuration:

customized code style and generated code templates to be compatible with Paysera style guide;
customized inspections – some disabled, some optional ones enabled;
MariaDB SQL dialect;
Symfony plugin enabled for the project;
service names for Symfony service generation follows the conventions;
directories are marked as they should:
- vendor directories not added as Git roots – no git update is called for libraries after Project update;
- generated files are marked as excluded – you won't see duplicated find results;
- configuration for vendors – vendors are excluded, but inside include path. This makes Scopes with following configuration:
  - Project Files (or In Project) – vendors are not included;
  - Project and Libraries – vendors are included. Choose Scope → Project and Libraries when searching;
PHP interpreter as docker with correct image. This allows to run unit tests using PhpStorm integration in the right environment;
php-cs-fixer integration – if something's wrong, it will be marked as Weak Warning.

Some features require additional options or already existing files (like .php_cs) in current directory. Run with --help for more information.

Setting up servers

php-storm-helper set-up-server host-with-port remote-root [project-root-dir]

For example:

php-storm-helper set-up-server my-project.docker:443 /project

Configuring composer

php-storm-helper configure-composer [project-root-dir]

Configuring external tools and installing plugins

php-storm-helper set-up-global-configuration [path-to-config-file]

path-to-config-file is path to php configuration file, which has the following structure:

<?php
declare(strict_types=1);

use Paysera\PhpStormHelper\Entity\ExternalToolConfiguration;
use Paysera\PhpStormHelper\Entity\GlobalConfiguration;

return (new GlobalConfiguration())

    ->setExternalToolConfigurations([
        (new ExternalToolConfiguration())
            ->setName('Fix CS (debug)')
            ->setCommand('bin/php-cs-fixer')
            ->setParameters('fix --diff --verbose --config=$ProjectFileDir$/.php_cs --dry-run "$FilePath$"')
            ->setSynchronizationRequired(false)
            ->setConsoleShownAlways(true),
    ])
    
    // copy direct links from plugin pages, for example https://plugins.jetbrains.com/plugin/7219-symfony-plugin
    // versions will get old, but prompt will appear to update the plugin
    // if plugin by that name already exists, no action will be taken
    ->setPlugins([
        'https://plugins.jetbrains.com/files/7219/59728/Symfony_Plugin-0.17.171.zip',
    ])
;

Alternatively, you can extend suggested configuration:

<?php
declare(strict_types=1);

use Paysera\PhpStormHelper\Entity\SuggestedGlobalConfiguration;
use Paysera\PhpStormHelper\Entity\ExternalToolConfiguration;

return (new SuggestedGlobalConfiguration())

    ->addExternalToolConfigurations([
        (new ExternalToolConfiguration())
            ->setName('PHP server')
            ->setCommand('php')
            ->setParameters('-S 0.0.0.0:8080'),
    ])
    
    ->addPlugins([
        'https://example.com/my-custom-plugin.jar',
    ])
;

If you don't provide config path, our suggested global configuration is used.

Semantic versioning

This library follows semantic versioning.

See Symfony BC rules for basic information about what can be changed and what not in the API. Keep in mind, that in this bundle everything is @internal by default – only use the classes and methods marked with @api directly.

Any other files, including default configuration for the project, can also change with any release.

Default PhpStorm configuration, tools or plugins can change with any version number.

Running tests

composer update
composer test

Contributing

Feel free to create issues and give pull requests.

You can fix any code style issues using this command:

composer fix-cs

Thenodai / util-phpstorm-helper