The AMI_Package_Uninstall class

AMI_Package_Manipulator
   |
   --AMI_Package_InstanceManipulator
      |
      --AMI_Package_Uninstall

• Introduction

Transaction uninstalling CMS package.

• Class synopsis

AMI_Package_Uninstall extends AMI_Package_InstanceManipulator {

/* Properties */

// Module captions

protected array $aCaptions;

// Audit status for successfull transaction

protected string $auditSuccessStatus = 'deleted';

// Package install Id

protected int $installId;

// Transaction type for audit

protected string $transactionType = 'uninstall';

/* Inherited Properties */

// Processed module Ids

public AMI_Package_InstanceManipulator::$aProcessedEntities = array();

// Package info

protected AMI_Package_InstanceManipulator::$aPkgInfo;

// Flag specifying hypermodule/config is single instanced

protected AMI_Package_InstanceManipulator::$isSingleInstance;

// Module Id

protected AMI_Package_InstanceManipulator::$modId;

// Package Id

protected AMI_Package_InstanceManipulator::$pkgId;

// Hypermodule/config for single instanced or module Id

protected AMI_Package_InstanceManipulator::$processingEntity;

// Module section

protected AMI_Package_InstanceManipulator::$section;

// Module tab order

protected AMI_Package_InstanceManipulator::$tabOrder;

public AMI_Package_Manipulator::$oPkgCommon;

// Array containing class methods to run

protected AMI_Package_Manipulator::$aActions = array();

// Array of transactions

protected AMI_Package_Manipulator::$aTx = array();

// Used to store previous exception

protected AMI_Package_Manipulator::$oException;

// Name for transactions, must be filled in children

protected AMI_Package_Manipulator::$txName;

/* Methods */

// Constructor.

public __construct ( string $modId, [ int $mode = AMI_iTx_Cmd::MODE_COMMON ] ) returns AMI_Package_Uninstall;

// Returns module Id.

public getModId ( ) returns string;

// Update state in record of mod manager history table.

protected logFinish ( ) returns void;

// Create record in mod manager history table.

protected logStart ( ) returns void;

// Uninstall instances from package.

protected uninstallInstances ( ) returns void;

/* Inherited Methods */

// Resource list filter callback.

protected AMI_Package_InstanceManipulator::cbFilterResourceList ( string $file ) returns bool;

// Transaction action.

protected AMI_Package_InstanceManipulator::checkProcessed ( ) returns void;

// Returns config resource content.

protected AMI_Package_InstanceManipulator::getContentByResource ( string $resource ) returns string;

// Returns resources by type.

protected AMI_Package_InstanceManipulator::getResources ( string $type ) returns array;

// Initialization.

protected AMI_Package_InstanceManipulator::init ( ) returns void;

// Returns TRUE if hypermodule/config specifies meta has according property.

protected AMI_Package_InstanceManipulator::isSingleInstance ( ) returns bool;

// Validates initial data.

protected AMI_Package_InstanceManipulator::validate ( ) returns void;

// Do actions.

public AMI_Package_Manipulator::doActions ( ) returns void;

// Runs transactions.

public AMI_Package_Manipulator::run ( ) returns void;

// Adds action.

protected AMI_Package_Manipulator::addAction ( string $method, [ $aArgs = null ] ) returns void;

// Commits transactions.

protected AMI_Package_Manipulator::commit ( ) returns void;

// Converts mode to string representation for logging.

protected AMI_Package_Manipulator::getModeAsString ( int $mode ) returns string;

// Initializes transactions.

protected AMI_Package_Manipulator::initTx ( ) returns void;

// Rollbacks transactions.

protected AMI_Package_Manipulator::rollback ( [ int $index = 0 ] ) returns void;

// Validates initial data.

protected AMI_Package_Manipulator::validate ( ) returns void;

}

• Class Details

Example:

// Root script context
$AMI_ENV_SETTINGS = array(
'mode' => 'full',
'disable_cache' => TRUE
);
require_once 'ami_env.php';
$oResponse = AMI::getSingleton('response');
$oResponse->start();
$modId = 'inst_ami_sample'
$oModManipulator = new AMI_PackageUninstall(
$pkgId
AMI_iTx_Cmd::MODE_COMMON
);
try{
$oModManipulator->run();
// Success uninstallation
// ...
}catch(AMI_Exception $oExeception){
// Uninstallation failed
d::w('<span style="color: red;">' . $oException->getMessage() . '</span>');
d::trace($oException->getTrace());
}
$oResponse->send();

Tags:

since

6.0.2

• Class Properies

protected array $aCaptions: Module captions

protected string $auditSuccessStatus: Audit status for successfull transaction

protected int $installId: Package install Id

protected string $transactionType: Transaction type for audit

• Class Methods

// Constructor.

public __construct ( string $modId, [ int $mode = AMI_iTx_Cmd::MODE_COMMON ] ) returns AMI_Package_Uninstall;

string $modId
Module Id
int $mode
Flags specifying uninstallation mode, AMI_iTx_Cmd::MODE_*

// Returns module Id.

public getModId ( ) returns string;

// Update state in record of mod manager history table.

protected logFinish ( ) returns void;

Tags:

throws

AMI_Tx_Exception In case of problems.

// Create record in mod manager history table.

protected logStart ( ) returns void;

// Uninstall instances from package.

protected uninstallInstances ( ) returns void;

Tags:

throws

AMI_Tx_Exception In case of problems.