phpEnv不支持TimescaleDB，因其仅面向LAMP/LEMP栈，未集成PostgreSQL及服务端扩展加载机制；需手动部署PostgreSQL+TimescaleDB，并配置shared_preload_libraries、PHP pgsql扩展及libpq.dll兼容性。
phpEnv 本身不提供 TimescaleDB 支持 —— 它是 Windows 下用于快速切换 PHP/MySQL/Apache/Nginx 环境的集成包，默认不含 PostgreSQL，更不内置 TimescaleDB。想在 phpEnv 环境中使用 TimescaleDB，必须手动引入 PostgreSQL + TimescaleDB 插件，并确保其与 PHP 应用能通信。这不是“安装插件”那么简单，而是绕过 phpEnv 的封装逻辑，做底层整合。
为什么 phpEnv 无法直接安装 TimescaleDB
phpEnv 的设计目标是 LAMP/LEMP 快速堆栈，所有组件都预编译、路径固化、服务由它统一启停。它不管理 postgresql.conf、不暴露 pg_config、也不支持 shared_preload_libraries 配置项修改。你看到的“插件”选项（如 Redis、Memcached）都是 PHP 扩展（.dll），而 TimescaleDB 是 PostgreSQL 服务端扩展，必须在数据库进程启动时加载。
手动接入 PostgreSQL + TimescaleDB 到 phpEnv 环境
核心思路：绕过 phpEnv 自带的 MySQL，默认启用外部 PostgreSQL 实例（可同机不同端口），再让 PHP 通过 pgsql 扩展连接它。步骤如下：
- 确认已安装并启用 PHP 的
pgsql和pdo_pgsql扩展：检查php.ini中是否取消注释extension=php_pdo_pgsql.dll和extension=php_pgsql.dll，然后重启phpEnv的 Apache/Nginx 服务 - 单独安装 PostgreSQL（例如 14 或 15 版本）：不要装到
phpEnv目录下，推荐路径如D:\PostgreSQL\14\；安装时勾选 “Initialize database cluster” 和 “Add to PATH” - 下载对应版本的 TimescaleDB Windows 二进制包（如
timescaledb-2.26.2-pg14-windows-amd64.zip），解压后运行setup.exe，按提示指定 PostgreSQL 的bin和lib路径（如D:\PostgreSQL\14\bin） - 编辑 PostgreSQL 的
postgresql.conf（通常在D:\PostgreSQL\14\data\下）：
– 取消注释并设为shared_preload_libraries = 'timescaledb'
– 确保max_locks_per_transaction = 256
– 保存后以管理员身份运行pg_ctl restart -D "D:\PostgreSQL\14\data" - 验证：用
psql -U postgres连入，执行CREATE EXTENSION IF NOT EXISTS timescaledb;；若无报错且SELECT * FROM pg_available_extensions WHERE name = 'timescaledb';返回记录，即成功
PHP 连接 TimescaleDB 的关键配置点
PHP 代码里不能只写 localhost:5432 就完事——常见断连或权限问题都卡在这几步：
立即学习“PHP免费学习笔记（深入）”；
- PostgreSQL 默认监听
localhost，但可能未开启listen_addresses = 'localhost'（检查postgresql.conf） - 默认拒绝远程连接，需在
pg_hba.conf（同目录下）追加一行：host all all 127.0.0.1/32 md5，然后 reload：pg_ctl reload -D "D:\PostgreSQL\14\data" - PHP 连接字符串示例：
$pdo = new PDO('pgsql:host=127.0.0.1;port=5432;dbname=yourdb', 'postgres', 'yourpass');—— 必须用127.0.0.1，而非localhost（Windows 下localhost可能走 Unix socket 模拟，失败率高） - 首次建超表前，务必先在目标库执行
CREATE EXTENSION IF NOT EXISTS timescaledb;，否则create_hypertable()会报function "create_hypertable" does not exist
最容易被忽略的兼容性陷阱
不是所有 phpEnv 内置的 PHP 版本都兼容最新 PostgreSQL 协议。比如 PHP 8.0+ 编译时若链接的是旧版 libpq，连接 PG 15+ 可能触发 server closed the connection unexpectedly。解决办法只有两个：
- 降级 PostgreSQL 到 14（TimescaleDB 2.17.x 起已稳定支持 PG 14，且
phpEnv常见 PHP 7.4/8.0 都验证过） - 或手动替换 PHP 的
libpq.dll：从 PostgreSQL 安装目录的bin\下复制新版libpq.dll，覆盖到phpEnv\php\php-xx\对应目录，并重启 Web 服务
这个 DLL 替换动作极容易遗漏，且错误时无明确报错，只表现为连接闪退或查询超时 —— 如果你反复确认配置却始终连不上，先查这个。
