PHP动态类名访问与静态分析中的类型提示技巧

$c = '\App\Models\Book';

$c::each(function($i) {
    echo $i->title . PHP_EOL;
});

/** @param object{title:string} $i */

<?php

namespace App\Models;

// 假设我们有模型类 Book 和 Article
class Book
{
    public string $title;
    public string $author;

    public function __construct(string $title, string $author)
    {
        $this->title = $title;
        $this->author = $author;
    }

    public static function each(callable $callback): void
    {
        // 模拟从数据库获取数据并调用回调
        $books = [
            new Book('The Great Gatsby', 'F. Scott Fitzgerald'),
            new Book('1984', 'George Orwell'),
        ];
        foreach ($books as $book) {
            $callback($book);
        }
    }
}

class Article
{
    public string $title;
    public string $editor;

    public function __construct(string $title, string $editor)
    {
        $this->title = $title;
        $this->editor = $editor;
    }

    public static function each(callable $callback): void
    {
        // 模拟从数据库获取数据并调用回调
        $articles = [
            new Article('PHP Type Hinting Guide', 'John Doe'),
            new Article('Laravel Best Practices', 'Jane Smith'),
        ];
        foreach ($articles as $article) {
            $callback($article);
        }
    }
}

// 场景一：处理 Book 模型
$className = '\App\Models\Book';

echo "--- Processing Books ---" . PHP_EOL;
$className::each(function(/** @param object{title:string} $i */ $i) {
    // 静态分析工具会识别 $i 拥有 'title' 属性且为 string
    echo "Book Title: " . $i->title . PHP_EOL;
    // 如果尝试访问 Book 特有的 'author' 属性，而注解中未声明，
    // 静态分析工具可能会发出警告，因为它只知道 $i 至少有 'title'
    // echo "Book Author: " . $i->author . PHP_EOL; // 静态分析工具可能会在此处发出警告
});

echo "--- Processing Articles ---" . PHP_EOL;
// 场景二：处理 Article 模型
$className = '\App\Models\Article';
$className::each(function(/** @param object{title:string} $i */ $i) {
    // 同样，静态分析工具会识别 $i 拥有 'title' 属性且为 string
    echo "Article Title: " . $i->title . PHP_EOL;
});

// 如果我们能确定具体类，直接使用类名类型提示会更精确
// 例如，当 $className 明确是 '\App\Models\Book' 时
// $className::each(function(\App\Models\Book $i) {
//     echo "Book Title: " . $i->title . ", Author: " . $i->author . PHP_EOL;
// });

?>