Struct Closure 

pub struct Closure(/* private fields */);

Available on crate feature closure only.

Wrapper around a Rust closure, which can be exported to PHP.

Closures can have up to 8 parameters, all must implement FromZval, and can return anything that implements IntoZval. Closures must have a static lifetime, and therefore cannot modify any self references.

Internally, closures are implemented as a PHP class. A class RustClosure is registered with an __invoke method:

<?php

class RustClosure {
    public function __invoke(...$args): mixed {
        // ...
    }
}

The Rust closure is then double boxed, firstly as a Box<dyn Fn(...) -> ...> (depending on the signature of the closure) and then finally boxed as a Box<dyn PhpClosure>. This is a workaround, as PhpClosure is not generically implementable on types that implement Fn(T, ...) -> Ret. Make a suggestion issue if you have a better idea of implementing this!.

When the __invoke method is called from PHP, the invoke method is called on the dyn PhpClosure\ trait object, and from there everything is basically the same as a regular PHP function.

Implementations

impl Closure

pub fn wrap<T>(func: T) -> Self

where T: PhpClosure + 'static,

Wraps a Fn or FnMut Rust closure into a type which can be returned to PHP.

The closure can accept up to 8 arguments which implement IntoZval, and can return any type which implements FromZval. The closure must have a static lifetime, so cannot reference self.

Parameters

• func - The closure to wrap. Should be boxed in the form Box<dyn Fn[Mut](...) -> ...>.

Example

use ext_php_rs::closure::Closure;

let closure = Closure::wrap(Box::new(|name| {
    format!("Hello {}", name)
}) as Box<dyn Fn(String) -> String>);

pub fn wrap_once<T>(func: T) -> Self

where T: PhpOnceClosure + 'static,

Wraps a FnOnce Rust closure into a type which can be returned to PHP. If the closure is called more than once from PHP, an exception is thrown.

The closure can accept up to 8 arguments which implement IntoZval, and can return any type which implements FromZval. The closure must have a static lifetime, so cannot reference self.

Parameters

• func - The closure to wrap. Should be boxed in the form Box<dyn FnOnce(...) -> ...>.

Example

use ext_php_rs::closure::Closure;

let name: String = "Hello world".into();
let closure = Closure::wrap_once(Box::new(|| {
    name
}) as Box<dyn FnOnce() -> String>);

pub fn build()

Builds the class entry for Closure, registering it with PHP. This function should only be called once inside your module startup function.

If the class has already been built, this function returns early without doing anything. This allows for safe repeated calls in test environments.

Panics

Panics if the RustClosure PHP class cannot be registered.

Trait Implementations

impl<'a> FromZendObject<'a> for &'a Closure

fn from_zend_object(obj: &'a ZendObject) -> Result<Self>

Extracts Self from the source ZendObject.

impl<'a> FromZendObjectMut<'a> for &'a mut Closure

fn from_zend_object_mut(obj: &'a mut ZendObject) -> Result<Self>

Extracts Self from the source ZendObject.

impl<'a> FromZval<'a> for &'a Closure

const TYPE: DataType

The corresponding type of the implemented value in PHP.

fn from_zval(zval: &'a Zval) -> Option<Self>

Attempts to retrieve an instance of Self from a reference to a Zval.

impl<'a> FromZvalMut<'a> for &'a mut Closure

const TYPE: DataType

The corresponding type of the implemented value in PHP.

fn from_zval_mut(zval: &'a mut Zval) -> Option<Self>

Attempts to retrieve an instance of Self from a mutable reference to a Zval.

impl IntoZendObject for Closure

fn into_zend_object(self) -> Result<ZBox<ZendObject>>

Attempts to convert self into a Zend object.

impl IntoZval for Closure

const TYPE: DataType

The corresponding type of the implemented value in PHP.

const NULLABLE: bool = false

Whether converting into a Zval may result in null.

fn set_zval(self, zv: &mut Zval, persistent: bool) -> Result<()>

Sets the content of a pre-existing zval. Returns a result containing nothing if setting the content was successful.

fn into_zval(self, persistent: bool) -> Result<Zval>

Converts a Rust primitive type into a Zval. Returns a result containing the Zval if successful.

impl RegisteredClass for Closure

const CLASS_NAME: &'static str = "RustClosure"

PHP class name of the registered class.

const BUILDER_MODIFIER: Option<fn(ClassBuilder) -> ClassBuilder> = None

Function to be called when building the class. Allows user to modify the class at runtime (add runtime constants etc).

const EXTENDS: Option<ClassEntryInfo> = None

Parent class entry. Optional.

const IMPLEMENTS: &'static [ClassEntryInfo]

Interfaces implemented by the class.

fn get_metadata() -> &'static ClassMetadata<Self>

Returns a reference to the class metadata, which stores the class entry and handlers.

fn get_properties<'a>() -> HashMap<&'static str, PropertyInfo<'a, Self>>

Returns a hash table containing the properties of the class.

fn method_builders() -> Vec<(FunctionBuilder<'static>, MethodFlags)>

Returns the method builders required to build the class.

fn constructor() -> Option<ConstructorMeta<Self>>

Returns the class constructor (if any).

fn constants() -> &'static [(&'static str, &'static dyn IntoZvalDyn, DocComments)]

Returns the constants provided by the class.

const FLAGS: ClassFlags = _

PHP flags applied to the class.

const DOC_COMMENTS: DocComments = _

Doc comments for the class.

fn static_properties() -> &'static [(&'static str, PropertyFlags, Option<&'static (dyn IntoZvalDyn + Sync)>, DocComments)]

Returns the static properties provided by the class.

impl Send for Closure

impl Sync for Closure