Bootstrapper

Bootstrap the testbench environment.

Get the configuration attributes as an array.

Get the cached configuration instance.

Determine if the given path is the disposable runtime copy created by this process.

Remote child processes and predefined base paths use a runtime they do not own.

Get the skeleton directory the runtime copy created by this process was made from.

Static analysis tracks a copied file through its skeleton source, because the copy is deleted when the process exits.

Get the working package's vendor directory, which the runtime copy created by this process links when its skeleton has none.

Determine if the given path is a disposable runtime copy.

A remote child may borrow its parent's copy; the parent reports that when it starts the child. Borrowing a copy does not make the child its owner.

Get the application base path set explicitly through APP_BASE_PATH.

The lookup order matches the framework's base path inference, so the value is found whether or not PHP copies the process environment into $_ENV.

Get the persistent application base path a Testbench command runs on.

An explicit APP_BASE_PATH takes precedence over the configured skeleton. Tests never use the configured skeleton directly; they run on a disposable copy.

Get the filesystem instance.

Load and cache the configuration from the Yaml file.

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

Determine if the given path contains a testbench configuration file.

Make a relative COMPOSER_VENDOR_DIR absolute against the package root.

Applications run from a runtime copy or skeleton, including child processes that inherit this environment such as the skeleton's artisan, resolve a relative value against their own base path rather than the package root.

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.

Copy the skeleton into the runtime copy.

Preserve a configured skeleton's vendor link, or link the package's dependencies when the skeleton has none. Each worker can then discover installed packages without changing the shared skeleton or copying its dependencies.

Purge stale runtime copies left by interrupted test processes.

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

Determine the active Testbench environment file name.

Resolve the runtime base path for the current process.

Get the parent's base path that a remote child process shares.

Delete the disposable runtime copy.

Delete a runtime copy on a best-effort basis.

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

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.

Determine whether a process identity matches a Testbench serve runtime.

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.

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.

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.

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

Flush all static state.