如何在 QuickBooks Online API 查询中正确使用日期变量-php教程-PHP中文网

如何在 QuickBooks Online API 查询中正确使用日期变量

本文详解在 QuickBooks Online（QBO）API 的 Query() 方法中安全、准确地插入动态日期变量的实践方法，重点解决因字符串拼接导致的日期条件失效问题，并提供可直接复用的代码范式与关键注意事项。

本文详解在 quickbooks online（qbo）api 的 `query()` 方法中安全、准确地插入动态日期变量的实践方法，重点解决因字符串拼接导致的日期条件失效问题，并提供可直接复用的代码范式与关键注意事项。

在使用 QuickBooks Online PHP SDK（如官方 quickbooks/v3-php-sdk）调用 DataService::Query() 执行时间范围筛选时，开发者常需将 MySQL 中存储的最后同步时间（如 '2022-01-01'）作为 MetaData.LastUpdatedTime > ? 的动态条件值。但若直接拼接变量（如 "... > $qboLastUpdate"），API 将返回空结果——根本原因在于 QBO 查询语法严格要求日期字面量必须用单引号包裹，而 PHP 变量插值无法自动添加该引号。

✅ 正确写法（推荐）：

$qboTable = 'Invoice'; // 示例表名
$qboLastUpdate = '2022-01-01'; // 来自 MySQL DATE 字段，格式为 Y-m-d
$i = 1;
$end = 100;

// 关键：手动补全单引号，确保生成形如 "... > '2022-01-01'"
$query = "SELECT * FROM $qboTable 
          WHERE MetaData.LastUpdatedTime > '" . $qboLastUpdate . "' 
          STARTPOSITION $i MAXRESULTS $end";

$qboTableExtract = $dataService->Query($query);

⚠️ 注意事项：

绝不省略单引号：QBO 不接受无引号的日期值（如 > 2022-01-01 会被解析为数学减法），必须为 '2022-01-01'；
日期格式必须为 ISO 8601 标准：Y-m-d（如 '2024-05-20'），不支持 m/d/Y 或带时间的 Y-m-d H:i:s（除非明确使用 LastUpdatedTime >= '2024-05-20T00:00:00'）；

SQL 注入防护：若 $qboLastUpdate 来源不可信（如用户输入），务必先校验格式：

if (!preg_match('/^\d{4}-\d{2}-\d{2}$/', $qboLastUpdate)) {
    throw new InvalidArgumentException('Invalid date format. Use YYYY-MM-DD.');
}

时区一致性：QBO 的 LastUpdatedTime 始终为 UTC 时间，确保 MySQL 中存储的 $qboLastUpdate 也基于 UTC（而非本地时区），否则可能导致漏数据；
避免双引号内嵌变量陷阱：" > '$qboLastUpdate'" 在部分 PHP 环境下可能因解析歧义失败，显式字符串拼接（' > \'' . $qboLastUpdate . '\''）更可靠。