fix(macro): allow multiple refs with self_

[Xenira]

Refs: #506

Description

Allow multiple refs with lifetime. e.g:

    pub fn self_multi_ref<'a>(
        self_: &'a mut ZendClassObject<TestClass>,
        val: &str,
    ) -> &'a mut ZendClassObject<TestClass> {
        self_.string = format!("Changed to {val}");
        self_
    }

Need to think this through though.

Checklist

Check the boxes that apply (put an x in the brackets, like [x]). You can also check boxes after the PR is created.

• I have read the contribution guidelines.
• I have added tests that prove my code works as expected.
• I have added documentation if applicable.
• I have added a migration guide if applicable.

❤️ Thank you for your contribution!

[coveralls]

Pull Request Test Coverage Report for Build 16248137065

Details

• 0 of 2 (0.0%) changed or added relevant lines in 1 file are covered.
• No unchanged relevant lines lost coverage.
• Overall coverage decreased (-0.006%) to 22.325%

---

Changes Missing Coverage	Covered Lines	Changed/Added Lines	%
crates/macros/src/function.rs	0	2	0.0%

Totals
Change from base Build 16247613957:	-0.006%
Covered Lines:	870
Relevant Lines:	3897

---

💛 - Coveralls

[Xenira]

@ptondereau do you see any reason why we sholdn't do this. Seems to be working and I see no unsafe code that could cause trouble here.

[Xenira]

Relevant generated code:

::ext_php_rs::builders::FunctionBuilder::new(
                                    "selfMultiRef",
                                    {
                                        extern "C" fn handler(
                                            ex: &mut ::ext_php_rs::zend::ExecuteData,
                                            retval: &mut ::ext_php_rs::types::Zval,
                                        ) {
                                            use ::ext_php_rs::convert::IntoZval;
                                            let mut val = ::ext_php_rs::args::Arg::new(
                                                "val",
                                                <&str as ::ext_php_rs::convert::FromZvalMut>::TYPE,
                                            );
                                            let result = {
                                                let (parse, this) = ex.parser_method::<TestClass>();
                                                let this = match this {
                                                    Some(this) => this,
                                                    None => {
                                                        ::ext_php_rs::exception::PhpException::default(
                                                                "Failed to retrieve reference to `$this`".into(),
                                                            )
                                                            .throw()
                                                            .unwrap();
                                                        return;
                                                    }
                                                };
                                                let parse_result = parse
                                                    .arg(&mut val)
                                                    .not_required()
                                                    .parse();
                                                if parse_result.is_err() {
                                                    return;
                                                }
                                                TestClass::self_multi_ref(
                                                    this,
                                                    {
                                                        match val.val() {
                                                            Some(val) => val,
                                                            None => {
                                                                ::ext_php_rs::exception::PhpException::default(
                                                                        "Invalid value given for argument `val`.".into(),
                                                                    )
                                                                    .throw()
                                                                    .expect("Failed to throw PHP exception.");
                                                                return;
                                                            }
                                                        }
                                                    },
                                                )
                                            };
                                            if let Err(e) = result.set_zval(retval, false) {
                                                let e: ::ext_php_rs::exception::PhpException = e.into();
                                                e.throw().expect("Failed to throw PHP exception.");
                                            }
                                        }
                                        handler
                                    },
                                )
                                .arg(
                                    ::ext_php_rs::args::Arg::new(
                                        "val",
                                        <&str as ::ext_php_rs::convert::FromZvalMut>::TYPE,
                                    ),
                                )
                                .not_required()
                                .returns(
                                    <&mut ZendClassObject< // <-- Lifetime dropped here
                                        TestClass,
                                    > as ::ext_php_rs::convert::IntoZval>::TYPE,
                                    false,
                                    <&mut ZendClassObject< // <-- And here
                                        TestClass,
                                    > as ::ext_php_rs::convert::IntoZval>::NULLABLE,
                                ),

[ptondereau]

No problem! To me, this is great!