AzuraCast/app/modules/frontend/controllers/SetupController.php

<?php
namespace Modules\Frontend\Controllers;

use Entity\Settings;
use Entity\Station;
use Entity\SettingsRepository;

class SetupController extends BaseController
{
    public function init()
    {
        return NULL;
    }

    /**
     * Setup Routing Controls
     */
    public function indexAction()
    {
        $current_step = $this->_getSetupStep();
        return $this->redirectFromHere(['action' => $current_step]);
    }

    /**
     * Placeholder function for "setup complete" redirection.
     */
    public function completeAction()
    {
        $this->alert('<b>'._('Setup has already been completed!').'</b>', 'red');

        return $this->redirectHome();
    }
    
    /**
     * Setup Step 1:
     * Create Super Administrator Account
     */
    public function registerAction()
    {
        // Verify current step.
        $current_step = $this->_getSetupStep();
        if ($current_step != 'register')
            return $this->redirectFromHere(['action' => $current_step]);

        // Create first account form.
        if (!empty($_POST['username']) && !empty($_POST['password']))
        {
            $data = $_POST;

            // Create actions and roles supporting Super Admninistrator.
            $role = new \Entity\Role;
            $role->name = _('Super Administrator');
            $this->em->persist($role);
            $this->em->flush();

            $rha = new \Entity\RolePermission;
            $rha->fromArray($this->em, [
                'role' => $role,
                'action_name' => 'administer all',
            ]);
            $this->em->persist($rha);

            // Create user account.
            $user = new \Entity\User;
            $user->email = $data['username'];
            $user->setAuthPassword($data['password']);
            $user->roles->add($role);
            $this->em->persist($user);

            // Write to DB.
            $this->em->flush();

            // Log in the newly created user.
            $this->auth->authenticate($data['username'], $data['password']);

            return $this->redirectFromHere(['action' => 'index']);
        }
    }

    /**
     * Setup Step 2:
     * Create Station and Parse Metadata
     */
    public function stationAction()
    {
        // Verify current step.
        $current_step = $this->_getSetupStep();
        if ($current_step != 'station')
            return $this->redirectFromHere(['action' => $current_step]);

        // Set up station form.
        $form_config = $this->module_config['admin']->forms->station->toArray();
        unset($form_config['groups']['admin']);
        unset($form_config['groups']['profile']['legend']);

        $form = new \App\Form($form_config);

        if (!empty($_POST) && $form->isValid($_POST))
        {
            $data = $form->getValues();

            $station_repo = $this->em->getRepository(Station::class);
            $station_repo->create($data, $this->di);

            return $this->redirectFromHere(['action' => 'settings']);
        }

        $this->view->form = $form;
    }

    /**
     * Setup Step 3:
     * Set site settings.
     */
    public function settingsAction()
    {
        // Verify current step.
        $current_step = $this->_getSetupStep();

        if ($current_step != 'settings')
            return $this->redirectFromHere(['action' => $current_step]);

        $form = new \App\Form($this->module_config['admin']->forms->settings->form);

        /** @var SettingsRepository $settings_repo */
        $settings_repo = $this->em->getRepository(Settings::class);

        $existing_settings = $settings_repo->fetchArray(FALSE);
        $form->setDefaults($existing_settings);

        if ($this->request->getMethod() == 'POST' && $form->isValid($this->request->getQueryParams()))
        {
            $data = $form->getValues();

            // Mark setup as complete along with other settings changes.
            $data['setup_complete'] = time();

            $settings_repo->setSettings($data);

            // Notify the user and redirect to homepage.
            $this->alert('<b>'._('Setup is now complete!').'</b><br>'._('Continue setting up your station in the main AzuraCast app.'), 'green');
            return $this->redirectHome();
        }

        return $this->renderForm($form, 'edit', _('Site Settings'));
    }

    /**
     * Determine which step of setup is currently active.
     * 
     * @return string
     * @throws \App\Exception\NotLoggedIn
     */
    protected function _getSetupStep()
    {
        if ($this->em->getRepository('Entity\Settings')->getSetting('setup_complete', 0) != 0)
            return 'complete';

        // Step 1: Register
        $num_users = $this->em->createQuery('SELECT COUNT(u.id) FROM Entity\User u')->getSingleScalarResult();
        if ($num_users == 0)
            return 'register';

        // If past "register" step, require login.
        if (!$this->auth->isLoggedIn())
            throw new \App\Exception\NotLoggedIn;

        // Step 2: Set up Station
        $num_stations = $this->em->createQuery('SELECT COUNT(s.id) FROM Entity\Station s')->getSingleScalarResult();
        if ($num_stations == 0)
            return 'station';

        // Step 3: System Settings
        return 'settings';
    }
}