config = $config; $this->db = $db; $this->db_tools = $db_tools; $this->migrations_table = $migrations_table; $this->phpbb_root_path = $phpbb_root_path; $this->php_ext = $php_ext; $this->table_prefix = $table_prefix; foreach ($tools as $tool) { $this->tools[$tool->get_name()] = $tool; } $this->load_migration_state(); } /** * Loads all migrations and their application state from the database. * * @return null */ public function load_migration_state() { $sql = "SELECT * FROM " . $this->migrations_table; $result = $this->db->sql_query($sql); $this->migration_state = array(); while ($migration = $this->db->sql_fetchrow($result)) { $this->migration_state[$migration['migration_name']] = $migration; } $this->db->sql_freeresult($result); } /** * Sets the list of available migration class names to the given array. * * @param array $class_names An array of migration class names * @return null */ public function set_migrations($class_names) { $this->migrations = $class_names; } /** * Load migration data files from a directory * * @param string $path * @return array Array of migrations with names */ public function load_migrations($path) { $handle = opendir($path); while (($file = readdir($handle)) !== false) { if (strpos($file, '_') !== 0 && strrpos($file, '.' . $this->php_ext) === (strlen($file) - strlen($this->php_ext) - 1)) { $name = 'phpbb_db_migration_data_' . substr($file, 0, -(strlen($this->php_ext) + 1)); if (!in_array($name, $this->migrations)) { $this->migrations[] = $name; } } } foreach ($this->migrations as $name) { if ($this->unfulfillable($name)) { throw new phpbb_db_migration_exception('MIGRATION NOT FULFILLABLE', $name); } } return $this->migrations; } /** * Runs a single update step from the next migration to be applied. * * The update step can either be a schema or a (partial) data update. To * check if update() needs to be called again use the finished() method. */ public function update() { foreach ($this->migrations as $name) { if (!isset($this->migration_state[$name]) || !$this->migration_state[$name]['migration_schema_done'] || !$this->migration_state[$name]['migration_data_done']) { if (!$this->try_apply($name)) { continue; } else { return; } } } } /** * Attempts to apply a step of the given migration or one of its dependencies * * @param string The class name of the migration * @return bool Whether any update step was successfully run */ protected function try_apply($name) { if (!class_exists($name)) { return false; } $migration = $this->get_migration($name); $state = (isset($this->migration_state[$name])) ? $this->migration_state[$name] : array( 'migration_schema_done' => false, 'migration_data_done' => false, 'migration_data_state' => '', 'migration_start_time' => 0, 'migration_end_time' => 0, ); $depends = $migration->depends_on(); foreach ($depends as $depend) { if (!isset($this->migration_state[$depend]) || !$this->migration_state[$depend]['migration_schema_done'] || !$this->migration_state[$depend]['migration_data_done']) { return $this->try_apply($depend); } } $this->last_run_migration = array( 'name' => $name, 'class' => $migration, ); if (!isset($this->migration_state[$name])) { $state['migration_start_time'] = time(); $this->insert_migration($name, $state); } if (!$state['migration_schema_done']) { $this->apply_schema_changes($migration->update_schema()); $state['migration_schema_done'] = true; } else { $this->process_data_step($migration); $state['migration_data_done'] = true; $state['migration_end_time'] = time(); } $sql = 'UPDATE ' . $this->migrations_table . ' SET ' . $this->db->sql_build_array('UPDATE', $state) . " WHERE migration_name = '" . $this->db->sql_escape($name) . "'"; $this->db->sql_query($sql); $this->migration_state[$name] = $state; return true; } protected function process_data_step($migration) { //$continue = false; $steps = $migration->update_data(); foreach ($steps as $step) { $continue = $this->run_step($step); /*if ($continue === false) { return false; }*/ } //return $continue; } protected function run_step($step) { try { $callable_and_parameters = $this->get_callable_from_step($step); $callable = $callable_and_parameters[0]; $parameters = $callable_and_parameters[1]; return call_user_func_array($callable, $parameters); } catch (phpbb_db_migration_exception $e) { echo $e; die(); } } public function get_callable_from_step($step) { $type = $step[0]; $parameters = $step[1]; $parts = explode('.', $type); $class = $parts[0]; $method = false; if (isset($parts[1])) { $method = $parts[1]; } switch ($class) { case 'if': if (!isset($parameters[0])) { throw new phpbb_db_migration_exception('MIGRATION_INVALID_DATA_MISSING_CONDITION', $step); } if (!isset($parameters[1])) { throw new phpbb_db_migration_exception('MIGRATION_INVALID_DATA_MISSING_STEP', $step); } $condition = $parameters[0]; $step = $parameters[1]; $callable_and_parameters = $this->get_callable_from_step($step); $callable = $callable_and_parameters[0]; $sub_parameters = $callable_and_parameters[1]; return array( function ($condition) use ($callable, $sub_parameters) { return call_user_func_array($callable, $sub_parameters); }, array($condition) ); break; case 'custom': if (!is_callable($parameters[0])) { throw new phpbb_db_migration_exception('MIGRATION_INVALID_DATA_CUSTOM_NOT_CALLABLE', $step); } return array($parameters[0], array()); break; default: if (!$method) { throw new phpbb_db_migration_exception('MIGRATION_INVALID_DATA_UNKNOWN_TYPE', $step); } if (!isset($this->tools[$class])) { throw new phpbb_db_migration_exception('MIGRATION_INVALID_DATA_UNDEFINED_TOOL', $step); } if (!method_exists(get_class($this->tools[$class]), $method)) { throw new phpbb_db_migration_exception('MIGRATION_INVALID_DATA_UNDEFINED_METHOD', $step); } return array( array($this->tools[$class], $method), $parameters ); break; } } protected function insert_migration($name, $state) { $migration_row = $state; $migration_row['migration_name'] = $name; $sql = 'INSERT INTO ' . $this->migrations_table . ' ' . $this->db->sql_build_array('INSERT', $migration_row); $this->db->sql_query($sql); $this->migration_state[$name] = $state; } /** * Checks if a migration's dependencies can even theoretically be satisfied. * * @param string $name The class name of the migration * @return bool Whether the migration cannot be fulfilled */ public function unfulfillable($name) { if (isset($this->migration_state[$name])) { return false; } if (!class_exists($name)) { return true; } $migration = $this->get_migration($name); $depends = $migration->depends_on(); foreach ($depends as $depend) { if ($this->unfulfillable($depend)) { return true; } } return false; } /** * Checks whether all available, fulfillable migrations have been applied. * * @return bool Whether the migrations have been applied */ public function finished() { foreach ($this->migrations as $name) { if (!isset($this->migration_state[$name])) { // skip unfulfillable migrations, but fulfillables mean we // are not finished yet if ($this->unfulfillable($name)) { continue; } return false; } $migration = $this->migration_state[$name]; if (!$migration['migration_schema_done'] || !$migration['migration_data_done']) { return false; } } return true; } protected function apply_schema_changes($schema_changes) { $this->db_tools->perform_schema_changes($schema_changes); } /** * Helper to get a migration * * @param string $name Name of the migration * @return phpbb_db_migration */ protected function get_migration($name) { return new $name($this->config, $this->db, $this->db_tools, $this->phpbb_root_path, $this->php_ext, $this->table_prefix); } }