GUI Configuration (configuration.php)

The configuration.php file contains PHP constants that control GUI behavior, security, and logging features not accessible through the GUI Settings menu.

File Location

Distribution	Path
Debian/Ubuntu	`/var/www/voipmonitor/php/configuration.php`
RHEL/CentOS/Rocky	`/var/www/html/voipmonitor/php/configuration.php`

ℹ️ Note: After editing configuration.php, restart the web server for changes to take effect.

# Apache
systemctl restart apache2    # Debian/Ubuntu
systemctl restart httpd      # RHEL/CentOS

# PHP-FPM (if used)
systemctl restart php8.3-fpm

Configuration Constants

AUDIT_LOG_FILE

Enables file-based audit logging for compliance requirements (GDPR, HIPAA, PCI-DSS) and forensic analysis.

define('AUDIT_LOG_FILE', '/var/log/voipmonitor/audit.log');

Requirements:

Web server user must have write permissions to the directory
Log rotation must be configured externally via logrotate

Setup:

# Create directory and set permissions
mkdir -p /var/log/voipmonitor
chown www-data:www-data /var/log/voipmonitor/
chmod 755 /var/log/voipmonitor/

💡 Tip: Configure logrotate for automatic log rotation. VoIPmonitor does not auto-rotate audit logs.

AUTOAUDIT_TEMPLATE_DOWNLOAD_WAV

Customizes the audit message template when users have "Enable audit" set to "auto" mode.

define('AUTOAUDIT_TEMPLATE_DOWNLOAD_WAV', 'Action: %action for call %call_id');

Available placeholders:

%action - The action performed
%call_id - The Call-ID of the affected record

DISABLE_LIVEPLAY

Controls visibility of live playback buttons in Active Calls view.

define('DISABLE_LIVEPLAY', true);   // Hide live play buttons
define('DISABLE_LIVEPLAY', false);  // Show live play buttons (default)

ℹ️ Note: Live playback requires G.711 codec and appropriate user permissions (can_listen_active_call).

Alternative: This can also be controlled via Settings > Advanced > Hide live play checkbox without editing the configuration file.

AI Summary for RAG

Summary: The configuration.php file contains PHP constants for VoIPmonitor GUI settings not accessible through the web interface. Key constants: AUDIT_LOG_FILE enables file-based audit logging (path like /var/log/voipmonitor/audit.log) for compliance (GDPR, HIPAA, PCI-DSS), requires web server write permissions and external logrotate configuration. AUTOAUDIT_TEMPLATE_DOWNLOAD_WAV customizes audit message templates for users with "Enable audit" set to "auto". DISABLE_LIVEPLAY (true/false) controls live playback button visibility in Active Calls (alternative: Settings > Advanced > Hide live play). File locations: Debian/Ubuntu at /var/www/voipmonitor/php/configuration.php, RHEL/CentOS at /var/www/html/voipmonitor/php/configuration.php. Changes require web server restart.

Keywords: configuration.php, AUDIT_LOG_FILE, audit logging, AUTOAUDIT_TEMPLATE_DOWNLOAD_WAV, DISABLE_LIVEPLAY, live play, compliance, GDPR, HIPAA, PCI-DSS, file permissions, log rotation, www-data, web server restart, PHP constants

Key Questions:

Where is configuration.php located in VoIPmonitor?
How do I enable file-based audit logging?
What is the AUDIT_LOG_FILE constant?
How do I customize audit message templates?
How do I disable live play buttons in Active Calls?
What permissions are needed for the audit log directory?
Do I need to restart the web server after editing configuration.php?
Does VoIPmonitor auto-rotate audit logs?
What is the difference between DISABLE_LIVEPLAY and the GUI setting?

GUI Configuration PHP