Statamic中API数据导入与自定义验证：确保程序化保存的数据完整性

<?php

namespace App\Listeners;

use Illuminate\Support\Facades\Http;
use Illuminate\Support\Facades\Validator; // 引入 Laravel Validator
use Statamic\Events\EntrySaved;
use Statamic\Facades\Entry; // 如果需要获取更多Entry相关信息

class ProcessApiDataOnEntrySaved
{
    /**
     * 处理 EntrySaved 事件。
     *
     * @param EntrySaved $event
     * @return void
     */
    public function handle(EntrySaved $event): void
    {
        $entry = $event->entry;

        // 仅处理特定集合的条目，例如 'companies'
        if ($entry->collectionHandle() !== 'companies') {
            return;
        }

        // 获取当前条目数据作为基础
        $currentData = collect($entry->data()->all());

        // 确保 'tickers' 字段存在并有值，这是触发API调用的条件
        if (!isset($currentData['tickers'][0])) {
            return;
        }
        $tickerId = $currentData['tickers'][0];

        // 模拟通过 tickerId 获取相关信息并进行API调用
        // 实际应用中，您可能需要从数据库或其他地方查找 ticker 详情
        $tickerTitle = 'Example Ticker'; // 占位符
        $apiUrl = 'https://api.example.com/company-data/' . $tickerId; // 示例API URL
        $response = Http::get($apiUrl);

        if ($response->successful()) {
            $apiItems = $response->json('results.0');

            // 检查API响应是否有效
            if (!$apiItems) {
                \Log::warning("API响应的'results.0'为空，条目ID: " . $entry->id());
                return;
            }

            // 合并API数据到当前条目数据中
            // 确保API字段名与您的Statamic蓝图字段名匹配
            $mergedData = $currentData->merge([
                'company_name' => $apiItems['exchangeName'] ?? null, // 假设API返回'exchangeName'对应蓝图的'company_name'
                'industry_sector' => $apiItems['sector'] ?? null,
                'description' => $apiItems['longDescription'] ?? null,
                // ... 根据您的蓝图字段和API响应继续映射
            ])->toArray();

            // 确保 Statamic 核心字段（如 slug, date）没有被意外覆盖或丢失
            $mergedData['slug'] = $entry->slug();
            $mergedData['date'] = $entry->date(); // date() 返回 Carbon 实例，可能需要格式化

            // --- 核心：自定义数据验证 ---
            // 定义验证规则。这些规则应与您的Statamic蓝图规则保持一致。
            $rules = [
                'company_name' => 'required|string|max:255',
                'industry_sector' => 'required|string|max:100',
                'description' => 'nullable|string|max:2000',
                // 对于图片尺寸验证，如果API只提供URL，您需要验证URL本身。
                // 如果API提供图片元数据（如宽度、高度），则可以验证这些元数据。
                // 例如：'logo_url' => 'nullable|url|max:2048',
                //       'logo_width' => 'nullable|integer|max:1920',
                //       'logo_height' => 'nullable|integer|max:1080',
            ];

            // 使用 Laravel 的 Validator 门面进行验证
            $validator = Validator::make($mergedData, $rules);

            if ($validator->fails()) {
                // 处理验证失败的情况：
                // 1. 记录错误日志，便于调试和监控
                \Log::error('API数据验证失败，条目ID ' . $entry->id() . '。错误信息: ' . json_encode($validator->errors()->all()));
                // 2. 您可以选择抛出异常，阻止保存，或采取其他措施
                // throw new \Illuminate\Validation\ValidationException($validator);
                return; // 如果验证失败，则停止后续处理，不保存数据
            }

            // 如果验证通过，更新条目数据并安静保存
            $entry->data($mergedData);
            $entry->saveQuietly(); // 使用 Statamic Entry 对象的 saveQuietly() 方法
        } else {
            // 记录API调用失败信息
            \Log::error('从API获取数据失败，条目ID: ' . $entry->id() . '。状态码: ' . $response->status());
        }
    }
}