phpBB

Development Wiki

Difference between revisions of "Migrations"

From phpBB Development Wiki

m (What do Migrations mean for me?)
 
(One intermediate revision by one other user not shown)
Line 4: Line 4:
 
RFC Topic if you're interested in the reasons: http://area51.phpbb.com/phpBB/viewtopic.php?t=41337<br />
 
RFC Topic if you're interested in the reasons: http://area51.phpbb.com/phpBB/viewtopic.php?t=41337<br />
  
==What does Migrations mean for me?==
+
==What do Migrations mean for me?==
 
===As a user===
 
===As a user===
No changes to using phpBB.<br />
+
Migrations do not affect using phpBB, only writing code for it, so Administrators do not have to do anything differently.<br />
 
Database updates between versions of phpBB and Mod/Extension updates will be safer and, in the unlikely event something happens during database changes, much easier to debug and correct.
 
Database updates between versions of phpBB and Mod/Extension updates will be safer and, in the unlikely event something happens during database changes, much easier to debug and correct.
  

Latest revision as of 07:53, 13 January 2013

Beginning with phpBB 3.1, database updating is performed using Migrations.

Migrations was built because of the difficulties of distributed development and maintaining an updated database setup across all developers.
RFC Topic if you're interested in the reasons: http://area51.phpbb.com/phpBB/viewtopic.php?t=41337

What do Migrations mean for me?

As a user

Migrations do not affect using phpBB, only writing code for it, so Administrators do not have to do anything differently.
Database updates between versions of phpBB and Mod/Extension updates will be safer and, in the unlikely event something happens during database changes, much easier to debug and correct.

As an Extension/Modification author

Functionality similar to UMIL built into phpBB (easier management of database changes between versions, helpful tools to assist making database changes).

As a Developer

Easier collaboration with others, less time spent managing database changes between different branches and pull requests.

How do I use Migrations?

Getting started with Migrations

How to create a basic Migration file
Migrations/Getting Started

Migration Helpers

How to use Migration helpers to perform basic database changes
Migrations/Tools

Using Migrations in an Extension

How to use Migrations in your Extension to make database changes
Migrations/Extensions