# robvanaarle/php-object-seam architecture

> Architecture diagram of the GitHub repository robvanaarle/php-object-seam, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/robvanaarle/php-object-seam
- Repository: https://github.com/robvanaarle/php-object-seam

## Overview

##### Main Components

a. Core Components:
- ObjectSeam Manager
- Code Generation System
- Method Interception Layer
- Test Integration Layer

b. Supporting Components:
- Method Signature Processing
- Call Capture System
- Constructor Management
- Static Method Handler

**Test Layer (Entry Point)**

**Object Seam Layer**

**Code Generation Layer**

**Target Class Layer**

##### Test Integration Components
- CreatesObjectSeams trait as the main entry point
- To ObjectSeam builder system
- Test framework integration points

##### Core ObjectSeam Components
- Builder pattern implementation
- ClassSeam and ObjectSeamTrait relationships
- Method interception flow

##### Code Generation System
- MethodSignatureBuilder
- CodeBuilder components
- Seam generation process

Use these specific visual elements:

Key Architectural Patterns to Highlight:

##### Builder Pattern
**CreatesObjectSeams → Builder → ObjectSeam**

##### Method Interception Flow
**ObjectSeam → MethodSignatureBuilder → CodeBuilder → Generated Seam**

##### Test Integration
**Test Class → CreatesObjectSeams → ObjectSeam → Target Class**

Important Implementation Details:

##### Seam creation process
- Method signature analysis
- Code generation
- Runtime method interception

##### Features
- Protected/private method access
- Method overriding
- Constructor customization
- Call capturing

##### Support for
- Static methods
- Multiple PHP versions (7.0-8.2)
- Various method signatures

Additional Considerations:

##### Notes for
- PHP version compatibility
- Test framework integration
- Legacy code interaction

##### Extension points
- Custom method handling
- New PHP version support
- Additional seam types

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Test
        TestClass["Test Class"]
        CreatesObjectSeams["CreatesObjectSeams Trait"]:::test
    end

    subgraph ObjectSeamLayer["Object Seam Layer"]
        Builder["Builder"]:::core
        ObjectSeam["ObjectSeam"]:::core
        ObjectSeamTrait["ObjectSeamTrait"]:::core
        ClassSeam["ClassSeam"]:::core
        Seam["Method Interception"]:::core
    end

    subgraph CodeGeneration["Code Generation Layer"]
        CodeBuilder["CodeBuilder"]:::codegen
        MethodSignature["Method Signature Builder"]:::codegen
        Exception["Exception Handler"]:::support
    end

    subgraph Target["Target Class Layer"]
        TargetClass["Legacy Class"]
        GeneratedSeam["Generated Seam"]:::codegen
    end

    %% Relationships
    TestClass --> CreatesObjectSeams
    CreatesObjectSeams --> Builder
    Builder --> ObjectSeam
    ObjectSeam --> ObjectSeamTrait
    ObjectSeam --> ClassSeam
    ClassSeam --> Seam
    Seam --> CodeBuilder
    CodeBuilder --> MethodSignature
    CodeBuilder --> GeneratedSeam
    GeneratedSeam -.-> TargetClass
    Exception -.-> ObjectSeam

    %% Click Events
    click CreatesObjectSeams "https://github.com/robvanaarle/php-object-seam/blob/main/src/CreatesObjectSeams.php"
    click ObjectSeam "https://github.com/robvanaarle/php-object-seam/blob/main/src/ObjectSeam.php"
    click ObjectSeamTrait "https://github.com/robvanaarle/php-object-seam/blob/main/src/ObjectSeam/ObjectSeamTrait.php"
    click CodeBuilder "https://github.com/robvanaarle/php-object-seam/blob/main/src/ObjectSeam/CodeBuilder.php"
    click MethodSignature "https://github.com/robvanaarle/php-object-seam/blob/main/src/Code/MethodSignatureBuilder.php"
    click Seam "https://github.com/robvanaarle/php-object-seam/blob/main/src/ObjectSeam/Seam.php"
    click Builder "https://github.com/robvanaarle/php-object-seam/blob/main/src/ObjectSeam/Builder.php"
    click ClassSeam "https://github.com/robvanaarle/php-object-seam/blob/main/src/ObjectSeam/ClassSeam.php"
    click Exception "https://github.com/robvanaarle/php-object-seam/blob/main/src/Exception.php"

    %% Styles
    classDef core fill:#2374ab,stroke:#2374ab,color:#fff
    classDef test fill:#4caf50,stroke:#4caf50,color:#fff
    classDef codegen fill:#ff9800,stroke:#ff9800,color:#fff
    classDef support fill:#9e9e9e,stroke:#9e9e9e,color:#fff

    %% Legend
    subgraph Legend
        CoreComponent["Core Component"]:::core
        TestComponent["Test Component"]:::test
        CodeGenComponent["Code Generation"]:::codegen
        SupportComponent["Support Utility"]:::support
    end
```
