phpEnv安装Keycloak教程 phpEnv身份认证环境-php教程-PHP中文网

phpenv 不能安装或管理 keycloak，因其仅为 php 版本管理工具；keycloak 是基于 java 的独立身份认证服务，需单独部署。php 应用仅作为 oauth2 客户端通过 http 与 keycloak 交互。

phpenv安装keycloak教程 phpenv身份认证环境

phpenv 和 Keycloak 是两类完全不同的工具，不能“用 phpenv 安装 Keycloak”，也不构成“phpenv 身份认证环境”。这是个常见误解，根源在于混淆了运行时环境管理和身份认证服务的职责边界。

phpenv 是一个 PHP 版本管理器，它的全部工作就是：

而 Keycloak 是基于 Java 的独立服务（WildFly 应用服务器打包版），启动它需要：

你试图让 phpenv “安装 Keycloak”，就像让 rbenv 去部署 PostgreSQL —— 它根本不在同一个抽象层上。

真实协作关系是：PHP 应用作为 OAuth2 客户端，向 Keycloak 发起授权请求。关键点包括：

PHP 进程本身不运行 Keycloak，只通过 HTTP 调用其 /auth 端点
必须确保 Keycloak 服务已独立启动并可被 PHP 所在机器访问（例如 @#@#@#@#@#@#@#@#@#@0）
PHP 侧需使用 OAuth2 客户端库，比如：
- league/oauth2-client（通用）
- stevenmaguire/oauth2-keycloak（Keycloak 专用封装）

常见错误现象：

Connection refused：Keycloak 没启动，或 PHP 访问的 URL 错（比如用了 127.0.0.1 但 Keycloak 绑定的是 0.0.0.0）
Invalid state：PHP session 未启用，或 $_SESSION 在重定向后丢失（检查 session_start() 是否在最顶部）
Unauthorized client：Keycloak 后台创建的 Client 配置中，Valid Redirect URIs 没包含 PHP 应用的实际回调地址（如 @#@#@#@#@#@#@#@#@#@1）

示例片段中必须核对的字段：

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

'authServerUrl' → 必须是 Keycloak 实际可访问的完整地址（含协议、端口、/auth 路径）
'realm' → 区分大小写，且需与 Keycloak 管理后台里 Realm 名字完全一致
'redirectUri' → 必须与 Keycloak Client 设置里的 Valid Redirect URIs 白名单精确匹配（尾部斜杠也影响）

你完全可以同时用 phpenv 管 PHP 版本、又单独跑 Keycloak，但得分开操作：

启动 Keycloak（Linux/macOS）：

cd /path/to/keycloak-26.1.2
bin/standalone.sh -Djboss.bind.address=0.0.0.0 -Djboss.socket.binding.port-offset=100

→ 此时 Keycloak 监听 http://localhost:8180/auth

PHP 项目用 phpenv local 8.3.13 切换版本，再用内置服务器跑：
```
php -S localhost:8000 router.php
```
确保两者网络互通：PHP 脚本能 curl @#@#@#@#@#@#@#@#@#@2 成功返回 JSON

容易被忽略的细节：

Keycloak 默认使用 H2 内存数据库，重启即丢数据；开发阶段若要持久化用户，必须提前配好 MySQL/PostgreSQL 并修改 keycloak.conf 或 standalone.xml
phpenv 的 shims 机制依赖 shell 的 PATH 查找顺序，如果全局 PATH 里已有系统 PHP，可能掩盖 phpenv 切换效果 —— 用 which php 和 phpenv version 双重验证

事情说清了就结束。