PHP中高效提取数组中单个匹配对象的策略

$arr = [
    // ... 包含 Timber\Term 对象的数组 ...
];
$slug = 'installation-maintenance';

$filter = array_filter($arr, 
  function($item) use ($slug) {
    return $item->slug == $slug;
  }
);

Array(1) {
  [3]=> // 注意这里的键是原始数组中的键，不一定是0
  object(Timber\Term)#5173 (16) {
    ["PostClass"]=> "Timber\Post"
    ["TermClass"]=> "Term"
    ["object_type"]=> "term"
    // ... 其他属性 ...
    ["name"]=> "Installation Maintenance"
    ["taxonomy"]=> "category"
    ["id"]=> 73
    ["slug"]=> "installation-maintenance"
    // ...
  }
}

<?php

// 假设我们有一个包含 Timber\Term 对象的数组
// 这里仅为示例，实际中 $items 会从数据库或其他地方获取
class MyService
{
    private array $items;

    public function __construct(array $itemsData)
    {
        // 模拟创建 Timber\Term 对象
        $this->items = array_map(function($data) {
            $term = new class() extends \Timber\Term {
                public function __construct() {} // 覆盖构造函数避免实际初始化
            };
            foreach ($data as $key => $value) {
                $term->$key = $value;
            }
            return $term;
        }, $itemsData);
    }

    /**
     * 从数组中查找并返回第一个匹配指定slug的Timber\Term对象。
     *
     * @param array $items 要搜索的Timber\Term对象数组。
     * @param string $slug 要匹配的slug值。
     * @return \Timber\Term|null 匹配到的Timber\Term对象，如果未找到则返回null。
     */
    private function findItem(array $items, string $slug): ?\Timber\Term
    {
        foreach ($items as $item) {
            // 确保 $item 是一个对象且具有 slug 属性
            if (is_object($item) && property_exists($item, 'slug') && $item->slug === $slug) {
                return $item; // 找到匹配项，直接返回对象
            }
        }
        return null; // 遍历结束未找到匹配项
    }

    public function getItemBySlug(string $targetSlug): ?\Timber\Term
    {
        return $this->findItem($this->items, $targetSlug);
    }
}

// 示例数据
$sampleTermData = [
    [
        "PostClass" => "Timber\Post",
        "TermClass" => "Term",
        "object_type" => "term",
        "name" => "Installation Maintenance",
        "taxonomy" => "category",
        "id" => 73,
        "slug" => "installation-maintenance",
    ],
    [
        "PostClass" => "Timber\Post",
        "TermClass" => "Term",
        "object_type" => "term",
        "name" => "Another Category",
        "taxonomy" => "category",
        "id" => 74,
        "slug" => "another-category",
    ]
];

// 使用示例
$myService = new MyService($sampleTermData);

// 查找存在的slug
$item = $myService->getItemBySlug('installation-maintenance');

if ($item) {
    echo "找到对象：名称为 " . $item->name . "，ID为 " . $item->id . PHP_EOL;
    // 可以直接访问属性，例如 $item->name
} else {
    echo "未找到匹配的对象。" . PHP_EOL;
}

// 查找不存在的slug
$nonExistentItem = $myService->getItemBySlug('non-existent-slug');
if ($nonExistentItem) {
    echo "找到对象：名称为 " . $nonExistentItem->name . PHP_EOL;
} else {
    echo "未找到匹配 'non-existent-slug' 的对象。" . PHP_EOL;
}

// 更简洁的错误处理（PHP 7.0+ null coalescing operator）
// 对于 PHP 8.0+，可以结合 null coalescing operator 和 throw expression
try {
    $foundItem = $myService->getItemBySlug('installation-maintenance');
    echo $foundItem->name ?? throw new \Exception("No item found with slug 'installation-maintenance'");
    echo PHP_EOL;
} catch (\Exception $e) {
    echo "错误: " . $e->getMessage() . PHP_EOL;
}

try {
    $foundItem = $myService->getItemBySlug('unknown-slug');
    echo $foundItem->name ?? throw new \Exception("No item found with slug 'unknown-slug'");
    echo PHP_EOL;
} catch (\Exception $e) {
    echo "错误: " . $e->getMessage() . PHP_EOL;
}

$item = $this->findItem($items, $someSlug);

if ($item !== null) {
    echo $item->name; // 直接访问对象属性
} else {
    echo "未找到匹配项。";
}

// 使用空合并运算符提供默认值
$itemName = $item->name ?? 'N/A';
echo "项目名称: " . $itemName . PHP_EOL;

// PHP 8.0+ 结合 throw 表达式，当 $item 为 null 时抛出异常
echo $item->name ?? throw new \Exception("No item found with slug '{$someSlug}'");