Note: This documentation is still in progress, not reviewed properly, and might contain some errors or outdated images. It's intended for the upcoming 4.0.0 release, so configuration settings might be different from previous versions.

Upgrading to v3.4.1

Overview

Version 3.4.1 is a maintenance release that addresses several important bug fixes and security improvements discovered after the v3.4.0 release. This patch update focuses on enhancing stability, security, and installer functionality without introducing breaking changes.

Upgrade Instructions

  1. Download latest tarball from GitHub
  2. Backup your files and database before proceeding
  3. Replace all files with content from the downloaded archive
  4. Restore your configuration file (inc/config.inc.php) from backup

Security Improvements

  • Fixed session security with enhanced cookie handling
  • Improved CSRF token validation for forms
  • Enhanced input validation and sanitization
  • Updated third-party dependencies to address security vulnerabilities
  • Fixed potential XSS issues in various forms

Bug Fixes

  • Corrected issues with PHP extension dependency checks
  • Fixed MySQL user creation syntax in installer
  • Resolved installation step progression issues
  • Improved error handling throughout the application
  • Fixed issues with special characters in DNS records
  • Addressed browser compatibility issues
  • Corrected form validation and error reporting
  • Fixed template rendering bugs in certain scenarios

Installation Improvements

  • Enhanced error handling during installation
  • Improved database configuration validation
  • Better feedback for configuration errors
  • More reliable language handling during installation

Code Improvements

  • Restructured installation helpers for better maintainability
  • Standardized database parameter handling
  • Improved request object handling for forms
  • Enhanced error logging and reporting

Notes

  • No database schema changes are required for this update
  • This release maintains full backward compatibility with v3.4.0
  • The update is recommended for all users due to security improvements
  • The installation process improvements only affect new installations