Configuration

PHP Agent

Configuration options for PHP Agent. They are modifiable using Hdiv Toolbar configuration page or more generally using environment variables.

The following configurations go in the file [AGENT_PATH]/settings/core-settings.ini

Property Type Description
php.run.dir string Set this to any existing directory that can be read, written and traversed (g+rwX). It will be used by the agent and core to store runtime files.
hdiv.config.dir string Same as above. It will be used by the core. It can be the same as php.run.dir.
hdiv.mandatory.app.name string The name of your app.
hdiv.mandatory.app.version string The current version of your app.
php.core.[platform].bin string On the key, change [platform] to the one the architecture chosen at installation. It can be: java, linux, macos, windows (e.g: php.core.linux.bin). The value must be the full path of the core, including the file name.
hdiv.console.level Custom Define the logging level the following options are available
  • OFF
  • SEVERE (default)
  • WARNING
  • INFO
  • FINE
  • FINER
  • hdiv.file.level Custom Define the logging level the following options are available
  • OFF
  • SEVERE
  • WARNING
  • INFO (default)
  • FINE
  • FINER
  • hdiv.log.append Boolean Define whether agent traces should be appended during startup or not, by default false
    hdiv.async.taint.tracking Boolean A flag to that vulnerabilities should be tracked in asynchronous threads, it could be enabled at a cost in performance, by default false
    hdiv.toolbar.enabled Boolean Whether Hdiv toolbar should be shown or not, when the agent is not configured to communicate with a Web Console it will be always displayed, otherwise by default is false
    hdiv.console.url String Defines de URL of the Web Console, by default http://localhost:8089/hdiv-console-services
    hdiv.console.token String Authentication token for the environment in the Web Console
    hdiv.server.name String The name that will identify this server in the Web Console

    Extension

    The following configuration go into the file [PHP Additional .ini parsed]/hdiv.ini

    Property Type Description
    hdiv.prehook_opcode Boolean(1/0) This configuration make te extension to wrap opcodes. Default 1
    hdiv.debug_level Number(0-7) Debug level for logging. It matches syslog levels. Default 0
    hdiv.debug_size Filesize It indicates how big the debug log file can be. Default 100M
    hdiv.debug_rotations Number This indicates the maximum amount of rotations the logging file will have. Default 1
    hdiv.debug_path String It indicates where the logging file will be created. Default /tmp