ext-php-rs 0.14.0

Bindings for the Zend API to build PHP extensions natively in Rust.
Documentation
use std::{path::PathBuf, process::Command};

use anyhow::{bail, Context, Result};

use crate::{find_executable, path_from_env, PHPInfo, PHPProvider};

pub struct Provider<'a> {
    info: &'a PHPInfo,
}

impl Provider<'_> {
    /// Runs `php-config` with one argument, returning the stdout.
    fn php_config(arg: &str) -> Result<String> {
        let cmd = Command::new(Self::find_bin()?)
            .arg(arg)
            .output()
            .context("Failed to run `php-config`")?;
        let stdout = String::from_utf8_lossy(&cmd.stdout);
        if !cmd.status.success() {
            let stderr = String::from_utf8_lossy(&cmd.stderr);
            bail!("Failed to run `php-config`: {} {}", stdout, stderr);
        }
        Ok(stdout.to_string())
    }

    fn find_bin() -> Result<PathBuf> {
        // If path is given via env, it takes priority.
        if let Some(path) = path_from_env("PHP_CONFIG") {
            if !path.try_exists()? {
                // If path was explicitly given and it can't be found, this is a hard error
                bail!("php-config executable not found at {:?}", path);
            }
            return Ok(path);
        }
        find_executable("php-config").with_context(|| {
            "Could not find `php-config` executable. \
            Please ensure `php-config` is in your PATH or the \
            `PHP_CONFIG` environment variable is set."
        })
    }
}

impl<'a> PHPProvider<'a> for Provider<'a> {
    fn new(info: &'a PHPInfo) -> Result<Self> {
        Ok(Self { info })
    }

    fn get_includes(&self) -> Result<Vec<PathBuf>> {
        Ok(Self::php_config("--includes")?
            .split(' ')
            .map(|s| s.trim_start_matches("-I"))
            .map(PathBuf::from)
            .collect())
    }

    fn get_defines(&self) -> Result<Vec<(&'static str, &'static str)>> {
        let mut defines = vec![];
        if self.info.thread_safety()? {
            defines.push(("ZTS", "1"));
        }
        Ok(defines)
    }

    fn print_extra_link_args(&self) -> Result<()> {
        #[cfg(feature = "embed")]
        println!("cargo:rustc-link-lib=php");

        Ok(())
    }
}