Development tools


Create a personal account in blackfire site:

Your credentials are stored in Account > Credentials

follow instructions of (depending of your OS):

You need to follow the following sections
  • Configuring the Red Hat Repository

  • Installing the Agent

  • Installing the PHP Probe

Once done restart php-fpm: make restart-services

Install the blackfire extension in your browser, then launch “profile”

PHPUnit configuration

Settings > Language & Frameworks > PHP

Choose a cli interpreter and validate

Settings > Language & Frameworks > PHP > Test Framework

  • PHPUnit Local

  • Use composer autoloader

  • Path to script : <tuleap_root>/src/vendor/autoload.php

Default configuration file: <tuleap_root>/tests/unit/phpunit.xml

Run > Edit configuration > Default > PHPUnit Choose custom working directory : <tuleap_root>

Open a phpunit file, run test to check if ok

Configure Debugger in PHPStorm

In PHPStorm Settings > Language & Frameworks > PHP > Server

Add serveur and define your mapping
  • Host: tuleap-web.tuleap-aio-dev.docker

  • Port: 443

  • File/Direcrtory: <tuleap root>

  • Absolute path on server: /usr/share/tuleap

In PHPStorm Run > Webserver validation

  • Path to create validation script: <tuleap_root>/tuleap/src/www

  • Url to validation script: https://tuleap-web.tuleap-aio-dev.docker/

Click on validate, you should only have a warning about remote host. Close modal.

Then start listening Run > listen for PHP Debug Connections in the PHPStorm toolbar

Go on

click on “generate”. Add the link of start debugger in bookmark (right click > bookmark this link)

Add a break point (in pre.php for instance) Go on your tuleap page, then click on bookmark then refresh your page, debugger should start

Generate artifacts with random data

Use cli-generate:artifacts CLI development tool to generate 1, 10, 1 000 000 artifacts in XML format in order to test code performance.

The command line will generate a XML file with the given number of artifacts containing random:
  • number of changesets

  • fields

  • field values

1. Download the sources from Tuleap Git

  • SSH: git clone ssh://

  • HTTPS: git clone

2. Installation


Your tuleap instance has to be running to be able to use this CLI.

2.1 Requirements

  • PHP >=8.0 and composer are required:
    • Option 1: install them from your terminal

    • Option 2: use Nix and shell.nix file to build this project dependencies environment
      • Install Nix

      • From root project directory, type nix-shell: you will be dropped in a shell with all dependencies you need to run generate:artifacts command.

  • Make sure your tuleap instance is running on this URL: https://tuleap-web.tuleap-aio-dev.docker/

  • Run make composer to install project dependencies

  • Run make setup to retrieve the certificate of your Tuleap development instance

  • Add a config.json file in root directory to store your API Access Keys as json data: {'access-key': 'your_access_key'}

3. How to use it?

There are 3 parameters for the CLI: bin/console generate:artifacts [number_artifacts] [tracker_id] [OPT: title]

For example, the following line will generate 100 artifacts with the structure of the tracker with id 1 and with the same (optional) title “random”:

$> bin/console generate:artifacts 100 1 "random"

The previous command line will generate at root directory an XML file named artifacts.xml and a directory ./data that contains random generated artifact files within.

4. Export the project in which you want to inject the XML artifacts node

5. Import the generated XML artifacts in a project

  • Copy/paste the <artifacts> node into the matching node of your project.xml file exported to the previous step

  • In terminal, from root directory, copy the contents of ./data directory into your data project directory:

    cp data/* {exported-project-directory}/data

  • Compress the project directory and use Tuleap CLI importer to import it: follow Project Import documentation