alef 0.32.6

Opinionated polyglot binding generator for Rust libraries
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

// SAFETY: PHP objects are single-threaded; method calls are safe within a request.
let result = unsafe { (*self.inner).try_call_method("{{ method_name }}", {{ args_expr }}) };
{% if is_result_type %}
match result {
{% if is_unit_return %}
    Ok(_) => Ok(()),
{% elif is_primitive_return %}
    Ok(val) => {
        // For primitives, extract directly from Zval without JSON parsing
{% if return_type == "bool" %}
        let int_val = val.long().unwrap_or_default() != 0;
{% else %}
        let int_val = val.long().unwrap_or_default() as {{ return_type }};
{% endif %}
        Ok(int_val)
    }
{% else %}
    Ok(val) => {
{%- if native_return_binding %}
        // Native-object return: extract the host's native `#[php_class]` object and convert via
        // `From<{{ native_return_binding }}>` for core, falling back to the array/JSON path.
        if let Some(native) = <&{{ native_return_binding }} as ext_php_rs::convert::FromZval>::from_zval(&val) {
            Ok(native.clone().into())
        } else {
            let json_str = val.string().unwrap_or_default();
            serde_json::from_str(&json_str).map_err(|e| {{ deserialize_error_expr }})
        }
{%- else %}
        let json_str = val.string().unwrap_or_default();
        serde_json::from_str(&json_str).map_err(|e| {{ deserialize_error_expr }})
{%- endif %}
    }
{% endif %}
    Err(e) => Err({{ call_error_expr }}),
}
{% else %}
match result {
{% if is_unit_return %}
    Ok(_) => (),
{% elif is_primitive_return %}
    Ok(val) => match val.long() {
{% if return_type == "bool" %}
        Some(v) => v != 0,
{% else %}
        Some(v) => v as {{ return_type }},
{% endif %}
        None => {
            eprintln!("[{{ wrapper }}] host '{{ method_name }}' returned a non-integer value; returning default");
            Default::default()
        }
    },
{% else %}
    Ok(val) => {
{%- if native_return_binding %}
        if let Some(native) = <&{{ native_return_binding }} as ext_php_rs::convert::FromZval>::from_zval(&val) {
            native.clone().into()
        } else {
            match val.string() {
                Some(json_str) => match serde_json::from_str(&json_str) {
                    Ok(v) => v,
                    Err(e) => {
                        eprintln!("[{{ wrapper }}] host '{{ method_name }}' returned an unparseable value; returning default: {e}");
                        Default::default()
                    }
                },
                None => {
                    eprintln!("[{{ wrapper }}] host '{{ method_name }}' returned a non-string value; returning default");
                    Default::default()
                }
            }
        }
{%- else %}
        match val.string() {
            Some(json_str) => match serde_json::from_str(&json_str) {
                Ok(v) => v,
                Err(e) => {
                    eprintln!("[{{ wrapper }}] host '{{ method_name }}' returned an unparseable value; returning default: {e}");
                    Default::default()
                }
            },
            None => {
                eprintln!("[{{ wrapper }}] host '{{ method_name }}' returned a non-string value; returning default");
                Default::default()
            }
        }
{%- endif %}
    }
{% endif %}
    // This method's Rust signature is infallible, so a PHP exception cannot
    // propagate. Log before substituting the default — a silent default is
    // indistinguishable from a real result to the caller.
    Err(e) => {
        eprintln!("[{{ wrapper }}] host '{{ method_name }}' threw; {% if is_unit_return %}ignoring{% else %}returning default{% endif %}: {e}");
        Default::default()
    }
}
{% endif %}