Fixing Two Possible Issues When Upgrading phpBB Gallery During an Upgrade From phpBB 3.0.x

Version 3.1.x of phpBB introduced a major change, a new addon system. The previous addons, MODs, have been replaced with extensions. That change has a number of impacts, including possibly requiring replacements extensions to be found when MODs being used haven’t been converted, as well as needing to go through additional steps during the upgrade to handle moving to the new extension version of addons. That is a good reason to make sure that a test of the upgrade is done first, which should really be done with any significant upgrade. That is something that we do for all of the phpBB upgrades that we do.

While working on a recent upgrade from 3.0.x to 3.2.x we ran into a couple of issues with upgrading the phpBB Gallery addon. To help others that might run into those we are sharing how we resolved them.

The basic steps for completing the upgrade of phpBB Gallery are found here. While following those we ran in to two issues when enabling the phpBB Gallery extension after upgrading phpBB to 3.2.x.

The first error that occurred was as follows:

Something went wrong during the request and an exception was thrown. The changes made before the error occurred were reversed to the best of our abilities, but you should check the board for errors.

A required module does not exist: ACP_CAT_DOT_MODS

That can be resolved by following the instructions here.

After resolving that we got the following error:

Something went wrong during the request and an exception was thrown. The changes made before the error occurred were reversed to the best of our abilities, but you should check the board for errors.

Several modules with the given parent module langname already exist: PHPBB_GALLERY. Try using before/after keys to clarify the module placement.

What we found was that removing two rows from _modules table in the database would solve this. The instruction prior to installing extension causes some rows related to the addon to be removed:

Open your database (either using phpMyAdmin or mysql from console) and execute the following SQL:

CODE: SELECT ALL

DELETE FROM tableprefix_modules WHERE module_basename LIKE '%gallery%'

tableprefix by default is phpbb.

On the website we working with, doing that would not remove the rows with the “module_langname” of “PHPBB_GALLERY” and “UCP_GALLERY”:

Removing those two would allow the extension to be enabled and then the rest of the upgrade process for it can be completed.