Skip to main content

Configuration System Migration

The new TorrentPier features a modern, centralized configuration system with full backward compatibility.

Quick Migration Overview​

// Old way (still works, but not recommended)
global $bb_cfg;
$announceUrl = $bb_cfg['bt_announce_url'];
$dbHost = $bb_cfg['database']['host'];

// New way (recommended)
$announceUrl = config()->get('bt_announce_url');
$dbHost = config()->get('database.host');

Key Configuration Changes​

Basic Usage​

// Get configuration values using dot notation
$siteName = config()->get('sitename');
$dbHost = config()->get('database.host');
$cacheTimeout = config()->get('cache.timeout');

// Get with default value if key doesn't exist
$maxUsers = config()->get('max_users_online', 100);
$debugMode = config()->get('debug.enabled', false);

Setting Values​

// Set configuration values
config()->set('sitename', 'My Awesome Tracker');
config()->set('database.port', 3306);
config()->set('cache.enabled', true);

Working with Sections​

// Get entire configuration section
$dbConfig = config()->getSection('database');
$trackerConfig = config()->getSection('tracker');

// Check if configuration exists
if (config()->has('bt_announce_url')) {
    $announceUrl = config()->get('bt_announce_url');
}

Common Configuration Mappings​

Old SyntaxNew Syntax
$bb_cfg['sitename']config()->get('sitename')
$bb_cfg['database']['host']config()->get('database.host')
$bb_cfg['tracker']['enabled']config()->get('tracker.enabled')
$bb_cfg['cache']['timeout']config()->get('cache.timeout')
$bb_cfg['torr_server']['url']config()->get('torr_server.url')

Magic Methods Support​

// Magic getter
$siteName = config()->sitename;
$dbHost = config()->{'database.host'};

// Magic setter
config()->sitename = 'New Site Name';
config()->{'database.port'} = 3306;

// Magic isset
if (isset(config()->bt_announce_url)) {
    // Configuration exists
}

Best Practices​

Always Provide Defaults​

$timeout = config()->get('api.timeout', 30);

Use Type Hints​

function getMaxUploadSize(): int {
    return (int) config()->get('upload.max_size', 10485760);
}

Cache Frequently Used Values​

class TrackerService {
    private string $announceUrl;

    public function __construct() {
        $this->announceUrl = config()->get('bt_announce_url');
    }
}

Error Handling​

try {
    $dbConfig = config()->getSection('database');
    // Database operations
} catch (Exception $e) {
    error_log("Database configuration error: " . $e->getMessage());
    // Fallback behavior
}

Performance Optimization​

// Minimize configuration calls in loops
$cacheEnabled = config()->get('cache.enabled', false);
for ($i = 0; $i < 1000; $i++) {
    if ($cacheEnabled) {
        // Use cached value
    }
}

Security Considerations​

// Validate configuration values
$maxFileSize = min(
    config()->get('upload.max_size', 1048576),
    1048576 * 100 // Hard limit: 100MB
);

// Sanitize user-configurable values
$siteName = htmlspecialchars(config()->get('sitename', 'TorrentPier'));