phpenv 与 Supabase 无安装关联，因 phpenv 仅管理 PHP 版本，而 Supabase 是独立运行的 Docker 服务；PHP 项目只需 HTTP 客户端调用其 REST API 即可。
phpenv 本身不安装或配置 Supabase，它只管理本地 PHP 版本。Supabase 是一个独立的后端服务（基于 PostgreSQL + REST/Realtime API），和 PHP 运行时无关。想用 PHP 调用 Supabase，你只需要：一个能跑 PHP 的环境（phpenv 可帮你选版本），加上一个 HTTP 客户端（比如 curl 或 Guzzle），再配合 Supabase 的 REST API 或第三方库（如 rafaelwendel/phpsupabase）即可。
为什么 phpenv 和 Supabase 不是“一起安装”的关系
phpenv 管的是 php 命令本身——它切换的是你终端里执行 php --version 时看到的那个二进制。Supabase 则是运行在 Docker 容器里的完整服务栈（PostgreSQL、Kong、GoTrue、Realtime 等），它监听的是 http://localhost:54321 或你配的域名端口，和你的 PHP 版本完全解耦。
常见误解场景：
- 以为
phpenv install supabase会启动 Supabase —— 实际上 phpenv 没这个命令，也不支持 - 在
.php-version里写supabase—— 会报错，phpenv 只认已编译安装的 PHP 版本号 - 认为必须用某个特定 PHP 版本才能连 Supabase —— 只要 PHP 支持 cURL 或 JSON（PHP 7.2+ 都满足），就能调用它的 REST 接口
phpenv 配合 Supabase 开发的真实工作流
你在本地开发一个 PHP 项目，需要连接自托管的 Supabase 实例（比如用 Docker 启的）。这时 phpenv 的作用仅限于：确保该项目用对了 PHP 版本，并让 Composer 正常工作。
立即学习“PHP免费学习笔记（深入）”；
实操要点：
- 先用
docker compose up -d启动 Supabase（按官方仓库supabase/docker步骤来），确认http://localhost:54321能访问 Dashboard - 在项目根目录执行
phpenv local 8.3.13，保证团队成员和 CI 使用一致的 PHP 版本 - 用 Composer 加入客户端：
composer require rafaelwendel/phpsupabase:^0.0.8 - 初始化时传入你自部署的 URL 和 ANON_KEY：
new PHPSupabase('http://localhost:54321', 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...') - 注意：Supabase 自托管默认不启用 email confirm，若要用邮箱注册，需在
.env中设ENABLE_EMAIL_SIGNUP=true并配好 SMTP
Supabase 自托管后，PHP 项目里最容易踩的坑
不是版本问题，而是网络和权限配置错误。尤其在 Docker + phpenv 混合环境下：
-
Connection refused：PHP 脚本尝试连http://localhost:54321，但这是宿主机的 localhost；Docker 内 PHP（如 CLI 容器）应改用http://host.docker.internal:54321（Mac/Win）或http://172.17.0.1:54321（Linux） - JWT 验证失败：检查
JWT_SECRET是否和 PHP 客户端初始化时用的密钥完全一致（大小写、换行、空格） - 数据库插入无报错但数据没进表：确认表名是否加了
public.前缀（Supabase 默认 schema 是public），phpsupabase的insert()方法默认不带 schema，需显式写public.users - 实时订阅不触发：PHP 本身不支持 WebSocket 长连接，
phpsupabase也不提供 Realtime 订阅能力 —— 这块得前端做，或用 Node.js 服务桥接
真正关键的不是“怎么装”，而是搞清边界：phpenv 管 PHP 解释器，Supabase 是远程服务，PHP 项目只是它的消费者。把网络通路、密钥、schema、HTTP client 配置对了，比纠结用哪个 PHP 版本重要得多。
