PHPackages waaseyaa/frankenphp - 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. [DevOps & Deployment](/categories/devops) 4. / 5. waaseyaa/frankenphp ActiveLibrary[DevOps & Deployment](/categories/devops) waaseyaa/frankenphp =================== Optional FrankenPHP dev-runtime for Waaseyaa — auto-installs the FrankenPHP binary and serves the app via `waaseyaa dev` (the Laravel Octane model). Not part of core/cms/full; default-installed in the skeleton. 00PHP Since Jun 20Pushed todayCompare [ Source](https://github.com/waaseyaa/frankenphp)[ Packagist](https://packagist.org/packages/waaseyaa/frankenphp)[ RSS](/packages/waaseyaa-frankenphp/feed)WikiDiscussions main Synced today READMEChangelogDependenciesVersions (1)Used By (0) waaseyaa/frankenphp =================== [](#waaseyaafrankenphp) Optional **FrankenPHP dev-runtime** for Waaseyaa — the Laravel Octane model. It adds two console commands and nothing else; the framework core stays runtime-agnostic (no FrankenPHP coupling), and the runtime-agnostic `waaseyaa serve` (plain `php -S`) remains the zero-dependency fallback in core. This package is **not** part of `waaseyaa/core`/`cms`/`full`. It ships in the whole-monorepo `waaseyaa/framework` meta, so the skeleton serves with `composer run dev` out of the box; apps on the curated metapackages opt in with `composer require waaseyaa/frankenphp`. Commands -------- [](#commands) ### `frankenphp:install` [](#frankenphpinstall) Downloads the correct FrankenPHP binary for the current OS/arch from the official [php/frankenphp](https://github.com/php/frankenphp) releases into the project's managed path (`vendor/bin/`), idempotently. After this the binary's location is never the operator's problem. - Per-OS/arch asset selection (Linux `x86_64`/`aarch64`, macOS `arm64`/`x86_64`, Windows `x86_64`), pinned to a known-good version (default `v1.12.4`; override with `--frankenphp-version` or `FRANKENPHP_VERSION`). - Verifies the download's sha256 against the GitHub release digest when available. - Windows: the release is a full PHP-for-Windows SDK zip — the **whole** archive is extracted into `vendor/bin/frankenphp-dist/` so `frankenphp.exe` finds its sibling DLLs. POSIX: a bare binary with the executable bit set. - Extraction uses ext-zip when present, else `tar` (Windows 10+ / macOS / Linux). Pure PHP, no shell. ### `dev` [](#dev) Serves the app with FrankenPHP in the foreground: ``` frankenphp php-server --root public --listen 127.0.0.1:8080 ``` Resolution order: `FRANKENPHP_BIN` → the managed install → known per-OS locations → `frankenphp` on `PATH` → otherwise it prints the one fix (`frankenphp:install`) and, when interactive, offers to run it. It execs the binary **by absolute path**with no shell (`proc_open` array form, inherited stdio so output is live and Ctrl-C stops it), and **never modifies `PATH`** — so FrankenPHP's bundled OpenSSL-disabled `php.exe` can never shadow system PHP and break Composer. Override the listen address with `WAASEYAA_DEV_LISTEN` (e.g. `0.0.0.0:9000`). The skeleton wires `composer run dev` → `@php vendor/bin/waaseyaa dev`, so the command runs under Composer's own (system) PHP, identically in Git Bash, PowerShell, cmd, and POSIX shells. Why a package ------------- [](#why-a-package) This permanently closes the "where is FrankenPHP / PATH shadowing / the shell can't find PHP" class of dev-server failures by removing both roots — shell fragility (the command is a discoverable PHP CLI command, not a shell script) and binary-location guessing (`frankenphp:install` fetches it to a known path). ### Health Score 21 — LowBetter than 18% of packages Maintenance65 Regular maintenance activity Popularity0 Limited adoption so far Community8 Small or concentrated contributor base Maturity11 Early-stage or recently created project Bus Factor1 Top contributor holds 60% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/25d0ff572e93e3461e5180a920725d65691fd1e15e2d914b254dbbc2d6c393bd?d=identicon)[jonesrussell](/maintainers/jonesrussell) --- Top Contributors [![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (3 commits)")[![jonesrussell](https://avatars.githubusercontent.com/u/499552?v=4)](https://github.com/jonesrussell "jonesrussell (2 commits)") ### Embed Badge ![Health badge](/badges/waaseyaa-frankenphp/health.svg) ``` [![Health](https://phpackages.com/badges/waaseyaa-frankenphp/health.svg)](https://phpackages.com/packages/waaseyaa-frankenphp) ``` ### Alternatives [felixfbecker/language-server PHP Implementation of the Visual Studio Code Language Server Protocol 1.2k95.7k](/packages/felixfbecker-language-server)[sarfraznawaz2005/servermonitor Laravel package to periodically monitor the health of your server and website. 19613.5k1](/packages/sarfraznawaz2005-servermonitor)[tiamo/phpas2 PHPAS2 is a php-based implementation of the EDIINT AS2 standard 4676.9k](/packages/tiamo-phpas2) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)