provide access to return_value, function's type, filename, line number

When observing a function via observer API or zend_execute_*, these
additional functions allow looking up the function's type and the
filename (for user functions and eval'd code).
From ExecuteData we can also retrieve the return value in a number of
ways.

Author: brettmc

phper/src/functions.rs

@@ -647,6 +647,28 @@ impl ZFunc {
         }
     }
 
+    /// Get the type of the function (ZEND_USER_FUNCTION, ZEND_INTERNAL_FUNCTION, etc).
+    pub fn get_type(&self) -> u8 {
+        unsafe { self.inner.type_ as u8 }
+    }
+
+    /// For a user function or eval'd code, get the filename from op_array.
+    pub fn get_filename(&self) -> Option<&ZStr> {
+        unsafe {
+            match u32::from(self.inner.type_) {
+                ZEND_USER_FUNCTION | ZEND_EVAL_CODE => {
+                    let filename_ptr = self.inner.op_array.filename;
+                    if !filename_ptr.is_null() {
+                        ZStr::try_from_ptr(filename_ptr)
+                    } else {
+                        None
+                    }
+                }
+                _ => None,
+            }
+        }
+    }
+
     /// Get the function or method fully-qualified name.
     pub fn get_function_or_method_name(&self) -> ZString {
         unsafe {

phper/src/values.rs

@@ -130,6 +130,50 @@ impl ExecuteData {
         unsafe { ZFunc::from_mut_ptr(self.inner.func) }
     }
 
+    /// Gets the current opline line number if available. This represents the
+    /// line number in the source code where the current operation is being executed.
+    pub fn get_lineno(&self) -> Option<u32> {
+        unsafe {
+            match u32::from((*self.inner.func).type_) {
+                ZEND_USER_FUNCTION | ZEND_EVAL_CODE => {
+                    let opline = self.inner.opline;
+                    if !opline.is_null() {
+                        Some((*opline).lineno as u32)
+                    } else {
+                        None
+                    }
+                }
+                _ => None,
+            }
+        }
+    }
+
+    /// Gets associated return value.
+    pub fn get_return_value(&self) -> Option<&ZVal> {
+        unsafe {
+            let val = self.inner.return_value;
+            ZVal::try_from_ptr(val)
+        }
+    }
+
+    /// Gets associated return value.
+    pub fn get_return_value_mut(&mut self) -> Option<&mut ZVal> {
+        unsafe {
+            let val = self.inner.return_value;
+            ZVal::try_from_mut_ptr(val)
+        }
+    }
+
+    /// Gets associated return value pointer.
+    pub fn get_return_value_mut_ptr(&mut self) -> *mut ZVal {
+        self.inner.return_value as *mut ZVal
+    }
+
+    /// Gets associated return value pointer.
+    pub fn get_return_value_ptr(&self) -> *const ZVal {
+        self.inner.return_value as *const ZVal
+    }
+
     /// Gets associated `$this` object if exists.
     pub fn get_this(&mut self) -> Option<&ZObj> {
         unsafe {