Why Intersection types in PHP? - Purpose & Use Cases

The Big Idea

What if your code could automatically guarantee objects have all the features you need, without messy checks?

The Scenario

Imagine you have a function that needs an object which is both a Logger and a Serializer. Without intersection types, you must manually check and combine these capabilities, making your code messy and hard to maintain.

The Problem

Manually verifying that an object meets multiple interfaces means writing extra checks and error handling everywhere. This slows development and increases bugs because you might forget a check or mix up types.

The Solution

Intersection types let you declare that a value must satisfy multiple types at once. This means the language enforces the object has all required features, making your code cleaner and safer.

Before vs After

✗ Before

$obj = getObject();
if (!($obj instanceof Logger) || !($obj instanceof Serializer)) {
    throw new Exception('Invalid object');
}

✓ After

function process(Logger&Serializer $obj) {
    // $obj is guaranteed to be both Logger and Serializer
}

What It Enables

It enables writing precise and safe code that works only with objects having multiple required capabilities, reducing bugs and improving clarity.

Real Life Example

When building a system that logs data and also converts it to JSON, intersection types ensure the object you pass can do both without extra checks.

Key Takeaways

Manual checks for multiple types are slow and error-prone.

Intersection types enforce multiple type requirements at once.

This leads to cleaner, safer, and more maintainable code.

Practice

1. What does an intersection type in PHP represent?
function example(SomeType&OtherType $param) {}

easy

A. A type that requires the value to satisfy both SomeType and OtherType.

B. A type that accepts either SomeType or OtherType.

C. A type that only accepts SomeType but ignores OtherType.

D. A type that combines SomeType and OtherType into a new class.

Solution

1. Step 1: Understand intersection type syntax

   In PHP, the & symbol between types means the value must satisfy all listed types simultaneously.

2. Step 2: Interpret the function parameter

   The parameter type SomeType&OtherType means the argument must be both SomeType and OtherType at the same time.

3. Final Answer:

   A type that requires the value to satisfy both SomeType and OtherType. -> Option A

4. Quick Check:

   Intersection type = must satisfy all types [OK]

Hint: Remember & means AND, so all types must match [OK]

Common Mistakes:

• Confusing & with | (union type)
• Thinking it creates a new combined class
• Assuming it accepts either type instead of both

2. Which of the following is the correct syntax for declaring an intersection type in a function parameter in PHP?

easy

A. function test(A & B $param) {}

B. function test(A | B $param) {}

C. function test(A, B $param) {}

D. function test(A && B $param) {}

Solution

1. Step 1: Recall intersection type syntax

   PHP uses a single ampersand & to declare intersection types between multiple types.

2. Step 2: Check each option

   function test(A & B $param) {} uses & correctly. function test(A | B $param) {} uses | which is union type. function test(A, B $param) {} uses comma which is invalid. function test(A && B $param) {} uses && which is not valid syntax.

3. Final Answer:

   function test(A & B $param) {} -> Option A

4. Quick Check:

   Intersection type uses & symbol [OK]

Hint: Use single & between types for intersection [OK]

Common Mistakes:

• Using | instead of &
• Using commas to separate types
• Using && instead of &

3. What will be the output of the following PHP code?

interface A { public function foo(): string; }
interface B { public function bar(): string; }

class C implements A, B {
  public function foo(): string { return 'foo'; }
  public function bar(): string { return 'bar'; }
}

function test(A & B $obj) {
  echo $obj->foo() . ' ' . $obj->bar();
}

$c = new C();
test($c);

medium

A. TypeError at runtime

B. foo

C. bar

D. foo bar

Solution

1. Step 1: Understand class and interfaces

   Class C implements both interfaces A and B, so it has methods foo() and bar().

2. Step 2: Analyze function test parameter and call

   The function test requires an argument that satisfies both A and B (intersection type). Object $c satisfies both. The function echoes foo() and bar() results concatenated with a space.

3. Final Answer:

   foo bar -> Option D

4. Quick Check:

   Object satisfies both interfaces, prints both methods [OK]

Hint: Intersection means object must have all methods used [OK]

Common Mistakes:

• Expecting only one method output
• Thinking it causes a TypeError
• Confusing intersection with union types

4. Identify the error in this PHP code using intersection types:

interface X { public function x(): void; }
interface Y { public function y(): void; }

class Z implements X {
  public function x(): void {}
}

function foo(X & Y $param) {
  $param->x();
  $param->y();
}

$z = new Z();
foo($z);

medium

A. Function foo has wrong parameter syntax for intersection types.

B. Method y() is missing in function foo.

C. Class Z does not implement interface Y, so it cannot satisfy X & Y.

D. No error, code runs fine.

Solution

1. Step 1: Check class Z implementation

   Class Z implements only interface X, not Y, so it does not satisfy the intersection type X & Y.

2. Step 2: Analyze function call with $z

   Function foo requires a parameter that implements both X and Y. Passing $z causes a TypeError because $z lacks Y.

3. Final Answer:

   Class Z does not implement interface Y, so it cannot satisfy X & Y. -> Option C

4. Quick Check:

   Intersection requires all interfaces implemented [OK]

Hint: Check all interfaces are implemented for intersection [OK]

Common Mistakes:

• Assuming partial interface implementation is enough
• Thinking syntax is wrong instead of logic
• Ignoring missing methods from interfaces

5. Given these interfaces and classes:

interface Logger { public function log(string $msg): void; }
interface FileWriter { public function write(string $data): void; }

class FileLogger implements Logger, FileWriter {
  public function log(string $msg): void { echo "Log: $msg\n"; }
  public function write(string $data): void { echo "Write: $data\n"; }
}

function process(Logger & FileWriter $obj, string $message) {
  $obj->log($message);
  $obj->write($message);
}

$fl = new FileLogger();
process($fl, "Hello World");

What will be the output and why is intersection type useful here?

hard

A. Runtime error because intersection types cannot be used with classes.

B. Output:Log: Hello WorldWrite: Hello WorldIntersection ensures $obj has both log() and write() methods.

C. Output:Log: Hello WorldOnly log() is called because intersection ignores write().

D. Output:Write: Hello WorldOnly write() is called because log() is ignored.

Solution

1. Step 1: Understand class and interfaces

   FileLogger implements both Logger and FileWriter, so it has both log() and write() methods.

2. Step 2: Analyze function process behavior

   The function requires an object that satisfies both Logger and FileWriter (intersection type). It calls both log() and write() methods on the object.

3. Step 3: Predict output

   Calling process with $fl outputs:
   Log: Hello World
   Write: Hello World

4. Final Answer:

   Output:
   Log: Hello World
   Write: Hello World
   Intersection ensures $obj has both log() and write() methods. -> Option B

5. Quick Check:

   Intersection type ensures all required methods exist [OK]

Hint: Intersection guarantees all methods exist on object [OK]

Common Mistakes:

• Thinking only one interface method is called
• Believing intersection types cause runtime errors
• Ignoring that both methods are called