README

A collection of Silverstripe BuildTask classes and standard helpers for managing a migration workflow (i.e version 3 to 4 upgrades).

Installation

composer require wilr/silverstripe-tasker

Usage

<?php

use Wilr\SilverStripe\Tasker\Traits\TaskHelpers;
use Wilr\SilverStripe\Tasker\Traits\TaskerFormatter;
use SilverStripe\Dev\BuildTask;

class MyAppUpgradeTask extends BuildTask
{
 use TaskerFormatter;
 use TaskHelpers;

 public function run()
 {
 $this->echoHeading('My Heading');
 
 $this->archivePage(10);
 
 // any other tasks as below.
 
 if ($wrong) {
 $this->echoWarning('Shows a warning message');
 } else {
 $this->echoSuccess('Outputs a tick');
 }

 while (true) {
 // displays progress dots
 $this->echoProgress();
 }
 }
}

API Documentation

Tasks

• migrateTableToExistingTable ($tableName, $newClass, $mapping = [], $callback = null, $insert = true)
• archivePage($pageID)
• runInsertOrUpdate($table, $id, $fields)
• migrateDataColumnTo($columnFrom, $tableFrom, $columnTo, $tableTo)
• setInvalidEnumValuesTo ($table, $column, $defaultValue)
• correctPageClass ($id, $newClassName)
• renameColumn ($table, $oldColumn, $newColumn, $force = false)
• removePagesOnLiveNotOnDraft()

Helpers

• hasTable ($tableName)
• query ($query)
• tableHasCol ($table, $col)
• echoWarning ($message)
• echoSuccess ($message)
• echoMessage ($message)
• echoLine ()
• echoProgress ()

SilverStripe Platform / CWP Deployment Tasks

tasker can be be used to 'hook' updates and other classes when dev/build is run. To do this, create a migration.yml file in your project and include the following:

SilverStripe\CMS\Model\SiteTree:
 migration_on_build: true
 latest_schema_version: 2
 migration_class: 'MyAppUpgradeTask'

Schema version is stored on SiteConfig, if a project has a Schema version less than the value provided here, tasker will run the provided migration_class.

If you have a series of BuildTask jobs to execute (such as a Solr_Reindex) then provide the class names under the key tasker_jobs.

SilverStripe\CMS\Model\SiteTree:
 tasker_jobs:
 - 'SilverStripe\FullTextSearch\Solr\Tasks\Solr_Configure'
 - 'SilverStripe\FullTextSearch\Solr\Tasks\Solr_Reindex'