Formulize

Forms, workflows, and reporting. 100% free and open source.

Version 7.3 out now!How to installHow to update

Download .zip View on GitHub Join us on Slack Follow on Twitter

Debugging with XDebug

If you have setup a local development environment using Docker, then you can use XDebug with PHP to do live debugging in your local environment.

(You can also setup XDebug to do remote debugging on a server elsewhere, and all sorts of other fun things, but this page just focuses on the local Docker environment.)

The Docker environment includes XDebug by default. Your IDE should more or less do the rest. We have detailed instructions for VS Code on Windows.

Setting up Formulize and Docker with XDebug in VS Code on Windows

  1. Install VS Code.

  2. Install Docker Desktop for Windows.

  3. Add the following extensions to VS Code: Docker, PHP Debug. Also, other recommended extensions are: EditorConfig for VS Code, GitLens, PHP Intelephense, SQLTools MySQL/MariaDB/TiDB (depends on SQLTools)

    VS Code Extensions

  4. Open the folder for your local development environment.

  5. Copy or rename the file: /docker/maraidb/conf.d/lower_case_table_names.cnf.windows to: /docker/maraidb/conf.d/lower_case_table_names.cnf (ie: remove the .windows part on the end).

  6. Find the docker-compose.yml file, right click on it, and select ‘Compose Up.’

    Running Docker Compose Up

  7. After a few moments, the Docker containers will be running. You will know it’s all done when you get a response browsing to http://localhost:8080

    Docker is working

  8. Switch to the Run and Debug view by clicking the icon in the Activity Bar on the side.

    Switch to Run and Debug view

  9. Click the play icon to start XDebug.

    Click the play icon

  10. Open a file, set breakpoints, and browse to http://localhost:8080 in your web browser. VS Code will show you the value of variables, let you step through the code, etc.