2.4 KiB
ext-php-rs
Bindings for the Zend API to build PHP extensions natively in Rust. Inspired by killertux/solder and its predecessors.
Features
This is not a set feature list, but these are the features on my roadmap. Create an issue if there's something you'd like to see!
- Module definitions
- Function implementation
- Class implementation
- Class methods
- Class properties
- Class constants
- Module constants
- Calling PHP functions
Requirements
- PHP 8.0 or later
- No support is planned for lower versions.
- Linux or Darwin-based OS
- Rust - no idea which version
- Clang 3.9 or greater
See the following links for the dependency crate requirements:
Usage
This project only works for PHP >= 8.0 (for now). Due to the fact that the PHP extension system relies heavily on C macros (which cannot be exported to Rust easily), structs have to be hard coded in.
There is only inline documentation for the time being. Starting by creating a C extension is a good start as well.
Check out one of the example projects:
- ext-skel - Testbed for testing the library. Check out previous commits as well to see what else is possible.
- opus-php - Work-in-progress extension to use the Opus library in PHP.
Contributions
Contributions are very much welcome. I am a novice Rust developer and any suggestions are wanted and welcome. Feel free to file issues and PRs through Github.
Resources
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE_APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE_MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.