Lando + PHPStorm + PHPUnit

[Tigatok]

Hi there,

Has anyone successfully set up Lando + PHPStorm + PHPUnit to run all together, such that you can run the tests right from the IDE (Not the terminal/running as lando phpunit)? If so, can you post documentation on getting them set up? I've tried a few times and every time I believe it boils down to PHPStorm running some sort of containers of their own. But it IS possible through docker-compose (non lando setup), so am wondering if there are any tips/tricks to maybe getting it to work with Lando.

Much appreciated!

[joshmiller83]

I found this in the Lando slack search:

https://imgur.com/a/XcpZAs7

[hailwood]

Yeah I've tried this several times, from my research I don't believe it's possible until PHPstorm adds the ability to use an already running container as the test runner.

Phpstorm can also connect over SSH, but I haven't been able to work out how to get it to connect into the lando appserver. If we can get that working, it will probably be the easiest path forward.

[joshmiller83]

I have a working example. Writing up a Lando guide.

[joshmiller83]

Guide write up delayed because of the effort involved. Here's the step by step that works for me on a Mac but doesn't work on Ubuntu 20.04.

Before you begin

• start Lando lando start
• Make sure you're working with a composer-based PHP project that has PHPUnit in its dependencies.
• Run composer lando composer install
• Find your Lando instance Network ID docker network ls
  • The results of that scan could be large. Look for your Lando environment's network (there should be only one per project) then copy the "Network ID" somewhere convenient.

Step 1: Configure PHPStorm Docker

• Go to your settings pane.
• Locate your Docker settings under the Build, Execution, Deployment menu. If you can't find it search for Docker.

• Select "Build, Execution, Deploy"
• Select "Docker"
• Click "+"
• Select "Docker for Mac"
• Confirm you see "Connection successful"

Step 2: Configure PHPStorm PHP CLI

Next, we need to tell PHPStorm about Lando's PHP Image. This is where a lot of the settings are used from the "Before you begin" section.

• Locate your PHP settings under the Languages & Frameworks section. Choose your CLI Interpreter.
  

1. Select "Languages & Frameworks"; 2. Select "PHP"; 3. Change your PHP version if needed; 4. Click the "..." to the right of "CLI Interpreter"

• Locate your PHP settings under the Languages & Frameworks section. Click the "Folder" icon next to the "Docker Container" section.
• Change the Container "Network Mode" to the Network ID from the "Before you begin" section.

• Change the Container Path to "/app"

Step 3: Configure PHPStorm PHPUnit

Finally, we need to tell PHPStorm about PHPUnit and where to find it's executable command file.

• Locate your Testing settings under the PHP section in the Languages & Frameworks section.

• Create a "PHPUnit by Remote Interpreter" configuration.

• Locate your project level phpunit.phar file.

Step 4: Create a PHPUnit Configuration

Now that you have your PHPStorm Project Settings all correctly configured (steps 1-3), the next step is to create a "Run/Debug Configuration" that will give you a push-button ability to run PHPUnit tests using Lando's Docker PHP Docker. Note: This is not the last step, so this will not likely work if you click play once you're done.

• Locate your "Run/Debug Configuration" screen

• Create a "All custom tests" PHPUnit Run configuration.

1. Name your Test Run Configuration. Perhaps "All custom tests"; 2. Set the scope to a directory. Of course, you can change this later or create new configurations as needed; 3. If you choose directory, it must be your local and not your lando image directory; 4. Confirm your interpreter looks right. If there are problems, PHPStorm is really good at telling you what is missing.

Step 5: PHPUnit.xml Settings

The recommended approach is to keep a PHPStorm-version of phpunit.xml file called "phpunit.phpstorm.xml" at the root of your repository so you can set specific options up just for PHPStorm. Below there is a complete copy of the xml file, but here for good measure are the items that you will want to consider:

<php>
    <env name="SIMPLETEST_BASE_URL" value="http://appserver_nginx"/>
    <env name="SIMPLETEST_DB" value="mysql://drupal8:drupal8@database/drupal8#phpunit"/>
</php>
<testsuites>
    <testsuite name="unit">
      <file>./web/core/tests/TestSuites/UnitTestSuite.php</file>
    </testsuite>
</testsuites>
<filter>
  <whitelist>
      <directory>./web/modules</directory>
  </whitelist>
</filter>

Specifically, do the following:

• Change the SIMPLETEST_BASE_URL to the value of the internal host returned when you run lando info for your primary appserver. In this case, NGINX in Lando reports "http://appserver_nginx/".
• Set your <testsuite> inclusion files to look at ./web/core/...
• Set your code coverage <whitelist> directories to ./web/...

[quentint]

I've used your guide on Windows, here are the differences:

1. Allow TCP socket (on Docker settings) and use it

2. PHP path mappings and Docker container are a bit different (/opt/project/)

3. Same for path to phpunit.phar

4. Specify alternative configuration file (not required, your phpunit.phpstorm.xml idea looks great)

I hope this helps!
At least I'm sure this will help me in the future 😉

[sheanhoxie]

Thanks for the guide! I got my tests up and running, but I ran into issues on step 3

Create a "PHPUnit by Remote Interpreter" configuration.

... where if I touched the little refresh icon next to Path to phpunit.phar I would get a popup from PhpStorm saying Updating PhpUnit Version... and I was unable to close it, or cancel, force quitting PhpStorm was the only option.

Well, after force quitting, and double checking all of my settings compared to yours, I was able to get my tests running. However, even when all the settings are good, touching that refresh icon brings the dreaded unclosable Updating PhpUnit Version.. popup

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions and please check out this if you are wondering why we auto close issues.

[quentint]

Here's an updated version of this issue's steps, relying on Docker Compose and without relying on docker network ls: https://gist.github.com/quentint/6331aa9a75313ed955b2ea20d33557af

I hope this helps!
Not sure if there's a place for this, but I guess this could be linked to from (or integrated to) the Lando docs. Thoughts?

[sebastienserre]

Hello,

Is Someone kowns why it says "XDebug" extension isn't installed ?

[quentint]

Did you enable XDebug on your Lando project?
See this doc section: https://docs.lando.dev/config/php.html#using-xdebug

[sebastienserre]

Thanks @quentint , I have it setup like that

I'm on Ubuntu 20.04

[quentint]

Looks OK to me. Did you rebuild?
To be honest, I never used XDebug in this configuration (I only used PHPUnit without XDebug), so I'm not sure I'm really helpful :(

[sheanhoxie]

@sebastienserre You probably need to tell PHPStorm where Xdebug is located within the Lando environment. To find out where this is, from your terminal, SSH into the Lando app with the following command:

lando ssh

and then from within the Lando app environment, enter the command:

php -i | grep -i 'extension_dir'

This command should spit out something like this, I've highlighted in yellow the portion you want to copy:

Back in PHPStorm Run/Debug configurations screen, choose the lando CLI interpreter from the dropdown, and then click the options button as shown here:

Paste the extensions directory path you copied from the Lando environment, into the "Additional: Debugger Extension" field, and dont forget to add the xdebug extension "xdebug.so" as shown here:

That should resolve the issue of "'Xdebug' extension is not installed"

[sebastienserre]

Thank you @sheanhoxie, it works.