Hyperf框架安装与运行环境配置指南
项目地址: https://gitcode.com/gh_mirrors/hy/hyperf 前言
Hyperf是一款基于PHP的高性能企业级协程框架，专为微服务和中间件开发而设计。本文将详细介绍如何在不同环境下安装和配置Hyperf框架，帮助开发者快速搭建开发环境。
系统环境要求
操作系统支持
Hyperf原生支持Linux和MacOS系统环境。对于Windows用户，可以通过Docker for Windows实现虚拟化支持。特别需要注意的是，MacOS用户建议本地部署以避免Docker共享磁盘导致的Hyperf启动缓慢问题。
基础环境要求
PHP版本
- PHP ≥ 8.1
网络引擎（二选一）
- Swoole PHP扩展 ≥ 5.0（需在php.ini中设置
swoole.use_shortname = Off） - Swow PHP扩展 ≥ 1.4
必需扩展
- JSON扩展
- OpenSSL扩展（如需使用HTTPS）
- PDO扩展（如需使用MySQL客户端）
- Redis扩展（如需使用Redis客户端）
- Protobuf扩展（如需使用gRPC服务或客户端）
Swoole特有要求
- Pcntl扩展（仅在使用Swoole引擎时需要）
安装方式
1. 使用Composer创建项目
Hyperf使用Composer管理项目依赖，安装前请确保已安装Composer。
基于Swoole引擎的项目
composer create-project hyperf/hyperf-skeleton
基于Swow引擎的项目
composer create-project hyperf/swow-skeleton
注意：安装过程中，对于不确定的选项建议直接按Enter键使用默认值，避免因自动添加未配置的监听器导致服务无法启动。
2. Docker开发环境配置
对于不满足系统要求或不熟悉环境配置的开发者，推荐使用Docker进行开发。
步骤一：启动容器
docker run --name hyperf \
-v /本地项目路径:/data/project \
-p 9501:9501 -it \
--privileged -u root \
--entrypoint /bin/sh \
hyperf/hyperf:8.1-alpine-v3.18-swoole
步骤二：创建项目
cd /data/project
composer create-project hyperf/hyperf-skeleton
步骤三：启动项目
cd hyperf-skeleton
php bin/hyperf.php start
提示：Hyperf是持久化的CLI框架，修改代码后需要先终止运行中的进程（CTRL+C），然后重新执行启动命令以加载最新代码。
不兼容扩展说明
由于Hyperf基于Swoole的协程特性，以下扩展存在兼容性问题（包括但不限于）：
- xhprof
- xdebug（PHP 8.1+和Swoole ≥ 5.0.2环境下可用）
- blackfire
- trace
- uopz
环境配置建议
- 开发环境：推荐使用Docker，确保环境一致性
- 生产环境：建议使用Linux服务器+Swoole扩展
- 性能调优：根据实际业务场景调整Swoole的worker_num等参数
- 扩展管理：仅加载必要的PHP扩展，避免资源浪费
常见问题解决方案
- Swoole短名问题：确保php.ini中设置
swoole.use_shortname = Off - 端口冲突：检查9501端口是否被占用
- 权限问题：Docker环境下确保有足够权限访问宿主机目录
- 扩展缺失：通过
php -m命令检查必需扩展是否加载
通过以上步骤，您应该已经成功搭建了Hyperf开发环境。接下来可以开始探索Hyperf强大的功能特性，如依赖注入、AOP、注解路由等。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
