VaultBB Core
for phpBB
The shared service foundation for the entire VaultBB premium extension ecosystem on phpBB 3.3.x. Provides the Registry, Logger, AdminUI, Error Handler, and more — install once, power everything.
namespace vaultbb\myextension;
class ext extends \phpbb\extension\base
{
public function is_enableable(): bool
{
// Require VaultBB Core to be present
if (!$this->container->
has('vaultbb.core.registry')) {
return new \phpbb\extension\exception(
'VAULTBB_CORE_REQUIRED'
);
}
$registry = $this->container->
get('vaultbb.core.registry');
// Verify minimum Core version
if (!$registry->meetsVersion('1.0.0')) {
return new \phpbb\extension\exception(
'VAULTBB_CORE_VERSION_REQUIRED'
);
}
return true;
}
}Download & extract
Extract the zip to get a vaultbb/core/ folder.
Upload to server
Place the folder at ext/vaultbb/core/ in your phpBB root.
Enable in ACP
Go to ACP → Customise → Extensions and enable VaultBB Core.
Verify dashboard
Navigate to ACP → VaultBB → Dashboard to confirm it’s active.
Seven services.
One install.
VaultBB Core registers seven Symfony DI services that every other VaultBB extension consumes out of the box. No manual wiring — just inject and build.
Tracks all installed VaultBB extensions with version, status, and metadata. Backed by a 1-hour cache layer — getAll() hits the database once per hour across all requests.
Centralized audit log written to phpbb_vaultbb_logs. Supports per-extension filtering, pagination, and configurable retention with automatic purging.
Complete ACP component library: brand headers, metric tiles, status rows, alerts, badges, extension rows, and log rows. All VaultBB ACP modules are built exclusively with this.
Production-safe exception management. Re-throws in debug mode for inspection; silently logs and suppresses in production so your forum stays online even when something goes wrong.
Per-extension key-value configuration store. All VaultBB extensions should use this for their own config values rather than directly touching phpBB’s config table.
Compares registered extension versions against the latest available from the VaultBB API. Results are cached for a configurable TTL (default 6 hours) to avoid hammering the API.
Persistent notification queue displayed on the VaultBB ACP dashboard. Extensions post notifications via notify(); admins dismiss them through the UI.
Clean contracts.
Zero boilerplate.
Every service exposes a consistent, documented PHP API. Inject via Symfony DI, call the method, move on. No global state, no magic, no surprises.
-
Registry lifecycle
register()on enable ·setActive(false)on disable ·unregister()on purge -
Structured logging
log(source, action, context)— consistent action names across the ecosystem -
Safe callable wrapper
error_handler->safe(fn, source, default)— swallow or rethrow based on debug mode -
Cross-extension checks
registry->isActive('vaultbb/other')before touching another extension’s services -
phpBB event integration Hooks
core.user_setup,core.page_header, andcore.adm_page_header— no polling
// Inject Core services via DI
public function __construct(
registry $registry,
logger $logger,
admin_ui $admin_ui,
error_handler $error_handler
) {}
// Render branded header
$this->admin_ui->brand_header(
'My Extension', 'Overview'
);
// Show live metrics
$this->admin_ui->metric('Items', $count, '#0c6e46');
$this->admin_ui->metric('Today', $today, '#2563eb');
// Log the page view safely
$this->error_handler->safe(
fn() => $this->logger->log(
'myext', 'settings_updated',
['user_id' => $user_id]
),
'myext', null
);What’s shipped.
Compact view of all framework releases. Follows Semantic Versioning.
- Improved VaultMail Compatibility
- Fixed Several Minor Fixes
- FixedSeveral minor issues
- ImprovedAdminCP UI
- AddedInitial Release
phpBB-native.
Symfony-powered.
VaultBB Core is a proper phpBB 3.3.x extension: PSR-4 autoloaded, wired through the Symfony DI container, and using phpBB’s migration system for all database changes. No monkey-patching, no global state.
-
01
Must be installed first Every VaultBB extension checks for Core via
is_enableable()before phpBB lets it activate. -
02
Single ACP tab for the whole ecosystem Core creates the
ACP_VAULTBBtab once. All other extensions add their modules under it — never a new top-level tab. -
03
Migrations handle everything Tables, default config, and ACP modules are all created and torn down through phpBB’s migration runner. Zero manual SQL.
-
04
Purge Core last Always purge all dependent extensions before purging Core. Dropping Core drops
phpbb_vaultbb_registryandphpbb_vaultbb_logs— irreversible.
vaultbb/core/ ├── acp/ │ ├── main_info.php │ └── main_module.php ├── adm/style/ │ ├── acp_vaultbb_core_dashboard.html │ ├── acp_vaultbb_core_logs.html │ ├── acp_vaultbb_core_settings.html │ └── vaultbb_core_base.html ├── admin_ui/ │ └── admin_ui.php ├── config/ │ └── services.yml ← 7 DI services ├── error/ │ └── error_handler.php ├── event/ │ └── main_listener.php ├── language/en/ │ ├── common.php │ └── info_acp_core.php ├── logger/ │ └── logger.php ├── migrations/ │ ├── install_schema.php │ ├── install_data.php │ └── v102…v104… ├── docs/ │ ├── README.md │ ├── INSTALL.md │ ├── DEVELOPER.md │ ├── CHANGELOG.md │ └── EVENTS.md ├── composer.json └── ext.php
The Core is Free.
Naturally.
The foundation of the VaultBB phpBB ecosystem will never be paywalled.
- 7 Symfony DI services for the whole ecosystem
- Shared ACP tab & dashboard for all VaultBB extensions
- Centralized audit log with retention controls
- Full ACP component library (AdminUI)
- Production-safe error handling
- Settings Store, Update Checker & Admin Notifier
- phpBB 3.3.x · PHP 7.4+ · PSR-4 autoloaded
- Full documentation: README, INSTALL, DEVELOPER, EVENTS
Downloaded 5 times