DDEV

DDEV is an open source tool for launching local web development environments in minutes.

You can run Tideways with your PHP applications in DDEV with a handful of changes to your DDEV configuration files.

Modify the web-image container to install Tideways PHP extension

Create or open .ddev/web-build/Dockerfile.tideways and save the following contents:

SHELL ["/bin/bash", "-c"]
# Install the needed development packages
RUN echo 'deb [signed-by=/usr/share/keyrings/tideways.gpg] https://packages.tideways.com/apt-packages-main any-version main' | sudo tee /etc/apt/sources.list.d/tideways.list
RUN wget -qO - 'https://packages.tideways.com/key.gpg' | gpg --dearmor | sudo tee /usr/share/keyrings/tideways.gpg > /dev/null
RUN apt-get update
RUN apt-get install tideways-php

Configure Tideways via PHP.ini

Copy the API key from the project settings and fill it with the following settings in a custom PHP.ini configuration in DDEV:

# .ddev/php/tideways.ini
tideways.api_key=...
tideways.connection=tcp://tideways-daemon:9135

Add tideways-daemon service to docker-compose

Create a new file .ddev/docker-compose.tideways-daemon.yaml:

services:
  tideways-daemon:
    image: ghcr.io/tideways/daemon
    command: "--env=development"

Restart ddev

Run:

ddev stop
ddev start

Tideways data should now flow into the "development" environment of the project that you have configured the API key for.

Still need help? Email [email protected]