Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Installation

PIE is PHP’s installer for extensions:

pie install displace/ext-turbovec

PIE picks the pre-built binary for your PHP minor (8.3/8.4/8.5), platform (macOS arm64, Linux x86_64, Linux arm64), and thread-safety mode, drops it into your extension directory, and enables it.

Linux: OpenBLAS

The index engine links OpenBLAS on Linux. If the extension fails to load with a libopenblas.so.0: cannot open shared object file error:

sudo apt install libopenblas0        # Debian/Ubuntu
sudo dnf install openblas            # Fedora/RHEL

macOS needs nothing — the Accelerate framework ships with the OS.

From source

Requirements: Rust 1.89+ (rustup will pick up the repo’s toolchain pin), PHP 8.3+ with development headers (php-dev / php-config on PATH), libclang (libclang-dev), and on Linux libopenblas-dev.

git clone https://github.com/DisplaceTech/ext-turbovec
cd ext-turbovec
make release             # target/release/libturbovec.{so,dylib}

Load it ad hoc:

php -d extension=$PWD/target/release/libturbovec.so your-script.php

…or permanently, by adding extension=/path/to/libturbovec.so to your php.ini. make install (via cargo-php) automates the copy-and-enable.

Supported targets

PHP 8.3 / 8.4 / 8.5 on macOS arm64, Linux x86_64 (Haswell 2013+ for the SIMD fast path; older CPUs use a scalar fallback), and Linux arm64. Windows is not supported. See the compatibility matrix.