Run/Debug Configuration: PHPUnit on Server

Configuration Tab

In this tab, specify the unit tests to launch and the command line switches to be passed to the test runner.

Item	Description
Test	In this area, specify the location of tests or the configuration file where they are listed. All in Directory: select this option to have all the unit tests in a directory launched. In the Directory text box, specify the directory to search the unit test in. Type the path to the directory manually or click the Browse button and select the desired directory in the Choose Test Directory dialog box, that opens. All in File: select this option to have all the unit tests in a test class or a file launched. In the File text box, specify the file to search the class or suite in. Type the path to the file manually or click the Browse button and select the desired directory in the Choose Test File dialog box, that opens. Class or Suite: select this option to have all the unit tests in a test class or a test suite launched. In the File text box, specify the file to search the class or suite in. Type the path to the file manually or click the Browse button and select the desired directory in the Choose Test File dialog box, that opens. In the Class text box, specify the desired class. Type the class name manually or click the Browse button and select the desired class in the tree view, that opens. Method: select this option to have a specific test method launched. In the File text box, specify the file to search for the test method in. Type the file name manually or click the Browse button and select the desired file in the tree view, that opens. In the Method text box, specify the desired method. XML file: select this option to have test runner execute the tests from a dedicated XML file. Specify the XML file to use in the Use XML configuration file text box.
Custom working directory	In this text box, specify the location of the files that are outside the folder with tests and are referenced in your tests through relative paths. Type the path manually or click the Browse button and select the desired folder in the dialog that opens. Note This settings does not block the test execution because the location of tests is always specified through a full path to the corresponding files and/or directories.

Item

Description

Test

In this area, specify the location of tests or the configuration file where they are listed.

All in Directory: select this option to have all the unit tests in a directory launched.
In the Directory text box, specify the directory to search the unit test in. Type the path to the directory manually or click the Browse button and select the desired directory in the Choose Test Directory dialog box, that opens.
All in File: select this option to have all the unit tests in a test class or a file launched. In the File text box, specify the file to search the class or suite in. Type the path to the file manually or click the Browse button and select the desired directory in the Choose Test File dialog box, that opens.
Class or Suite: select this option to have all the unit tests in a test class or a test suite launched.
1. In the File text box, specify the file to search the class or suite in. Type the path to the file manually or click the Browse button and select the desired directory in the Choose Test File dialog box, that opens.
2. In the Class text box, specify the desired class. Type the class name manually or click the Browse button and select the desired class in the tree view, that opens.
Method: select this option to have a specific test method launched.
1. In the File text box, specify the file to search for the test method in. Type the file name manually or click the Browse button and select the desired file in the tree view, that opens.
2. In the Method text box, specify the desired method.
XML file: select this option to have test runner execute the tests from a dedicated XML file. Specify the XML file to use in the Use XML configuration file text box.

Custom working directory

In this text box, specify the location of the files that are outside the folder with tests and are referenced in your tests through relative paths. Type the path manually or click the Browse button browseButton

and select the desired folder in the dialog that opens.

Note

This settings does not block the test execution because the location of tests is always specified through a full path to the corresponding files and/or directories.

Test Groups Tab

In this tab, appoint the groups of tests to execute when the tests are run according to the current run configuration.

Grouping tests is helpful, for example, to distinguish between tests to run in a production environment from those to run in your development environment. You just need to create two groups and then include or exclude them depending on the current environment.

To attach a test to a group, tag it with the @group annotation in the format:

/**
    @group <group specification>
*/

To enable filtering tests based on their authors, tag the tests with the @author

annotation.

Item	Description
Include/Exclude groups	Select this check box to enable configuring execution of test groups.
Group Name	In this read-only list, select the test group to be involved or skipped in testing.
Include	Select this check box to have the tests from the selected test group executed.
Exclude	Select this check box to have the tests from the selected test group skipped.

Remote

In this tab, configure deployment of tests to a remote server.

Item	Description
Remove test files after run	Select this check box to have tests removed from the server upon execution.
Show transfer logs	Select this check box to have test deployment logged.
Server paths mappings	Click this button to open the Override Server Paths Mappings dialog box, where you can map local folders to folders on the server with regard to the file system used on the server. Tip PhpStorm detects these mappings automatically but still provides you with this possibility to specify them manually.

Toolbar

Item	Keyboard shortcut	Description
	Alt+InsertAlt+Insert	Click this button to add new configuration to the list.
	DeleteDelete	Click this button to remove the selected configuration from the list.
	Ctrl+DCtrl+D	Click this button to create a copy of the selected configuration.
	Edit Defaults	Click this button to edit the default configuration templates. The defaults are used for the newly created configurations.
	UpUp DownDown	Use these buttons to move the selected configuration up and down in the list. The order of configurations in the list defines the order, in which configurations appear in the Run/Debug drop-down list on the main toolbar.

Common options

Item

Description

Defaults

This node in the left-hand pane of the dialog box contains the default run/debug configuration settings. Select the desired configuration to change its default settings in the right-hand pane. The defaults are applied to all newly created run/debug configurations.

Temporary configurations limit

Specify here the maximum number of temporary configurations to be stored and shown in the Select Run/Debug Configuration drop-down list.

Before launch

In this area, specify the actions to be performed prior to executing the current run/debug configuration.

Item	Keyboard shortcut	Description
	Alt+InsertAlt+Insert	Click this button to add one of the tasks to be executed prior to launching the application. The possible tasks are: Run External tool: Add this task to have PhpStorm launch the specified third-party tool prior to running or debugging. To appoint a tool to launch, select it in the External Tools dialog box that opens. Run Phing target: Add this task to execute the specified Phing target prior to running or debugging. To appoint a Phing target, click the Browse button and select the desired target in the Choose Phing Target to Execute dialog box, that opens.
	Alt+DeleteAlt+Delete	Click this button to remove selected task from the list.
	EnterEnter	Click this button to open the selected task for editing.
or	Alt+UpAlt+Up or Alt+DownAlt+Down	Click these buttons to move the selected task one line up or down. Note that Before launch actions are performed in the order they are specified in the run/debug configuration dialog.
Show this page		Select this check box to always show the Edit Run/Debug Configuration dialog prior to launching the current run/debug configuration. If this check box is not selected, run/debug configuration will be launched silently.

PhpStorm 6.0.1 Web Help