Sessions
Enable the Database Tools and SQL plugin
This functionality relies on the Database Tools and SQL plugin, which is bundled and enabled in PhpStorm by default. If the relevant features aren't available, make sure that you didn't disable the plugin.
Press Control+Alt+S to open the IDE settings and then select .
Open the Installed tab, find the Database Tools and SQL plugin, and select the checkbox next to the plugin name.
In PhpStorm, connections to the database are established in special wrappers — sessions. Each session is a wrapper over a single connection, and it stores the connection's information (for example, whether it is active or not, transaction control mode, and other settings).
Within a session, connections can open and close when required and in accordance with the defined settings.
Sessions can have clients — files, whose queries are sent via the connection that the session holds. Data editor can also be a client for a session.
You can view data sources, sessions, and session clients in the Services tool window. Green dot in the corner of session's icon indicates a connected session.
In the picture above, the Services tool window displays the following nodes:
Data source.
Disconnected session.
Connected session.
Session clients.
For more information about the session managing options and toolbar controls, refer to Services tool window controls.
If you close PhpStorm and open it again, all your sessions will be available in the Services tool window, but they will be empty.
New session
Depending on the way you create a new session, it can be connected either automatically, or after a certain action. Green dot in the corner of session's icon indicates the connected status.
You can create a new session by doing either of the following:
Open a query console or view database object's data in data editor.
As a result, under the data source node in the Services tool window, the new session node appears with a client node under it.
For a query console, the session will be connected once you perform an action that requires interaction with the database. For example, once you run a query.
For a table, the session is connected automatically, as PhpStorm requires an active connection to request the table data from the database, receive it, and display it in the data editor.
Perform an action that requires interaction with the database. For example, run a stored procedure or run a script via run configurations.
As a result, the new connected session node appears under the data source node in the Services tool window.
Manage sessions
The following table includes basic actions that you can use to work with sessions.
Action | Description |
|---|---|
Create a session for a data source | Click the <session> list and select New Session.  |
Attach SQL file to an existing session | Click the <session> list and select an existing session.  |
Detach a session | Click the <session_name> list and select an existing session.  |
Rename a session | In the Services tool window, right-click a session and select Rename Session.  |
Move a session or a data source to a separate tab | In the Services tool window, right-click a session or a data source and select Open in New Tab. To revert this action, close the separated tab.  |
Close a session | In the Services tool window, right-click a session and select Close Session. The session will be detached from its session clients, it will also disappear from the list. |
Close all sessions | In the Services tool window, right-click a data source and select Close All Sessions.  |
Services tool window controls
For more information about the Services tool window, refer to the Services tool window topic.
Left toolbar controls
Data sources
Icon | Action and shortcut | Description |
|---|---|---|
| Jump to Query Console Control+Shift+F10 | Open the Query Consoles popup. In the Query Consoles popup, you can select a query console that you want to open in the editor. |
| Deactivate Control+F2 | Close the database connection for the selected data source or data sources. (The data sources with connected sessions are indicated with a green dot in the corner of their icon.) |
Sessions
Icon | Action and shortcut | Description |
|---|---|---|
| Transaction Mode and Transaction Isolation | Select the isolation level for database transactions and the way the transactions are committed.
For more information about database transaction modes and isolation, refer to Submit changes to a database. |
| Commit | Commit the current transaction. This button is available only for the manual transaction mode. See also, transaction mode and isolation. |
| Roll back | Roll back changes. This button is available only for the manual transaction mode. See also, transaction modes and isolation. |
| Cancel Running Statements Control+F2 | Terminate execution of the current statement or statements. |
| Restore Default Layout | Restore default positions of visual elements in the tool window. |
) or 
) buttons on the toolbar.
Context menu
Data sources
Icon | Action and shortcut | Description |
|---|---|---|
| Jump to Query Console Control+Shift+F10 | Open the Query Consoles popup. In the Query Consoles popup, you can select a query console that you want to open in the editor. |
| Deactivate Control+F2 | Close the database connection for the selected data source or data sources. (The data sources with connected sessions are indicated with a green dot in the corner of their icon.) |
Close All Sessions | Close all opened sessions to a data source. | |
Open in New Tab | Move the selected items to a separate tab. | |
Open Each in New Tab | Split the selected items into separate tabs. | |
Open Each Type in New Tab | Create separate tabs for each type of service. | |
Delete Delete | Close all opened sessions to a data source. Identical to Close All Sessions. |
Sessions
Icon | Action and shortcut | Description |
|---|---|---|
| Transaction Mode and Transaction Isolation | Select the isolation level for database transactions and the way the transactions are committed.
For more information about database transaction modes and isolation, refer to Submit changes to a database. |
| Commit | Commit the current transaction. This button is available only for the manual transaction mode. See also, transaction mode and isolation. |
| Roll back | Roll back changes. This button is available only for the manual transaction mode. See also, transaction modes and isolation. |
| Cancel Running Statements Control+F2 | Terminate execution of the current statement or statements. |
| Restore Default Layout | Restore default positions of visual elements in the tool window. |
Rename Session Shift+F6 | Display the Rename Session '<session_name>' dialog where you can specify a name for a session. | |
Close Session | Close the selected session. | |
Open in New Tab | Move the selected items to a separate tab. | |
Open Each in New Tab | Split the selected items into separate tabs. | |
Open Each Type in New Tab | Create separate tabs for each type of service. | |
Delete Delete | Close all opened sessions to a data source. Identical to Close All Sessions. |
SQL files
Icon | Action and shortcut | Description |
|---|---|---|
| Transaction Mode and Transaction Isolation | Select the isolation level for database transactions and the way the transactions are committed.
For more information about database transaction modes and isolation, refer to Submit changes to a database. |
| Commit | Commit the current transaction. This button is available only for the manual transaction mode. See also, transaction mode and isolation. |
| Roll back | Roll back changes. This button is available only for the manual transaction mode. See also, transaction modes and isolation. |
| Cancel Running Statements Control+F2 | Terminate execution of the current statement or statements. |
| Restore Default Layout | Restore default positions of visual elements in the tool window. |
Attach Session | Attach the selected file to one of the available sessions. To detach the file from a session, open the file in the editor, click the <session> list and select Detach Session. | |
Open in New Tab | Move the selected items to a separate tab. | |
Open Each in New Tab | Split the selected items into separate tabs. | |
Open Each Type in New Tab | Create separate tabs for each type of service. | |
Delete Delete | Close all opened sessions to a data source. Identical to Close All Sessions. | |
| Jump to Source F4 | Open the file in the editor. |
