Struct PhpBridgeGenerator 

pub struct PhpBridgeGenerator {
    pub core_import: String,
    pub type_paths: HashMap<String, String>,
    pub error_type: String,
    pub struct_param_types: HashSet<String>,
    pub struct_return_types: HashSet<String>,
    pub forwardable_defaulted: HashSet<String>,
}

PHP-specific trait bridge generator. Implements code generation for bridging PHP objects to Rust traits.

Fields

core_import: String

Core crate import path (e.g., "sample_core").

type_paths: HashMap<String, String>

Map of type name → fully-qualified Rust path for type references.

error_type: String

Error type name (e.g., "SampleCrateError").

struct_param_types: HashSet<String>

Callback-param type names that get NATIVE-object marshalling — known serde structs per the shared crate::codegen::generators::trait_bridge::is_native_marshalled_struct rule. For such a param the bridge constructs the binding’s native PHP object (the #[php_class] wrapper, via the same From<core::T> conversion used for return values) and hands THAT to the PHP method as a Zval, instead of serializing the param to a JSON string. Enums, opaque/handle types, and excluded/unknown Named params are absent and keep their prior JSON-string representation.

struct_return_types: HashSet<String>

Callback-RETURN type names that get NATIVE-object marshalling — known serde structs returned directly by a method, gated to those with a generated From<Binding> for core conversion. For such a return the bridge first extracts the host’s native #[php_class] object via FromZval and converts via From<Binding>, falling back to the val.string() + serde path.

forwardable_defaulted: HashSet<String>

Rust-defaulted trait methods the bridge forwards to the host when the PHP object’s class defines them (per the shared forwardable_defaulted_method_names rule). Methods absent here keep the trait’s Rust default unconditionally.

Trait Implementations

impl TraitBridgeGenerator for PhpBridgeGenerator

fn gen_lifecycle_presence_check( &self, method: &MethodDef, _spec: &TraitBridgeSpec<'_>, ) -> Option<String>

Presence-check expression for a Plugin lifecycle method (initialize, shutdown) synthesized by the super-trait impl.

fn gen_method_presence_check( &self, method: &MethodDef, _spec: &TraitBridgeSpec<'_>, ) -> Option<String>

Presence-check expression for a Rust-defaulted trait method.

fn foreign_object_type(&self) -> &str

The type of the wrapped foreign object (e.g., "Py<PyAny>", "ThreadsafeFunction").

fn bridge_imports(&self) -> Vec<String>

Additional use imports needed for the bridge code.

fn gen_sync_method_body( &self, method: &MethodDef, spec: &TraitBridgeSpec<'_>, ) -> String

Generate the body of a synchronous method bridge.

fn gen_async_method_body( &self, method: &MethodDef, spec: &TraitBridgeSpec<'_>, ) -> String

Generate the body of an async method bridge.

fn gen_constructor(&self, spec: &TraitBridgeSpec<'_>) -> String

Generate the constructor body that validates and wraps the foreign object.

fn gen_unregistration_fn(&self, spec: &TraitBridgeSpec<'_>) -> String

Generate an unregistration function for the bridge.

fn gen_clear_fn(&self, spec: &TraitBridgeSpec<'_>) -> String

Generate a clear-all-plugins function for the bridge.

fn gen_registration_fn(&self, spec: &TraitBridgeSpec<'_>) -> String

Generate the complete registration function including attributes, signature, and body.

fn async_trait_is_send(&self) -> bool

Whether the #[async_trait] macro should require Send on its futures.

fn extra_bridge_fields( &self, _spec: &TraitBridgeSpec<'_>, ) -> Vec<(String, String)>

Extra fields on the wrapper struct, as (name, rust_type) pairs.