Type Definition ext_php_rs::types::ZendObject

pub type ZendObject = zend_object;

A PHP object.

This type does not maintain any information about its type, for example, classes with have associated Rust structs cannot be accessed through this type. ZendClassObject is used for this purpose, and you can convert between the two.

Implementations

impl ZendObject

pub fn new(ce: &ClassEntry) -> ZBox<Self>

Creates a new ZendObject, returned inside an ZBox<ZendObject> wrapper.

Parameters

• ce - The type of class the new object should be an instance of.

Panics

Panics when allocating memory for the new object fails.

pub fn new_stdclass() -> ZBox<Self>

Creates a new stdClass instance, returned inside an ZBox<ZendObject> wrapper.

Panics

Panics if allocating memory for the object fails, or if the stdClass class entry has not been registered with PHP yet.

Example

use ext_php_rs::types::ZendObject;

let mut obj = ZendObject::new_stdclass();

obj.set_property("hello", "world");

pub fn from_class_object<T: RegisteredClass>(
    obj: ZBox<ZendClassObject<T>>
) -> ZBox<Self>

Converts a class object into an owned ZendObject. This removes any possibility of accessing the underlying attached Rust struct.

pub fn get_class_name(&self) -> Result<String>

Attempts to retrieve the class name of the object.

pub fn is_instance<T: RegisteredClass>(&self) -> bool

Checks if the given object is an instance of a registered class with Rust type T.

pub fn get_property<'a, T>(&'a self, name: &str) -> Result<T> where
    T: FromZval<'a>, 

Attempts to read a property from the Object. Returns a result containing the value of the property if it exists and can be read, and an Error otherwise.

Parameters

• name - The name of the property.
• query - The type of query to use when attempting to get a property.

pub fn set_property(&mut self, name: &str, value: impl IntoZval) -> Result<()>

Attempts to set a property on the object.

Parameters

• name - The name of the property.
• value - The value to set the property to.

pub fn has_property(&self, name: &str, query: PropertyQuery) -> Result<bool>

Checks if a property exists on an object. Takes a property name and query parameter, which defines what classifies if a property exists or not. See PropertyQuery for more information.

Parameters

• name - The name of the property.
• query - The ‘query’ to classify if a property exists.

pub fn get_properties(&self) -> Result<&HashTable>

Attempts to retrieve the properties of the object. Returned inside a Zend Hashtable.

pub fn extract<'a, T>(&'a self) -> Result<T> where
    T: FromZendObject<'a>, 

Extracts some type from a Zend object.

This is a wrapper function around FromZendObject::extract().

Trait Implementations

impl Debug for ZendObject

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

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

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 ZendObject

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<'a> IntoZval for &'a mut ZendObject

const TYPE: DataType

The corresponding type of the implemented value in PHP.

fn set_zval(self, zv: &mut Zval, _: 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 PhpRc for ZendObject

fn get_rc(&self) -> &ZendRefcount

Returns an immutable reference to the corresponding refcount object.

fn get_rc_mut(&mut self) -> &mut ZendRefcount

Returns a mutable reference to the corresponding refcount object.

fn get_count(&self) -> u32

Returns the number of references to the object.

fn inc_count(&mut self)

Increments the reference counter by 1.

fn dec_count(&mut self)

Decrements the reference counter by 1.

impl ZBoxable for ZendObject

fn free(&mut self)

Frees the memory pointed to by self, calling any destructors required in the process.