Hyperf 是基于 Swoole 的 PHP 微服务协程框架，非 Linux 发行版；需在 Ubuntu 等系统上安装 PHP 8.0+、Swoole 扩展，禁用 opcache.enable_cli，用 Composer 创建项目并启动，生产环境应配置 Supervisor、Nginx 反代及资源限制。
Hyperf 并不是 Linux 发行版，也不是 Ubuntu 的某个特殊版本——它是一个基于 Swoole 扩展的高性能、高灵活性的 PHP 微服务协程框架，运行在标准 Linux 系统（如 Ubuntu）之上。所谓“Hyperf Ubuntu 安装”，实际是指：在 Ubuntu（或其他 Linux 发行版）环境中，部署运行 Hyperf 框架项目。
一、确认系统与 PHP 环境要求
Hyperf 依赖 PHP 8.0+ 和 Swoole 扩展（推荐 v5.0+），不支持 Apache 或传统 FPM 模式直接运行，必须启用协程能力：
- Ubuntu 推荐使用 20.04 LTS 或 22.04 LTS（内核 ≥5.4，兼容 Swoole 协程调度）
- PHP 需编译或安装时启用
--enable-mbstring、--enable-pcntl、--enable-bcmath等扩展 - 务必禁用
opcache.enable_cli=1（CLI 模式下开启 opcache 可能导致协程异常）
二、安装 Swoole 扩展（关键步骤）
Swoole 是 Hyperf 的底层运行引擎，必须正确安装并启用：
- 推荐使用 pecl 安装最新稳定版：
pecl install swoole - 安装完成后，在
php.ini中添加：extension=swoole - 验证是否生效：
php -m | grep swoole应输出swoole；php --ri swoole查看版本及协程支持状态（确认coroutine => enabled）
三、创建并启动 Hyperf 项目
使用 Composer 创建标准 Hyperf 应用，无需额外“Hyperf 发行版”镜像或 ISO：
- 确保已安装 Composer（建议 2.5+）：
curl -sS https://getcomposer.org/installer | php && sudo mv composer.phar /usr/local/bin/composer - 创建项目：
composer create-project hyperf/hyperf-skeleton myapp - 进入目录并启动服务：
cd myapp && php bin/hyperf.php start - 默认监听
http://127.0.0.1:9501，可访问验证
四、生产环境基础加固建议
上线前需调整配置以保障稳定性与安全性：
- 关闭调试模式：
APP_DEBUG=false（修改.env） - 使用 Supervisor 或 systemd 管理进程，避免前台运行中断
- 配置 Nginx 反向代理（非直接暴露 9501 端口），示例 location 块中设置：
proxy_set_header Connection '';和proxy_http_version 1.1;以支持长连接 - 限制内存与协程数：
SWOOLE_PROCESS_NUM=4、SWOOLE_MAX_COROUTINE=3000（根据服务器资源调整）
不需要下载“Hyperf Ubuntu 镜像”，也不用定制发行版。只要 Ubuntu 系统满足 PHP+Swoole 条件，就能跑起 Hyperf。核心是环境准备准确，而非系统层面魔改。
