Hyperf 是基于 Swoole 的 PHP 协程框架，非 Linux 发行版；需在 Ubuntu 22.04 上安装 PHP ≥ 8.0、Swoole ≥ 5.0（启用协程）、禁用 opcache.enable_cli，再用 Composer 创建项目并执行 php bin/hyperf.php start 启动服务。

在 Ubuntu 22.04 上快速配置并启动 Hyperf，核心是确保 PHP 环境满足要求、用 Composer 正确安装框架、初始化项目并运行服务。Hyperf 是基于 Swoole 的高性能协程微服务框架，不依赖传统 Web 服务器（如 Apache/Nginx），启动即服务。

确认 PHP 和扩展环境

Hyperf 2.7+ 要求 PHP ≥ 8.0，且必须启用以下扩展：

• swoole（≥ 4.8.13，推荐 5.0+）
• openssl
• json
• mbstring
• redis（如需 Redis 支持）
• pdo_mysql（如需 MySQL 支持）

执行检查命令：

php -v && php -m | grep -E "(swoole|openssl|json|mbstring|redis|pdo)"

若缺失 swoole，推荐用 pecl 安装：

sudo pecl install swoole

然后在 /etc/php/*/cli/php.ini 和 /etc/php/*/fpm/php.ini 中添加：

extension=swoole.so

安装 Composer 并创建 Hyperf 项目

确保已安装 Composer（Ubuntu 下可运行 sudo apt install composer）。

执行一键创建命令（使用官方推荐的 hyperf-skeleton）：

composer create-project hyperf/hyperf-skeleton myapp

进入项目目录：

cd myapp

Hyperf 默认使用 dev 环境，无需额外配置即可启动。

Hyperframes Creative

HyperFrames视频非动画创意指导，包括设计规范（frame.md/design.md）处理、配色、字体设计、旁白及节奏规划等。

下载

启动服务并验证

直接运行：

php bin/hyperf.php start

服务默认监听 http://127.0.0.1:9501。打开浏览器或执行：

curl http://127.0.0.1:9501

应返回 Hello Hyperf!。

如需后台运行，可用：

nohup php bin/hyperf.php start > /dev/null 2>&1 &

或配合 systemd 管理（生产环境推荐）。

常见问题速查

• 启动报错 Swoole extension not loaded：确认 php.ini 已加载且 CLI 使用的是同一配置（用 php --ini 查看路径）；

• 访问 9501 端口无响应：检查是否被防火墙拦截（sudo ufw status），或确认未被其他进程占用；

• 首次启动慢：Composer 自动加载优化未生效，可运行 composer dump-autoload -o 加速。