Laravel Sail - setting up phpstorm for phpunit tests

To configure PhpStorm to run PHPUnit tests using Laravel Sail, follow these steps:

1. Open the Settings/Preferences dialog by pressing Ctrl+Alt+S or by selecting File | Settings for Windows and Linux or PhpStorm | Preferences for macOS.

2. In the left-hand pane, select Languages & Frameworks | PHP.

3. In the right-hand pane, click the ... button next to the CLI Interpreter field.

4. In the CLI Interpreters dialog, click the + button to add a new interpreter.

5. Select From Docker, Vagrant, VM, Remote... from the list of options and click Next.

6. In the Docker dialog, select Docker Compose.

7. In the Docker Compose dialog, select the docker-compose.yml file for your Laravel Sail project.

8. In the Service field, enter the name of the service that contains PHP, which is usually app.

9. Click OK to save the interpreter settings.

10. In the left-hand pane, select Languages & Frameworks | PHP | Test Frameworks.

11. In the right-hand pane, click the + button to add a new test framework.

12. Select PHPUnit from the list of options and click Next.

13. In the PHPUnit dialog, select the Use Composer autoloader option.

14. In the PHPUnit Library field, enter the path to the phpunit executable in your Laravel Sail project, which is usually /var/www/vendor/bin/phpunit.

15. Click OK to save the test framework settings.

16. Open the Run menu and select Edit Configurations.

17. Click the + button to add a new configuration and select PHPUnit.

18. In the PHPUnit dialog, select the interpreter you just created from the Interpreter dropdown.

19. In the Test Runner field, select PHPUnit via Composer.

20. In the Test Scope field, select Defined in the configuration file.

21. In the Configuration file field, enter the path to your phpunit.xml file in your Laravel Sail project, which is usually /var/www/phpunit.xml.

22. Click OK to save the configuration.

23. You can now run your PHPUnit tests using Laravel Sail by selecting the configuration you just created from the Run menu.

Example configuration file:

<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="http://schema.phpunit.de/9.5/phpunit.xsd"
         backupGlobals="false"
         colors="true"
         bootstrap="vendor/autoload.php">
    <testsuites>
        <testsuite name="Unit">
            <directory suffix="Test.php">./tests/Unit</directory>
        </testsuite>
        <testsuite name="Feature">
            <directory suffix="Test.php">./tests/Feature</directory>
        </testsuite>
    </testsuites>
    <php>
        <ini name="memory_limit" value="-1"/>
        <server name="APP_ENV" value="testing"/>
        <env name="DB_CONNECTION" value="mysql"/>
        <env name="DB_DATABASE" value="test"/>
        <env name="DB_USERNAME" value="root"/>
        <env name="DB_PASSWORD" value=""/>
    </php>
</phpunit>