PHP中方法参数的类名：理解对象类型提示与常见误区

<?php

declare(strict_types=1); // 开启严格类型模式，使类型提示更严格

/**
 * 定义一个简单的服务类，包含一些方法
 */
class GreetingService
{
    public function getGreetingMessage(): string
    {
        return "Hello from GreetingService!";
    }

    public function getFarewellMessage(): string
    {
        return "Goodbye from GreetingService!";
    }
}

/**
 * 定义一个处理器类，其方法接受 GreetingService 的实例作为参数
 */
class MessageProcessor
{
    /**
     * 接受一个 GreetingService 对象，并调用其方法
     *
     * @param GreetingService $service 一个 GreetingService 的实例
     * @return void
     */
    public function processGreeting(GreetingService $service): void
    {
        echo $service->getGreetingMessage() . PHP_EOL;
    }

    /**
     * 接受一个 GreetingService 对象，并调用其另一个方法
     *
     * @param GreetingService $service 一个 GreetingService 的实例
     * @return void
     */
    public function processFarewell(GreetingService $service): void
    {
        echo $service->getFarewellMessage() . PHP_EOL;
    }
}

// 实例化 GreetingService 对象
$myGreetingService = new GreetingService();

// 实例化 MessageProcessor 对象
$processor = new MessageProcessor();

// 将 GreetingService 实例作为参数传递给 MessageProcessor 的方法
$processor->processGreeting($myGreetingService); // 输出: Hello from GreetingService!
$processor->processFarewell($myGreetingService); // 输出: Goodbye from GreetingService!

// 尝试传递一个不符合类型提示的参数会导致 TypeError
// $someString = "这是一个字符串，不是 GreetingService 对象";
// $processor->processGreeting($someString); // 运行时将抛出 TypeError
?>

<?php

declare(strict_types=1);

class SimpleClass
{
    public function sayHello(): void
    {
        echo("Hello!");
    }
}

class Main
{
    // 这是一个错误的写法！
    public static function process(SimpleClass): void // 缺少参数变量名
    {
        // sayHello(); // 无法直接调用，因为没有对象实例
    }
}

// 尝试调用 (即使修正了参数，这里也无法直接调用 process，因为它是一个静态方法)
// Main::process(new SimpleClass()); // 即使这样，上面的方法定义也是错误的
?>

<?php

declare(strict_types=1);

class SimpleClass
{
    public function sayHello(): void
    {
        echo("Hello!");
    }
}

class Main
{
    /**
     * 正确的写法：为类型提示的参数指定变量名
     *
     * @param SimpleClass $instanceOfSimpleClass SimpleClass 的一个实例
     * @return void
     */
    public static function process(SimpleClass $instanceOfSimpleClass): void
    {
        // 通过传入的实例变量调用其方法
        $instanceOfSimpleClass->sayHello();
    }
}

// 实例化 SimpleClass
$mySimpleObject = new SimpleClass();

// 调用 Main 类的静态方法，并传入 SimpleClass 的实例
Main::process($mySimpleObject); // 输出: Hello!

?>