# 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 generating or reviewing ext-php-rs PHP bindings for a Rust library.

- Skill: `goldziher/ext-php-rs-bindings` (Agent Skill)
- Install (CLI): `npx skillmds@latest add goldziher/ext-php-rs-bindings`
- Raw SKILL.md: https://api.skillmd.com/api/skills/goldziher/ext-php-rs-bindings/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: goldziher (https://skillmd.com/u/goldziher)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/goldziher/ext-php-rs-bindings

---


- Use `ext-php-rs` for PHP 8.2+ native extensions. Use `#[php_class]` and `#[php_function]` macros.
- Map Rust types to PHP via `FromZval`/`IntoZval` traits. Return `PhpResult<T>` for fallible operations.
- Map Rust errors to PHP exceptions: `PhpException::from(...)` with specific classes (`InvalidArgumentException`, `RuntimeException`).
- Use `#[php_method]` for class methods. Implement `__construct` for PHP constructors.
- Build with `cargo build --release`. Load extension via `php.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 `Drop` for 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.