1. class
  2. Hypervel
  3. \
  4. Testbench
  5. \
  6. Bootstrapper

Bootstrapper

class Bootstrapper

Constants

protected RUNTIME_PROCESS_MARKER

Properties

static protected Config|null $configuration
static protected Filesystem|null $filesystem
static protected string|null $runtimePath

The path to the disposable runtime copy of the workbench.

Methods

static void
bootstrap()

Bootstrap the testbench environment.

static array
getConfig()

Get the configuration attributes as an array.

static Config|null
getConfiguration()

Get the cached configuration instance.

static Filesystem
getFilesystem()

Get the filesystem instance.

static void
loadConfigFromYaml(string $workingPath, string|null $filename = 'testbench.yaml', array $defaults = [])

No description

static string
resolveConfigurationPath(string $workingPath)

Resolve the directory that owns the active testbench.yaml file.

static bool
hasConfigurationFile(string $workingPath, string $filename = 'testbench.yaml')

Determine if the given path contains a testbench configuration file.

static string
createRuntimeCopy(string $sourcePath, string $workingPath)

Create a disposable runtime copy of the skeleton directory.

static void
purgeStaleRuntimeCopies(string $tempDirectory, int $pid)

Purge stale runtime copies left by interrupted test processes.

static void
copyPackageEnvironmentFile(Filesystem $filesystem, string $runtimePath, string $workingPath)

Copy the package or workbench environment file into the runtime copy.

static string
testbenchEnvironmentFile()

Determine the active Testbench environment file name.

static string
resolveRuntimeBasePath(string $sourcePath, string $workingPath)

Resolve the runtime base path for the current process.

static void
deleteRuntimeCopy()

Delete the disposable runtime copy.

static void
deleteRuntimeDirectory(string $directory)

Delete a runtime copy on a best-effort basis.

static bool
isOrphanedServeProcess(int $pid, string $runtimeDir)

Determine if the given PID is an orphaned serve process.

static bool
matchesServeProcessIdentity(int $pid, string $runtimeDir)

Determine whether a process identity matches a Testbench serve runtime.

static string|null
processStartIdentity(int $pid)

Read the OS identity of the process incarnation.

static void
killProcessTree(int $pid)

Kill a process and all its descendants.

static array
collectDescendants(int $rootPid)

Collect all descendant PIDs of the given PID in depth-first order.

static array
buildChildrenMap()

Build a map of PID → direct child PIDs by scanning /proc once.

static void
flushState()

Flush all static state.

Details

at line 36
static void bootstrap()

Bootstrap the testbench environment.

Return Value

void

at line 67
static array getConfig()

Get the configuration attributes as an array.

Return Value

array

at line 77
static Config|null getConfiguration()

Get the cached configuration instance.

Return Value

Config|null

at line 85
static protected Filesystem getFilesystem()

Get the filesystem instance.

Return Value

Filesystem

at line 94
static protected void loadConfigFromYaml(string $workingPath, string|null $filename = 'testbench.yaml', array $defaults = [])

No description

Parameters

string $workingPath
string|null $filename
array $defaults

Return Value

void

at line 102
static string resolveConfigurationPath(string $workingPath)

Resolve the directory that owns the active testbench.yaml file.

Parameters

string $workingPath

Return Value

string

at line 116
static protected bool hasConfigurationFile(string $workingPath, string $filename = 'testbench.yaml')

Determine if the given path contains a testbench configuration file.

Parameters

string $workingPath
string $filename

Return Value

bool

at line 135
static protected string createRuntimeCopy(string $sourcePath, string $workingPath)

Create a disposable runtime copy of the skeleton directory.

Tests write generated files (make:provider, make:model, etc.) and mutate bootstrap/providers.php into the app's basePath. By copying the skeleton to a temp directory and using that as BASE_PATH, the committed skeleton stays clean. The copy is deleted on shutdown.

Parameters

string $sourcePath
string $workingPath

Return Value

string

at line 212
static protected void purgeStaleRuntimeCopies(string $tempDirectory, int $pid)

Purge stale runtime copies left by interrupted test processes.

Parameters

string $tempDirectory
int $pid

Return Value

void

at line 264
static protected void copyPackageEnvironmentFile(Filesystem $filesystem, string $runtimePath, string $workingPath)

Copy the package or workbench environment file into the runtime copy.

Parameters

Filesystem $filesystem
string $runtimePath
string $workingPath

Return Value

void

at line 281
static protected string testbenchEnvironmentFile()

Determine the active Testbench environment file name.

Return Value

string

at line 293
static protected string resolveRuntimeBasePath(string $sourcePath, string $workingPath)

Resolve the runtime base path for the current process.

Parameters

string $sourcePath
string $workingPath

Return Value

string

at line 308
static protected void deleteRuntimeCopy()

Delete the disposable runtime copy.

Return Value

void

at line 324
static protected void deleteRuntimeDirectory(string $directory)

Delete a runtime copy on a best-effort basis.

Callers that require the path to be absent must verify that postcondition.

Parameters

string $directory

Return Value

void

at line 341
static protected bool isOrphanedServeProcess(int $pid, string $runtimeDir)

Determine if the given PID is an orphaned serve process.

A process is considered an orphaned serve process only when its parent is init and its PID file and process incarnation match the runtime.

Parameters

int $pid
string $runtimeDir

Return Value

bool

at line 376
static protected bool matchesServeProcessIdentity(int $pid, string $runtimeDir)

Determine whether a process identity matches a Testbench serve runtime.

Parameters

int $pid
string $runtimeDir

Return Value

bool

at line 422
static protected string|null processStartIdentity(int $pid)

Read the OS identity of the process incarnation.

Linux exposes the start clock tick exactly. macOS lstart has one-second resolution, the most precise portable process-start identity available there.

Parameters

int $pid

Return Value

string|null

at line 457
static protected void killProcessTree(int $pid)

Kill a process and all its descendants.

Collects the full descendant tree first (single /proc scan), then kills leaves before parents to avoid re-parenting races where killing a parent causes its children to be adopted by init before we can find them.

Parameters

int $pid

Return Value

void

at line 482
static protected array collectDescendants(int $rootPid)

Collect all descendant PIDs of the given PID in depth-first order.

Scans /proc once to build a PID→children map, then walks the subtree. Returns PIDs in parent-before-children order.

Parameters

int $rootPid

Return Value

array

at line 506
static protected array buildChildrenMap()

Build a map of PID → direct child PIDs by scanning /proc once.

Return Value

array

at line 551
static void flushState()

Flush all static state.

Return Value

void