PhpStorm 2018.3.1 is released

PhpStorm 2018.3.1 build 183.4588.67 is now available!

In the first update for the recently released PhpStorm 2018.3, we are happy to bring you new features including support for custom string format functions and improved handling of @internal annotations. The release also has some bug fixes and improvements for PHP and the Web, and takes on the latest improvements in IntelliJ Platform.

Support for custom string format functions

In PhpStorm 2018.3, we improved the way sprintf() and printf() functions are handled – their parameters and placeholders under the caret are highlighted. In this update, we are taking another step forward: you can now define your own custom string formatting functions, and PhpStorm will apply appropriate highlighting to them, too.

To add custom formatting functions, go to Settings / Preferences | Languages & Frameworks | PHP | Analysis. There, expand the Custom Format Functions node and add a new item:


You can add both class methods and plain functions, and PhpStorm will provide you with code completion in both cases. Then, specify the index of the argument where your formatting template resides.

That’s it: apply your changes, and your custom formatting function will be included in the analysis:


Improved @internal annotation handling

In this update, we’ve improved the behavior of the Usage of internal entity inspection, which handles @internal annotations.

Previously, marking a class as internal would result in all class usages marked as internal, too.


Now, since @internal commonly denotes elements internal to a package or a library, the inspection takes your actual project structure into account:

  • In a project with no source roots, no @internal class usages will be marked.internal-class-usage-no-src-roots
  • If a source root is configured and the @internal class is located inside it, the usages inside this source root won’t be marked, but usages outside this source root will be marked.internal-class-usage-src-root
  • If the @internal class is located inside a library, all its usages outside libraries will be marked.internal-class-usage-lib
  • In a Test Sources root, no @internal elements’ usages will be marked.internal-class-usage-tests

To learn more about working with content roots, refer to PhpStorm help.

This update also brings notable bug fixes and features worth mentioning:

  • Fixed: Macro multiple $Prompt$ in External Tools (IDEA-129070 +22)
  • Fixed: “Close session” and “Select Next/Previous Tab” no longer works in terminal since latest build (IDEA-200854 +18)
  • Fixed: In anonymous classes constructor arguments are treated like anonymous class scope instead of outer scope (WI-34498 +15)
  • Fixed: Unused private method not detected when recursion (WI-17810 +14)
  • Added: Code completion for Vue.js instance methods and properties (WEB-28529 +10)
  • Fixed: Opening Embedded Terminal starts with: “cp: overwrite … ” (IDEA-202523 +8)
  • Fixed: Start ssh session is broken in 183.3795.24 (IDEA-203045 +8)
  • Fixed: Extract Method Refactoring: add parameter’s type if variable’s type is known (WI-15860 +8)
  • Fixed: PHP Array Constants – Expression is not allowed as field default value (WI-37537 +5)

See the full list of bug-fixes and improvements in the release notes.

Download PhpStorm 2018.3.1 build 183.4588.67 for your platform on the website or just click Update in your JetBrains Toolbox App.

We appreciate you reporting any bugs and feature requests to our Issue Tracker.

Your JetBrains PhpStorm Team
The Drive to Develop

