phpEnv 对 Hasura 完全无效，因其仅管理 PHP 解释器及扩展，而 Hasura 是独立的 Go 语言预编译二进制服务，不依赖 PHP 运行时，也不兼容 phpEnv 的版本切换、PATH 注入或环境配置机制。
phpEnv 不能安装或部署 Hasura。 Hasura 是一个独立的、基于 Go 的 GraphQL 引擎，它不依赖 PHP 运行时，也不兼容 phpEnv 这类 PHP 版本管理工具。
为什么 phpEnv 对 Hasura 完全无效
phpEnv 只管理 PHP 解释器及其扩展（如 php、php-fpm、composer），而 Hasura 是一个预编译的二进制服务进程，启动后监听 HTTP 端口，自身带数据库连接池、JWT 验证、实时订阅等完整能力。它不加载任何 PHP 文件，也不调用 php 命令。
- 你无法用
phpenv install获取 Hasura - 你无法用
phpenv exec hasura启动它（hasura命令根本不在 phpEnv 的 PATH 范围内） - phpEnv 的
.php-version或phpenv local对 Hasura 的配置、环境变量、数据库连接毫无影响
Hasura 正确的本地部署方式（非 PHP 环境）
Hasura 推荐使用 Docker 快速启动，这是官方唯一保证一致性的本地开发方式：
- 确保已安装
docker和docker-compose - 创建
docker-compose.yml，内容参考k8s-manifest/services/backend/hasura/deployment.yaml中的镜像与环境变量逻辑，但简化为单容器：
version: '3.8'
services:
hasura:
image: hasura/graphql-engine:v2.44.0
ports:
- "8080:8080"
environment:
HASURA_GRAPHQL_DATABASE_URL: "postgres://postgres:password@postgres:5432/postgres"
HASURA_GRAPHQL_JWT_SECRET: '{"type":"HS256","key":"your-256-bit-secret"}'
HASURA_GRAPHQL_ADMIN_SECRET: "my-admin-secret"
HASURA_GRAPHQL_ENABLE_CONSOLE: "true"
depends_on:
- postgres
<p>postgres:
image: yugabytedb/yugabyte:2.20.1.0-b41</p><h1>或用标准 postgres:15</h1>- 运行
docker-compose up -d，访问http://localhost:8080/console - 注意：
HASURA_GRAPHQL_DATABASE_URL必须指向真实可连的 PostgreSQL/YugabyteDB 实例，不能是localhost（Docker 内部网络需用服务名）
PHP 项目怎么和 Hasura 协同工作
PHP 不运行 Hasura，但可以作为客户端调用它的 GraphQL API：
立即学习“PHP免费学习笔记（深入）”；
- 在 PHP 代码中用
curl或GuzzleHttp\Client请求http://localhost:8080/v1/graphql - 必须携带
Authorization: Bearer <token></token>（由你的 JWT 服务签发，密钥需与HASURA_GRAPHQL_JWT_SECRET匹配） - 发送标准 GraphQL POST 请求体，例如：
{
"query": "query { users { id name } }",
"variables": {}
}- 不要尝试在 PHP 中“集成”Hasura 启动逻辑——它不是 PHP 扩展，也不是 Composer 包
- 若你真需要 PHP 层封装，只做 HTTP 客户端封装，比如定义
HasuraClient::query()，而非试图“安装”它
最容易被忽略的一点：Hasura 的 HASURA_GRAPHQL_JWT_SECRET 和你 PHP 应用签发 JWT 的密钥必须完全一致，且算法匹配（如都用 HS256）。密钥不一致会导致所有带权限的查询返回 invalid jwt token 错误，但这个错误不会出现在 PHP 日志里，而是直接由 Hasura 返回 401 响应。
