Add bindings for php_printf

Author: davidcole1340

allowed_bindings.rs

@@ -192,5 +192,6 @@ bind! {
     zend_objects_store_del,
     gc_possible_root,
     ZEND_ACC_NOT_SERIALIZABLE,
-    executor_globals
+    executor_globals,
+    php_printf
 }

src/lib.rs

@@ -44,6 +44,8 @@ pub mod prelude {
     pub use crate::php_function;
     pub use crate::php_impl;
     pub use crate::php_module;
+    pub use crate::php_print;
+    pub use crate::php_println;
     pub use crate::php_startup;
     pub use crate::types::ZendCallable;
     pub use crate::ZvalConvert;

src/macros.rs

@@ -362,5 +362,51 @@ macro_rules! try_from_zval {
     };
 }
 
+/// Prints to the PHP standard output, without a newline.
+///
+/// Acts exactly the same as the built-in [`print`] macro.
+///
+/// # Panics
+///
+/// Panics if the generated string could not be converted to a `CString` due to
+/// `NUL` characters.
+#[macro_export]
+macro_rules! php_print {
+    ($arg: tt) => {{
+        $crate::zend::printf($arg).expect("Failed to print to PHP stdout");
+    }};
+
+    ($($arg: tt) *) => {{
+        let args = format!($($arg)*);
+        $crate::zend::printf(args.as_str()).expect("Failed to print to PHP stdout");
+    }};
+}
+
+/// Prints to the PHP standard output, with a newline.
+///
+/// The newline is only a newline character regardless of platform (no carriage
+/// return).
+///
+/// Acts exactly the same as the built-in [`println`] macro.
+///
+/// # Panics
+///
+/// Panics if the generated string could not be converted to a `CString` due to
+/// `NUL` characters.
+#[macro_export]
+macro_rules! php_println {
+    () => {
+        $crate::php_print!("\n");
+    };
+
+    ($fmt: tt) => {
+        $crate::php_print!(concat!($fmt, "\n"));
+    };
+
+    ($fmt: tt, $($arg: tt) *) => {
+        $crate::php_print!(concat!($fmt, "\n"), $($arg)*);
+    };
+}
+
 pub(crate) use into_zval;
 pub(crate) use try_from_zval;

src/zend/mod.rs

@@ -9,10 +9,36 @@ mod globals;
 mod handlers;
 mod module;
 
+use crate::{error::Result, ffi::php_printf};
+use std::ffi::CString;
+
 pub use _type::ZendType;
 pub use class::ClassEntry;
 pub use ex::ExecuteData;
 pub use function::FunctionEntry;
 pub use globals::ExecutorGlobals;
 pub use handlers::ZendObjectHandlers;
 pub use module::ModuleEntry;
+
+// Used as the format string for `php_printf`.
+const FORMAT_STR: &[u8] = b"%s\0";
+
+/// Prints to stdout using the `php_printf` function.
+///
+/// Also see the [`php_print`] and [`php_println`] macros.
+///
+/// # Arguments
+///
+/// * message - The message to print to stdout.
+///
+/// # Returns
+///
+/// Nothing on success, error if the message could not be converted to a
+/// [`CString`].
+pub fn printf(message: &str) -> Result<()> {
+    let message = CString::new(message)?;
+    unsafe {
+        php_printf(FORMAT_STR.as_ptr().cast(), message.as_ptr());
+    };
+    Ok(())
+}