HyperfLinux安装教程详解

本文详细介绍了在 Linux 系统上无需 Docker、仅依赖 Composer 即可完成 Hyperf 高性能 PHP 框架安装的完整流程，重点强调了四大关键前提：PHP ≥ 8.1、Swoole ≥ 5.0 且禁用短名、必备扩展（尤其是常被遗漏的 fileinfo）、以及 memory_limit ≥ 1024M；通过清晰的四步实操——环境校验、PHP 与 Swoole 配置调优、Composer 项目初始化、服务启动与端口验证，手把手助你快速跑通 “Hello Hyperf”，为后续集成 Redis、MySQL、JWT 等生产级组件打下坚实基础。

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-project
• composer 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 等组件就顺了。

终于介绍完啦！小伙伴们，这篇关于《HyperfLinux安装教程详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！