Download the PHP package standa/php-v8js without Composer

On this page you can find all versions of the php package standa/php-v8js. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of standa/php-v8js

Informations about the package php-v8js

standa/php-v8js

PIE-installable wrapper for phpv8/v8js — V8 JavaScript Engine for PHP.

This repo packages the source from phpv8/v8js's php8 branch (pinned at SHA 8a39efa3cf3b275e402ddf3c4f6b611a5f69a499, 2026-04-19) as a Composer package that PIE (PHP Installer for Extensions) can install directly. The C/C++ source itself is unmodified; this repo only adds packaging files (composer.json, .gitattributes, CI, README).

Upstream has no composer.json and is not on Packagist; this wrapper fills that gap.

Supported PHP versions

The CI matrix builds and tests against PHP 8.1, 8.2, 8.3, 8.4, and 8.5 on Linux (x86_64 and arm64, NTS and TS). 8.5 is the current stable as of June 2026; upstream phpv8/v8js's own CI doesn't cover 8.5 yet, so this package is the first place 8.5 gets continuous coverage.

PHP 8.0 is EOL (Nov 2023) and explicitly out of scope. macOS is currently unable to publish prebuilt binaries (V8 14.x incompatibility — see Known limitations).

Install with PIE

Fast path — prebuilt binary

The asset that gets downloaded depends on your platform tuple — PIE picks the right one automatically. Do not pass --with-v8js on this path: PIE refuses prebuilts when configure options are passed (it can't know whether the prebuilt was built with the flag you wanted) and falls back to a source build instead.

The prebuilt was already linked against /usr/lib/libnode.so.* from the matching distro — no --with-v8js needed.

What pie install does (no flags, the prebuilt path)

  1. Resolves standa/php-v8js from Packagist
  2. Detects your platform tuple — php<X.Y>-<arch>-<os>-<libc>-<tsmode> — e.g. php8.4-arm64-linux-glibc-nts
  3. Matches and downloads the prebuilt .so archive from the release assets (asset name: php_v8js-<ver>_php<X.Y>-<arch>-<os>-<libc>-<tsmode>.zip)
  4. Extracts and installs the .so into the active PHP's extension directory; enables it via an INI file

No phpize, no ./configure, no make. ~10 seconds.

What prebuilt binaries ship per release

Each tag produces these binaries via .github/workflows/release.yml:

Platform PHP versions NTS TS libnode SOVERSION
linux-glibc-x86_64 (Debian trixie / php:X.Y-cli) 8.1, 8.2, 8.3, 8.4, 8.5 ✅ ✅ libnode.so.115
linux-glibc-arm64 (Debian trixie / php:X.Y-cli) 8.1, 8.2, 8.3, 8.4, 8.5 ✅ ✅ libnode.so.115
linux-musl-x86_64 (Alpine / php:X.Y-cli-alpine) 8.1, 8.2, 8.3, 8.4, 8.5 ✅ ✅ libnode.so.137
linux-musl-arm64 (Alpine arm64) — ❌ ❌ (GitHub Actions doesn't currently run JS actions inside arm64+musl containers — node20 runtime injection fails. Source build via --with-v8js=/usr is the fallback.) —
darwin-arm64 (macOS Apple Silicon) — ❌ ❌ (until v8js#546 lands) —
Windows — ❌ ❌ (out of scope — would need php/php-windows-builder) —

30 Linux binaries per release, each built inside the matching php:X.Y-{cli,zts}{,-alpine} container so the .so links against the libnode SOVERSION that actually ships with that base image. Users on hosts with a different SOVERSION (Ubuntu 22.04/24.04 = .109, custom Node build) won't be able to dynamically load these binaries — see the source-build escape hatch below.

Source-build escape hatch (any libv8/libnode version)

If you're on a host without a matching libnode SOVERSION (Ubuntu 22.04/24.04 = .109, custom Node build) — or PIE installs a prebuilt that fails to load at startup with cannot open shared object file — pass --with-v8js=PATH to force a source build against your local V8/Node headers:

The --with-v8js=PATH flag disables the prebuilt-binary download (PIE skips prebuilts when configure options are passed), then PIE downloads the source archive and runs phpize → ./configure → make against your local V8/Node headers. Slower (~30–60s) but works on any libv8/libnode SOVERSION.

⚠️ macOS users: Homebrew's v8 formula is currently 14.x, which the upstream php8 branch cannot build against yet (tracked at phpv8/v8js#546). Until that's resolved, the easiest macOS path is the Docker image at marekskopal/php-v8js. If you want a native install, see Known limitations → V8 14.x is not supported below for how to use V8 12.x.

Verify the install

If pie isn't installed yet

Follow PIE's install guide. On macOS: brew install pie. On Debian/Ubuntu the quickest path is:

PIE 1.4+ is required (1.3.x doesn't recognize the php-64bit platform package, among other resolver fixes).

Configure options

Flag Required What it does
--with-v8js=PATH Strongly recommended Path to your V8 install prefix. The upstream config.m4 auto-searches /usr/local and /usr, but passing the path explicitly avoids surprises on macOS / non-standard layouts.

Prerequisites

V8 itself is not distributed here. You must have V8 headers + a linkable libv8 (or, more commonly today, Node's bundled V8) installed before pie install runs. Recommended sources:

Known limitations

V8 14.x is not supported by upstream v8js yet

The php8 branch builds against V8 10.9, 11.x, 12.x, and 13.x. V8 14.6+ removed Local::Holder(), changed SetAlignedPointerInInternalField's signature, and replaced String::Write with WriteV2 — these require source patches in v8js that have not yet been merged. Track phpv8/v8js#546.

This means Homebrew users on a recent macOS may not get a working build because Homebrew's v8 formula is currently 14.8. Workarounds:

  1. Use the Docker image from marekskopal/php-v8js-docker which pins V8 12.9.203.
  2. Build an older V8 from source and pass --with-v8js=/your/path.

libv8 ABI mismatch on prebuilt binaries

Releases of this package ship prebuilt .so binaries (built against the libv8 that ships with the CI runner: ubuntu-24.04's libv8-dev and macos-14's Homebrew v8 at build time). If your system's libv8 minor version differs significantly, V8's Embedder-vs-V8 build configuration mismatch runtime check may abort new V8Js().

PIE's download-url-method: ["pre-packaged-binary", "composer-default"] setting means PIE tries a prebuilt binary first, then falls back to a source build if no matching asset exists for your platform tuple. Most users will hit the source path and avoid the issue entirely.

If you get a prebuilt that doesn't work, please open an issue with your php -i | head -30 and apt-cache policy libv8-dev (or brew info v8) output so a matching artifact can be added.

Windows is not supported

composer.json has os-families-exclude: ["windows"]. Adding Windows requires DLLs built via php/php-windows-builder; not done here. Windows users should use WSL2 + the Linux instructions above, or the Docker image.

Updating the vendored source

To resync to a newer upstream commit:

Local development

License

MIT — same as upstream phpv8/v8js. See LICENSE.

Credits

All actual extension code is from phpv8/v8js and its contributors (see CREDITS). This repository only adds packaging metadata.

All versions of php-v8js with dependencies

PHP Build Version
Package Version
Requires php Version ^8.1
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package standa/php-v8js contains the following files

Loading the files please wait ...