Hyperf 在 Linux 上可直接用 Composer 安装，无需 Docker，关键需满足 PHP ≥ 8.1、启用 Swoole ≥ 5.0（swoole.use_shortname = Off）、必备扩展（如 fileinfo）及 memory_limit ≥ 1024M；按环境准备、PHP 配置、项目创建、启动验证四步即可完成。
Hyperf 在 Linux 上安装不依赖 Docker，直接用 Composer 就能完成，关键是要满足 PHP 环境和协程扩展要求。下面分四步讲清楚：环境准备、PHP 配置调整、项目创建、启动验证。
确认系统与 PHP 环境是否达标
Hyperf 要求：
- Linux（推荐 CentOS 7+/Ubuntu 20.04+）、PHP ≥ 8.1（不能是 8.0 或更低）
- 必须启用 Swoole 扩展（≥ 5.0），且 swoole.use_shortname = Off
- 必需 PHP 扩展：json、pdo、openssl、ctype、filter、hash、mbstring、pcre、fileinfo（常被忽略）
- 内存建议 ≥ 2GB，php.ini 中 memory_limit 至少设为 1024M
配置 PHP 并启用 Swoole
检查并修正常见配置项：
- 运行
php -v和php -m | grep swoole确认版本和加载状态 - 编辑 php.ini（路径通常为
/etc/php.d/swoole.ini或/usr/local/php/lib/php.ini）：- 添加
extension=swoole.so - 添加
swoole.use_shortname = Off - 修改
memory_limit = 1024M - 确保
disable_functions中未禁用proc_open、pcntl_fork（Hyperf 启动会用到）
- 添加
- 重启 PHP 服务（如 php-fpm）或 Web 服务器（Nginx/Apache）
用 Composer 创建 Hyperf 项目
执行以下命令（无需 root 权限，普通用户即可）：
mkdir /var/www/hyperf-project && cd /var/www/hyperf-projectcomposer create-project hyperf/hyperf-skeleton . --prefer-dist -n- 安装完成后，目录含
app/、config/、bin/hyperf.php等标准结构 - 若国内下载慢，可提前设置阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer
启动服务并验证端口
启动后默认监听 9501 端口：
php bin/hyperf.php start- 检查端口占用：
ss -tuln | grep :9501或lsof -i :9501 - 如提示“Address already in use”，用
kill -9 $(lsof -t -i :9501)清理 - 浏览器访问
http://你的服务器IP:9501，看到Hello Hyperf即成功 - 生产环境建议用 Supervisor 管理进程（配置见官方文档），避免前台中断导致服务退出
不复杂但容易忽略细节，重点就是 PHP 版本、Swoole 开关、fileinfo 扩展和内存限制这四项。装完跑通 hello world，后续加 Redis、MySQL、JWT 等组件就顺了。