This entry was posted in Release Announcements and tagged . Bookmark the permalink.
  • John Doe

    Still not fixed ….. Right click context menu has also in this release that terrible violet color….

    • Maxim Kolmakov

      The issue is marked as fixed. Could you please disable all custom plugins (Preferences|Plugins|Installed)? And if this doesn’t help, comment in the issue.

      • John Doe

        There are no custom plugins installed and also no modifications to colors, themes or something like that. It was a fresh installation of 2017.3 and default update to 2017.3.1.

        • Eugene Morozov

          That’s weird. On two my test macOS machines, the issue is fixed on 2018.3.1.
          Thank you for reporting, we’ve let the developer know.

          • John Doe

            Hey guys, what an uncool situation is it? I have completely reinstalled my MacBook during winter holidays. I got the newest version of PhpStorm and what do I see? This bug is still there. On your bugtracker that bug is marked as fixed. Why????

            This bug is not fixed.
            Didn’t you see that bug at all the versions you published????

            At the screen I added you can see a screenshot of latest WebStorm. You publish screens with this bug. Is it a plan of UI?

            Can anyone tell us when this f** bug gets out of the IDEs? I want to have a clean light theme. Without purple colors or something like that.

          • Eugene Morozov

            We have no similar reports since 2018.3.1, and I personally can’t reproduce that. Please record the same screencast as I did:

            The screenshot you added belongs to the What’s New page, this page was prepared before the release when the bug wasn’t fixed yet.

          • John Doe

            Yes, man, you’re right. In the menu the buggy color is gone.
            But not in the ide. Look at my fresh screen.

          • John Doe

            It was a clean installation of Mojave and PhpStorm. So, no modifications there.

          • John Doe

            I my bug report at your tracker I reported both of them. And I added also both screens.
            Come on guys, fix it. It couldn’t be too big deal. It’s just color modification.

          • John Doe

            And I also wrote (2 month ago) here in my first comment: “Right click context menu …”. Not dropdown menu item hover color.

      • Denis Kazimirov

        Yep, bug present for me too in Light theme.

      • John Doe

        2019 год.
        Как идет борьба с корректировкой цвета в контекстном меню?
        Возможно ли зах#рачить синий цвет, чтоб все подходило? Или все-таки искусственный интеллект в лице яблока отхватывает позиции?

        Из повести: “Lost control or how to release with random colors”

        Мир всем!

        • Eugene Morozov

          Хотя мы и не зарепортили тот фиолетовый цвет в платформу как подобает, идёт всё же хорошо:

          • John Doe

            Well done 😉
            Жду :-)

  • Sălăgean Andrei Cristian

    After the 2018.3 release, I have two issues that still haven’t been solved in this release: php code sniffer inspects file types even if those have been unchecked and I’m not sure if it has something to do with you, but this plugin stopped working

    • Eugene Morozov

      > php code sniffer inspects file types even if those have been unchecked

      Is it something we already know about? I mean, maybe there’s an issue/ticket link you got when first reported it? If no, what do you mean by “have been unchecked”? Where?

      > I’m not sure if it has something to do with you, but this plugin stopped working

      It’s possible that our API has changed, but it’s still up to the plugin author to maintain the plugin code.
      Anyways, you can follow this issue to get posted on any news:

  • Max

    Still not able to autoupdate properly. How can this still be an issue?

    • Dmitry Tronin

      Please elaborate. Are you using Toolbox or standalone app? What version are you on exactly? What are you getting when running Help > Check for updates?

      • N.N.

        I think he meant that you can’t just press a button and do an update and instead you need to open a webpage, download and install the new version. Which is very annoying… and which feels like it’s from previous decade.
        For example – Standalone app, 20018.2.6 (build 182.5107.45)

        • countrpt

          Basically, if you miss the update from 2018.2.6 to 2018.3, and then 2018.3.1 comes out, the patcher doesn’t know how to keep going in sequence anymore. It can still keep going within the 2018.2.x series (from 2018.2.5 to 2018.2.6, for example), but doesn’t know that it could patch 2018.2.6 to 2018.3 and then from there up to 2018.3.1. Instead, it makes you go to the website and download the full installer.

          • Eugene Morozov

            You’re totally right, as 2018.2 cannot into chained patches.
            Luckily, 2018.3 can, so it should stop being an issue in the nearest future.

          • Max

            It is an issue for MANY versions now. Patching manually is the hell and floods my limited SSD disk space a lot!

          • Dmitry Tronin

            Starting 2018.3 this would no longer be an issue

          • N.N.

            This is great! Thanks for the feedback)

  • Bartosz

    After the update the Terminal stopped to work. I even tried to restart the system.