phpBB Migration Center

A clean and simple extension to migrate your community data from XenForo, vBulletin, MyBB, or SMF to phpBB 3.3+.

---

📦 Supported Forums & Versions

Only the following platforms and versions are supported and tested:

Source Forum	Tested Versions	What is Migrated
XenForo	2.x	Users, Passwords, Groups, Forums, Topics, Posts, Attachments, Avatars, Conversations (PMs)
vBulletin	3.8.x, 4.2.x, 6.x	Users, Passwords, Groups, Forums, Topics, Posts, Attachments, Avatars, PMs, Polls, Bans
MyBB	1.8.x	Users, Passwords, Groups, Forums, Topics, Posts, Attachments, Avatars, PMs
SMF	2.0.x, 2.1.x	Users, Passwords, Groups, Boards, Topics, Posts, Attachments, Avatars, PMs, Polls, Bans

Password Security Note: Members do not need to reset their passwords. Existing passwords continue to work seamlessly and are automatically upgraded to phpBB's native secure password hash upon their first login.

---

🛠️ Step-by-Step Installation Guide

If you are new to phpBB, follow these simple steps to install and run your migration:

Step 1: Upload the Extension Files

1. Download or clone this repository.
2. In your phpBB forum root directory, open the ext/ folder.
3. Create a folder named phpbbseo, and inside it create another folder named migrationcenter.
4. Place all files from this repository inside that folder:

   phpBB_ROOT/
     └── ext/
           └── phpbbseo/
                 └── migrationcenter/
                       ├── acp/
                       ├── adm/
                       ├── config/
                       ├── composer.json
                       └── ext.php
   

Step 2: Enable the Extension in phpBB

1. Log in to your forum as an Administrator.
2. Go to the Administration Control Panel (ACP).
3. Click on the Customise tab in the top navigation bar.
4. In the left menu, click Manage extensions (under Extension Management).
5. Locate phpBB Migration Center in the list and click Enable.

Step 3: Run the Migration

1. After enabling, a new Migration tab will appear at the top of your ACP.
2. Click on the Migration tab.
3. Select your old forum software (e.g. vBulletin 6.x or XenForo 2.x).
4. Enter the database connection details of your old forum (Database Host, Database Name, Username, and Password).
5. Click Start Migration and follow the live progress bar on screen.

---

⚡ Optional: Run via Command Line (CLI)

For large forums with many posts, running via command line is recommended to prevent web server timeouts:

# Run migration
php bin/phpbbcli.php migrationcenter:run --run-id=<YOUR_RUN_ID>

# Resume an interrupted migration anytime
php bin/phpbbcli.php migrationcenter:resume --run-id=<YOUR_RUN_ID>

---

⚙️ Requirements

• phpBB: 3.3.0 to 3.3.x
• PHP: 7.4, 8.0, 8.1, 8.2, or 8.3
• PHP Extensions: pdo_mysql, json, mbstring

---

🧪 Automated Testing

To run the automated test suite on your server:

php tests/ci_runner.php

(All 30 unit and integration tests passing)

---

📄 License

This project is licensed under the GNU General Public License v2 (GPL-2.0).