Introduction to the Command Pattern in PHP

Welcome to an essential part of our journey into Behavioral Patterns in PHP programming. In this lesson, we will explore the Command Pattern, a fundamental design pattern that is highly useful for promoting flexible and reusable code in object-oriented programming.

Behavioral design patterns, such as the Command Pattern, assist in managing communication and responsibility distribution among objects within your software. The Command Pattern encapsulates a request as an object, allowing clients to parameterize with queues, requests, and operations effectively.

In this lesson, you will master the Command Pattern by understanding its components and implementation in PHP. We'll break down the pattern into manageable parts and explain how to use it effectively in your applications.

The Command Pattern involves creating a command interface with an execute method. You then create concrete command classes that implement this interface, each representing a specific action. Finally, we'll integrate these commands with a request invoker to execute the actions.

To start, we'll define a Light class with on and off methods that print messages using PHP's echo function:

class Light {
    public function on() {
        echo "Light is on.\n";
    }

    public function off() {
        echo "Light is off.\n";
    }
}

The Light class acts as a "receiver" in the Command Pattern. By separating the on and off methods, this class becomes reusable across multiple contexts where you might need to control light functionality. Additionally, changes to these methods (e.g., adding logic for dimming or color changes) can be done in one place without affecting other parts of the code.

Next, we create a Command interface with an execute method and two concrete command classes, LightOnCommand and LightOffCommand, implementing this interface. These classes encapsulate the Light object and call its on and off methods, respectively:

interface Command {
    public function execute();
}

class LightOnCommand implements Command {
    private $light;

    public function __construct($light) {
        $this->light = $light;
    }

    public function execute() {
        $this->light->on();
    }
}

class LightOffCommand implements Command {
    private $light;

    public function __construct($light) {
        $this->light = $light;
    }

    public function execute() {
        $this->light->off();
    }
}

When the LightOnCommand or LightOffCommand objects are created, the Light object is passed into their constructors. This setup enables the command classes to directly interact with the Light object. The execute method in each command class is responsible for calling the appropriate method (on or off) on the Light object. This design ensures that the commands remain decoupled from the invoker (e.g., RemoteControl), making it easy to add or modify commands without altering the invoker's logic.