Repository navigation
phpBB Migration Center v1.0.0 Beta 3
Release Notes - phpBB Migration Center v1.0.0-beta.3
We are pleased to announce the release of phpBB Migration Center v1.0.0-beta.3. This release brings comprehensive support for MyBB 1.8 and vBulletin 3.8 / 4.2, automatic nested-set forum hierarchy repair, full phpBB extension metadata compliance, and a 100% green automated CI test suite across PHP 7.4 through PHP 8.3.
🚀 What's New & Key Highlights
1. 🌐 Full MyBB 1.8 Migration Support
A complete end-to-end migration pipeline for MyBB 1.8 forums:
- Users & Credentials: Dual-salted MD5 password hashing with automatic transparent rehashing to native phpBB Argon2id/Bcrypt upon initial login.
- Forums & Structure: Topological parent-first hierarchy ordering with nested set calculation.
- Topics & Posts: BBCode conversions (MyBB
[video],[align], spoiler tags, etc.), view counts, poll attachments, and post reactions. - Attachments & Avatars: Post attachments, custom avatar physical path resolution, and secure file mapping.
- Private Messages: Multi-recipient conversations, message tracking, folder mapping (
inbox,sent,drafts,trash), and PM attachments. - Polls & Votes: Single and multiple-choice polls, option sorting, and historical vote attribution.
- Permissions & Bans: Forum permission masks, IP bans, email bans, and account suspension synchronization.
2. 🏛️ vBulletin 3.8 & 4.2 Migration Engine
- Full support for both classic vB 3.8.x and modern vB 4.2.x database schemas.
- Specialized dual-salt MD5 password driver (
vb_hasher) with auto-rehash support. - Recursive attachment storage resolution (filesystem paths and database BLOB storage).
- Automatic exclusion of irrelevant CMS/Blog article data while maintaining thread continuity.
3. 🌳 Automatic Nested-Set Forum Tree Rebuilding
- Root Cause Fixed: Resolved the issue where imported categories appeared as empty blue bars on the phpBB index due to uncalculated
left_idandright_idtree bounds. - Added topological parent-first sorting during step processing (
forums_step.php). - Implemented
rebuild_forum_tree()andrecalc_nested_sets()in the finalization phase, guaranteeing correct nested set indices (left_id,right_id) on phpBB 3.3.x.
4. 🛠️ phpBB Extension Metadata & Strict Validation Compliance
- Fixed the fatal error:
The “phpbbseo/migrationcenter” extension is not valid. Required meta field version has not been set. - Preserved
"version": "1.0.0"incomposer.jsonfor full phpBBmetadata_managercompatibility. - Updated GitHub Actions workflow with
composer validate --no-check-version --strictto prevent conflicting Packagist metadata warnings while enforcing strict schema validation.
5. 🧪 100% Green CI Suite Across PHP 7.4 - 8.3
- Implemented standalone phpBB password driver mocks (
tests/ci_runner.php) to enable complete test coverage in headless, standalone CI runners without requiring a live phpBB core. - Made
vb_config_detector_test.phpfully isolated with temporary directory fixtures, preventing connection timeouts and missing local environment failures. - Automated Matrix: All test runs passing on PHP 7.4, 8.0, 8.1, 8.2, and 8.3.
📦 Commits Included in this Release
999edbbdocs: update version badge to 1.0.0-beta.3 for Beta 3 releaseb28e4eftest: make vb_config_detector_test isolated and resilient to CI environmentsb77ab0ftest: add standalone mocks for phpbb password driver classes in ci_runnerf4cd586fix: rebuild nested-set tree boundaries (left_id, right_id) and sort forums parent-first5d6cb86fix: preserve version in composer.json and configure workflow with --no-check-version26983fafeat: add MyBB 1.8 migration provider with full pipeline support9959732docs: update README with vBulletin 3.8 and 4.2 connectors, CI test instructions, and roadmap635acccfeat: add vBulletin 3.8 and 4.2 migration providers with full pipeline support
📥 Installation & Upgrade
- Download the release package
phpbbseo_migrationcenter_v1.0.0-beta.3.zip. - Extract the archive into your phpBB installation directory under:
ext/phpbbseo/migrationcenter/