ext-php-rs 0.5.0

Bindings for the Zend API to build PHP extensions natively in Rust.
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

# `&str`

A borrowed string. When this type is encountered, you are given a reference to
the actual zend string memory, rather than copying the contents like if you were
taking an owned `String` argument.

| `T` parameter | `&T` parameter | `&T` Return type | PHP representation       |
| ------------- | -------------- | ---------------- | ------------------------ |
| No            | Yes            | Yes              | `zend_string` (C-string) |

Note that you cannot expect the function to operate the same by swapping out
`String` and `&str` - since the zend string memory is read directly, this
library does not attempt to parse `double` types as strings.

See the [`String`](./string.md) for a deeper dive into the internal structure of
PHP strings.

## Rust example

```rust
# extern crate ext_php_rs;
# use ext_php_rs::prelude::*;
#[php_function]
pub fn str_example(input: &str) -> String {
    format!("Hello {}", input)
}

#[php_function]
pub fn str_return_example() -> &'static str {
    "Hello from Rust"
}
```

## PHP example

```php
<?php

var_dump(str_example("World")); // string(11) "Hello World"
var_dump(str_example(5)); // Invalid

var_dump(str_return_example());
```