PHPackages                             liquidrazor/posix-runtime - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. liquidrazor/posix-runtime

ActiveLibrary[Utility & Helpers](/categories/utility)

liquidrazor/posix-runtime
=========================

POSIX runtime primitives for isolated worker execution in LiquidRazor.

v0.1.0(2mo ago)021MITPHPPHP ^8.3

Since May 10Pushed 2mo agoCompare

[ Source](https://github.com/LiquidRazor/POSIXRuntime)[ Packagist](https://packagist.org/packages/liquidrazor/posix-runtime)[ RSS](/packages/liquidrazor-posix-runtime/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (1)Versions (2)Used By (1)

LiquidRazor POSIX Runtime
=========================

[](#liquidrazor-posix-runtime)

`liquidrazor/posix-runtime` is a small PHP 8.3+ library that provides POSIX runtime primitives for isolated worker execution.

It is transport-agnostic process-control infrastructure for the LiquidRazor micro-kernel lifecycle. It does not implement HTTP, CLI, queue, gRPC, routing, DI, logging, scheduling, or daemon management.

Requirements
------------

[](#requirements)

- PHP `8.3+`
- `ext-posix`
- `ext-pcntl`

Missing required extensions are treated as runtime failures. The library does not silently degrade to PID-only supervision.

What It Ships
-------------

[](#what-it-ships)

Current public surface:

- immutable value objects under `include/Value`
- enums under `include/Enum`
- typed exceptions under `include/Exception`
- public contracts under `include/Contract`
- a thin public facade: `LiquidRazor\PosixRuntime\PosixRuntime`

Current runtime behavior:

- worker identity generation
- worker process metadata before and after fork
- centralized POSIX/PCNTL adapter boundary
- raw wait-status interpretation
- signal handler registration
- pending-signal dispatch
- child execution wrapping
- parent-side worker supervision
- graceful shutdown requests
- forced termination escalation

What It Does Not Ship
---------------------

[](#what-it-does-not-ship)

This library does not implement:

- transport kernels
- framework bootstrapping
- event manager infrastructure
- process event catalogs
- service containers
- schedulers
- external process-manager replacement behavior

Higher-level kernels are expected to plug into the runtime lifecycle exposed here.

Public API
----------

[](#public-api)

The main entry point is `LiquidRazor\PosixRuntime\PosixRuntime`.

It currently exposes:

- `capabilityStatus(): RuntimeCapabilityStatus`
- `assertAvailable(): void`
- `run(WorkerExecutionRequest $request): SupervisionResult`
- `shutdown(WorkerProcessMetadata $metadata, ShutdownRequest $request): SupervisionResult`

Typical value types involved in public calls:

- `WorkerId`
- `WorkerIdentity`
- `ProcessId`
- `WorkerProcessMetadata`
- `WorkerExecutionRequest`
- `WorkerExecutionResult`
- `WorkerExitStatus`
- `ShutdownRequest`
- `SupervisionResult`

Example
-------

[](#example)

```