能否在Shopify Graphiql或后台定义命名查询并从PHP应用调用？

核心结论 #

这两种操作都不可行，具体原因及替代方案如下：

1. GraphiQL 中定义的命名查询无法从外部 PHP 应用调用 #

Shopify GraphiQL 只是一个交互式调试工具，你在其中定义的命名查询仅存储在当前浏览器会话的本地缓存中，不会同步到 Shopify 服务器。这些查询仅在当前打开的 GraphiQL 页面内有效，外部应用无法通过任何方式引用或调用它们。

2. 无法在商店后台定义可复用的命名查询集合 #

Shopify 目前没有提供在商店后台或官方管理界面创建、存储共享命名查询的功能。和 SQL 存储过程不同，Shopify GraphQL 不存在「服务器端存储查询」的机制——所有查询都需要在调用的客户端（比如你的 PHP 应用）中完整定义，再通过 API 请求发送至 Shopify。

替代方案：本地封装复用查询 #

如果你想在 PHP 应用中复用常用 GraphQL 查询，推荐以下方式：

• 将常用查询字符串封装为 PHP 常量或工具函数，存放在项目配置文件或工具类中
• 把查询写入 .graphql 格式文件，在 PHP 中读取文件内容后发起请求
• 利用 GraphQL 片段（Fragments）复用字段集合，减少重复代码

示例代码：

<?php
// 封装复用的查询常量
const GET_TOP_PRODUCTS = <<<'GRAPHQL'
query GetTopProducts($first: Int!) {
  products(first: $first, sortKey: BEST_SELLING) {
    edges {
      node {
        id
        title
        priceRange {
          minVariantPrice {
            amount
          }
        }
      }
    }
  }
}
GRAPHQL;

// 调用查询
$shopifyClient->query(GET_TOP_PRODUCTS, ['first' => 8]);
?>

内容的提问来源于stack exchange，提问作者Matthew