diff options
| author | Tristan Darricau <tristan.darricau@sensiolabs.com> | 2016-01-25 09:08:23 +0100 |
|---|---|---|
| committer | Tristan Darricau <tristan.darricau@sensiolabs.com> | 2016-01-25 09:08:23 +0100 |
| commit | b7db2717b29a95f94eb3f2e8e7ce0c7f597e9bc8 (patch) | |
| tree | 36f347787aab15ff5cf9545a51aa8a4d331a7935 /phpBB/phpbb/db/migration/migration_interface.php | |
| parent | d8af5ac4f9ddc1de16af73f5af1f2c465ee124e4 (diff) | |
| parent | fac4672f3f2def54fb65e325e77dea14cbc4aa6a (diff) | |
| download | forums-b7db2717b29a95f94eb3f2e8e7ce0c7f597e9bc8.tar forums-b7db2717b29a95f94eb3f2e8e7ce0c7f597e9bc8.tar.gz forums-b7db2717b29a95f94eb3f2e8e7ce0c7f597e9bc8.tar.bz2 forums-b7db2717b29a95f94eb3f2e8e7ce0c7f597e9bc8.tar.xz forums-b7db2717b29a95f94eb3f2e8e7ce0c7f597e9bc8.zip | |
Merge pull request #4126 from marc1706/ticket/13733
[ticket/13733] Allow non-migration files inside migrations folder
* marc1706/ticket/13733:
[ticket/13733] Remove validate_classes method argument
[ticket/13733] Make sure migration classes always have same order in tests
[ticket/13733] Properly test setting validate_classes to false/true
[ticket/13733] Use interface for migratinos
[ticket/13733] Update comment explaining migration class validation
[ticket/13733] Add isInstantiable() check.
[ticket/13733] Braces on their own lines
[ticket/13733] Allow tests the skip class validation
[ticket/13733] Properly handle nonexistent classes as well
[ticket/13733] Handle nonexistent classes as well
[ticket/13733] Only use migration classes that extension the base migration class.
Diffstat (limited to 'phpBB/phpbb/db/migration/migration_interface.php')
| -rw-r--r-- | phpBB/phpbb/db/migration/migration_interface.php | 70 |
1 files changed, 70 insertions, 0 deletions
diff --git a/phpBB/phpbb/db/migration/migration_interface.php b/phpBB/phpbb/db/migration/migration_interface.php new file mode 100644 index 0000000000..2aba5ec608 --- /dev/null +++ b/phpBB/phpbb/db/migration/migration_interface.php @@ -0,0 +1,70 @@ +<?php +/** + * + * This file is part of the phpBB Forum Software package. + * + * @copyright (c) phpBB Limited <https://www.phpbb.com> + * @license GNU General Public License, version 2 (GPL-2.0) + * + * For full copyright and license information, please see + * the docs/CREDITS.txt file. + * + */ + +namespace phpbb\db\migration; + +/** + * Base class interface for database migrations + */ +interface migration_interface +{ + /** + * Defines other migrations to be applied first + * + * @return array An array of migration class names + */ + static public function depends_on(); + + /** + * Allows you to check if the migration is effectively installed (entirely optional) + * + * This is checked when a migration is installed. If true is returned, the migration will be set as + * installed without performing the database changes. + * This function is intended to help moving to migrations from a previous database updater, where some + * migrations may have been installed already even though they are not yet listed in the migrations table. + * + * @return bool True if this migration is installed, False if this migration is not installed (checked on install) + */ + public function effectively_installed(); + + /** + * Updates the database schema by providing a set of change instructions + * + * @return array Array of schema changes (compatible with db_tools->perform_schema_changes()) + */ + public function update_schema(); + + /** + * Reverts the database schema by providing a set of change instructions + * + * @return array Array of schema changes (compatible with db_tools->perform_schema_changes()) + */ + public function revert_schema(); + + /** + * Updates data by returning a list of instructions to be executed + * + * @return array Array of data update instructions + */ + public function update_data(); + + /** + * Reverts data by returning a list of instructions to be executed + * + * @return array Array of data instructions that will be performed on revert + * NOTE: calls to tools (such as config.add) are automatically reverted when + * possible, so you should not attempt to revert those, this is mostly for + * otherwise unrevertable calls (custom functions for example) + */ + public function revert_data(); +} |