ext-php-rs-bindings
ext-php-rs conventions for building PHP 8.2+ native extensions from a Rust core: php_class/php_function macros, Zval conversion, PhpException mapping, php.ini loading, and PHPUnit testing. Load when g
SKILL.mdinternal/builtins/bindings/ext-php-rs/skills/ext-php-rs-bindings/SKILL.md
GitHub- Use
ext-php-rsfor PHP 8.2+ native extensions. Use#[php_class]and#[php_function]macros. - Map Rust types to PHP via
FromZval/IntoZvaltraits. ReturnPhpResult<T>for fallible operations. - Map Rust errors to PHP exceptions:
PhpException::from(...)with specific classes (InvalidArgumentException,RuntimeException). - Use
#[php_method]for class methods. Implement__constructfor PHP constructors. - Build with
cargo build --release. Load extension viaphp.ini(extension=your_ext.so) or PECL distribution. - Test from PHP using PHPUnit. Verify extension loading with
php -m | grep extension_name. - Use
ZendClassObject<T>for wrapping Rust structs as PHP objects. - PHP uses reference counting — avoid circular references in wrapped Rust structs. Implement
Dropfor cleanup. - PHP is single-threaded per request — offload CPU-intensive work to Rust, return results synchronously.
- Keep PHP extension thin — business logic in Rust, PHP provides typed interface.
- Anti-patterns: panics in PHP functions, blocking operations without timeout, raw pointer manipulation.