用途：为使用 ScraperAPI PHP SDK（Composer 包 scraperapi/sdk）编写、调试或审查 PHP 代码时提供最佳实践参考。
环境要求：PHP 7.0+、Composer，执行 composer require scraperapi/sdk，并通过环境变量 SCRAPERAPI_API_KEY 提供密钥，不要硬编码。
基本用法：引入 vendor/autoload.php 与 ScraperAPI\Client，用 new Client(getenv('SCRAPERAPI_API_KEY')) 创建客户端；$client->get($url, $params)->raw_body 返回 HTML 字符串，参数以关联数组传入。POST 用 $client->post($url, $options)->raw_body。
主要能力与参数：render 渲染 JavaScript（+10 积分），wait_for_selector 等待元素，screenshot 截图；country_code 指定国家代理；premium 与 ultra_premium 应对反爬（二者互斥，ultra_premium 时 keep_headers 被忽略）；session_number 复用同一代理 IP（闲置 15 分钟过期）；device_type 模拟设备；autoparse 对支持的站点返回结构化 JSON；output_format 可输出 markdown。
成本与升级顺序：标准 1 积分，render 10，premium 10，premium+render 25，ultra_premium 30，ultra_premium+render 75；可用 max_cost 限制单次积分。建议从最便宜选项开始，被拦截再逐级升级。
批量与结构化数据：SDK 为同步调用，单次最长约 70 秒；20 个以上 URL 建议改用异步 REST 端点（https://async.scraperapi.com/jobs）提交并轮询。支持的平台可用 https://api.scraperapi.com/structured/{vertical} 直接获取干净 JSON。
错误处理：401 密钥无效，403 被拦截或积分不足，404 目标不存在，429 限流，500/503 为临时错误且不计费可重试。
限制：资料未提供 SDK 版本兼容细节、完整参数清单及结构化端点全部字段，需查阅官方文档。