Troubleshooting

TODO

this section does not belong into the user manual, but into developer documentation.

Error Handling

The TopConfigRegistry throws RuntimeException in the following cases: - Plugin not registered - Configuration key not found - Invalid value type requested

Example error handling:

try {
    $value = $configService->get('PluginName', 'some.key', 'string');
} catch (RuntimeException $e) {
    // Handle the error appropriately
}

Common Issues

1. Plugin Not Found: Ensure the plugin is properly registered
2. Configuration Not Loading: Check if the mapping is correctly defined
3. Type Errors: Verify you're using the correct type when accessing values

Debug Mode

Enable debug mode in the plugin configuration to get additional logging information.