mirror of
https://github.com/flarum/core.git
synced 2025-10-13 16:05:05 +02:00
790d5beee5
This is probably the most complicated way I could find to fix #1587. Jokes aside, this was done with a few goals in mind: - Reduce coupling between the installer and the rest of Flarum's "Application", which we are building during installation. - Move the installer logic to several smaller classes, which can then be used by the web frontend and the console task, instead of the former hacking its way into the latter to be "DRY". - Separate installer infrastructure (the "pipeline", with the ability to revert steps upon failure) from the actual steps being taken. The problem was conceptual, and would certainly re-occur in a similar fashion if we wouldn't tackle it at its roots. It is fixed now, because we no longer use the ExtensionManager for enabling extensions, but instead duplicate some of its logic. That is fine because we don't want to do everything it does, e.g. omit extenders' lifecycle hooks (which depend on the Application instance being complete). > for each desired change, make the change easy (warning: this may be > hard), then make the easy change - Kent Beck, https://twitter.com/kentbeck/status/250733358307500032 Fixes #1587.
34 lines
731 B
PHP
34 lines
731 B
PHP
<?php
|
|
|
|
/*
|
|
* This file is part of Flarum.
|
|
*
|
|
* (c) Toby Zerner <toby.zerner@gmail.com>
|
|
*
|
|
* For the full copyright and license information, please view the LICENSE
|
|
* file that was distributed with this source code.
|
|
*/
|
|
|
|
namespace Flarum\Install;
|
|
|
|
interface Step
|
|
{
|
|
/**
|
|
* A one-line status message summarizing what's happening in this step.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getMessage();
|
|
|
|
/**
|
|
* Do the work that constitutes this step.
|
|
*
|
|
* This method should raise a `StepFailed` exception whenever something goes
|
|
* wrong that should result in the entire installation being reverted.
|
|
*
|
|
* @return void
|
|
* @throws StepFailed
|
|
*/
|
|
public function run();
|
|
}
|