Edit me

Using docker compose

CommSy development setup is greatly assisted by using docker for bootstrapping. There is also a Makefile that will simplify the use of common commands. The Makefile uses Docker Compose V2 (docker compose) syntax. So make sure it is enabled.

# Builds the docker images
make build

# Starts containers with debugging functions
make up

# Connect to the php fpm container
make sh

Open your browser at http://localhost / https://localhost

Debugging with Xdebug and PHPStorm

If not build for production, debugging capabilities are already build in.

Use a remote CLI Interpreter in PHPStorm: Go to Settings -> PHP and click the three dots (…) on the right side of CLI Interpreter. Create a new entry From Docker, ... with the following parameters:

  • Name: Docker Compose (or something else)
  • Server: Docker
  • Configuration files: Select docker-compose.yml and docker-compose.override.yml
  • Service: php

  • Lifecycle: Connect to existing container
  • General
    • PHP executable: Click refresh on the right side, it should update the PHP version and debugger information automatically.

Go to Settings -> PHP -> Test Frameworks and add a new configuration with type Codeception by Remote Interpreter. Select the docker compose interpreter created above. Unter Codeception library hit refresh on the right side. The Codeception version should be filled automatically.

Create a PHP Remote Debug configuration with the following parameters:

  • Server
    • Name: commsy
    • Host: _
    • Port: 80
    • Debugger: Xdebug
    • Use path mappings: checked
    • Absolute path on the server: /var/www/html

Add the XDEBUG_SESSION=PHPSTORM query parameter to the URL of the page you want to debug, or use other available triggers.

Alternatively, you can use the Xdebug extension for your preferred web browser.

Debugging the command line

On command line, you need to tell PHPStorm which path mapping configuration should be used, set the value of the PHP_IDE_CONFIG environment variable to serverName=commsy, where commsy is the name of the debug server configured in PHPStorm.

XDEBUG_SESSION=1 PHP_IDE_CONFIG="serverName=commsy" php bin/console ...