PhpConfigEditor

MMO\admin\helpers · 1 symbol · generated 5 Oct 2026

class

PhpConfigEditor

Change values of one class's configuration in a PHP file -- the \MMO\config([...]) a project's scripts/bootstrap.php holds -- where they are written, leaving the rest of the file as a person wrote it.

class MMO\admin\helpers\PhpConfigEditor

Namespace: MMO\admin\helpers

The file is code someone reads: its comments say why each value is what it is. So nothing is regenerated. PHP's own tokenizer finds `Class::class => [ ... ]`, then `'key' => <expression>` directly inside it, and only that expression is replaced, by the new value written as PHP. A key the array does not have yet is added after its last one. It does not run the file, so it cannot tell what an expression evaluates to: the current values are the ones the running configuration holds. Lint what it returns (`php -l`) before writing it.

$php = new PhpConfigEditor(\MMO\core\files\get('scripts/bootstrap.php'), ProductionController::class); $php->set('postInstall', null); $php->set('buildCommands', ['php scripts/build-theme.php all --prod']); \MMO\core\files\set('scripts/bootstrap.php', $php->getCode());

Index

	class
	code
	debugName()
	entry($section, $key)
	export($value, $indent, $lines)
	getCode()
	has($key)
	hasSection()
	indentOf($pos)
	next($tokens, $i)
	section()
	set($key, $value)	Write $value as $key's expression.
	short()
	__construct($code, $class)

Properties2

class

protected string $class

Type: string

code

protected string $code

Type: string

Methods12

debugName()

PhpConfigEditor.php:37

function debugName(): string

returns

string

entry($section, $key)

PhpConfigEditor.php:143

protected function entry(array $section, string $key): ?array

$section	array	`section`
$key	string
returns	null \| array	int, 1: int, 2: string}\|null where $key's expression starts and ends, and the indentation of its line.

export($value, $indent, $lines)

PhpConfigEditor.php:202

protected function export(mixed $value, string $indent, bool $lines = false): string

$value	mixed
$indent	string	the indentation of the line the value is on.
$lines = false	bool	an array one item per line, even when it would fit on one.
returns	string	$value as PHP: short arrays, on one line when that stays short.

getCode()

PhpConfigEditor.php:39

function getCode(): string

returns

string

has($key)

PhpConfigEditor.php:45

function has(string $key): bool

$key	string
returns	bool	whether the class's configuration writes $key.

hasSection()

PhpConfigEditor.php:42

function hasSection(): bool

returns

bool

whether the file configures the class at all.

indentOf($pos)

PhpConfigEditor.php:190

protected function indentOf(int $pos): string

$pos	int
returns	string	the spaces and tabs the line holding $pos starts with.

next($tokens, $i)

PhpConfigEditor.php:182

protected function next(array $tokens, int $i): ?int

$tokens	array
$i	int
returns	null \| int	the index of the next token that is not whitespace or a comment.

section()

PhpConfigEditor.php:96

protected function section(): ?array

returns

null | array

int, 1: int, 2: string, 3: int|null}|null where the class's array opens and closes, the indentation of its entries, and where its last meaningful token ends (null for an empty array).

set($key, $value)

PhpConfigEditor.php:57

Write $value as $key's expression.

function set(string $key, mixed $value): static

$key	string
$value	mixed	null, a scalar, or an array of those.
returns	static
throws		when the file does not configure the class.

short()

PhpConfigEditor.php:88

protected function short(): string

returns

string

the class's short name.

__construct($code, $class)

PhpConfigEditor.php:32

function __construct(string $code, string $class)

$code	string	the PHP file's content.
$class	string	the class whose configuration array is edited, as `Foo::class` names it -- written in the file fully qualified or not, it is matched on its last part.