Context

MMO\admin\helpers · 1 symbole · générée le 27 Oct 2026

class

Context

Context.php:16

Everything one task needs to act on one target, and the place tasks hand results to each other:

class MMO\admin\helpers\Context

Espace de noms: MMO\admin\helpers
Voir: BuildTask fills $artifact, ShipTask reads it and fills $release,, ActivateTask reads that and fills $previous, and Runner turns the whole thing into one Deployment journal entry at the end.

A context is built once per (run, target) by the runner -- never by a task.

Index

	artifact
	backup
	checksum
	commit
	dependencies
	dryRun readonly
	interactive readonly
	journal readonly
	libraries
	live
	local readonly
	lock readonly
	options
	overlay
	patches
	previous
	release
	repository readonly
	scripts
	shell readonly
	startedAt readonly
	target readonly
	version
	debugName()
	error($message, $context)
	getName()
	getRelease()	The release this run is about.
	getReleaseFolder()
	isForced()
	option($name, $default)
	say($message, $context)	Print a message prefixed with the target's name, so a fan-out stays readable.
	toDeployment($outcome, $error)	Turn what the tasks recorded into the journal entry for this run.
	__construct($target, $dryRun, $interactive, $repository)

Propriétés23

artifact

?string $artifact = null

Type: null | string

backup

?string $backup = null

Type: null | string

checksum

?string $checksum = null

Type: null | string

commit

?string $commit = null

Type: null | string

dependencies

array $dependencies = []

Type: array

dryRun

readonly

readonly bool $dryRun

Type: bool

interactive

readonly

readonly bool $interactive

Type: bool

journal

readonly

readonly MMO\admin\helpers\Journal $journal

Type: Journal

libraries

array $libraries = []

Type: array

live

protected ?string $live = null

Type: null | string

local

readonly

readonly MMO\core\server\ShellRunner $local

Type: ShellRunner

lock

readonly

readonly MMO\admin\helpers\RemoteLock $lock

Type: RemoteLock

options

array $options = []

Type: array

overlay

?string $overlay = null

Type: null | string

patches

array $patches = []

Type: array

?string $previous = null

Type: null | string

release

string $release = ''

Type: string

repository

readonly

readonly ?MMO\core\interfaces\iRepository $repository

Type: null | iRepository

scripts

array $scripts = []

Type: array

shell

readonly

readonly MMO\core\server\ShellRunner $shell

Type: ShellRunner

startedAt

readonly

readonly float $startedAt

Type: float

target

readonly

readonly MMO\admin\entities\Target $target

Type: Target

version

string $version = ''

Type: string

Méthodes10

debugName()

Context.php:73

function debugName(): string

retourne

string

error($message, $context)

Context.php:116

function error(string $message, array $context = []): void

$message	string
$context = []	array
retourne	void

getName()

Context.php:75

function getName(): string

retourne

string

getRelease()

Context.php:85

The release this run is about.

function getRelease(): string

A run that ships nothing -- a database migration, a backup, a `cmd` -- still belongs to whatever release is live, so it is recorded against that one rather than against an empty string (which would look, to

Voir: ProductionController::printStatus, exactly like the target having drifted).

retourne

string

getReleaseFolder()

Context.php:96

function getReleaseFolder(): string

retourne

string

the absolute path of this run's release folder on the target.

isForced()

Context.php:107

function isForced(): bool

retourne

bool

option($name, $default)

Context.php:103

function option(string $name, mixed $default = null): mixed

$name	string
$default = null	mixed
retourne	mixed	a command-line option passed to this run.

say($message, $context)

Context.php:112

Print a message prefixed with the target's name, so a fan-out stays readable.

function say(string $message, array $context = []): void

$message	string
$context = []	array
retourne	void

toDeployment($outcome, $error)

Context.php:128

Turn what the tasks recorded into the journal entry for this run.

function toDeployment( string $outcome = MMO\admin\entities\Deployment::APPLIED, ?string $error = null ): MMO\admin\entities\Deployment

$outcome = MMO\admin\entities\Deployment::APPLIED	string	`Deployment::APPLIED` / FAILED / ROLLED_BACK
$error = null	null \| string
retourne	Deployment

__construct($target, $dryRun, $interactive, $repository)

Context.php:57

function __construct( MMO\admin\entities\Target $target, bool $dryRun = false, bool $interactive = false, ?MMO\core\interfaces\iRepository $repository = null )

$target	Target
$dryRun = false	bool
$interactive = false	bool
$repository = null	null \| iRepository