Hyperf框架安装指南：从环境准备到项目创建

Hyperf框架安装指南：从环境准备到项目创建

【免费下载链接】hyperf 项目地址: https://gitcode.com/gh_mirrors/hyp/hyperf

环境要求概述

Hyperf是一款高性能PHP协程框架，对运行环境有特定要求。首先需要明确的是，Hyperf原生支持Linux和MacOS系统环境。对于Windows用户，虽然可以通过Docker for Windows实现开发环境搭建，但官方更推荐使用Linux或MacOS作为开发环境。

系统兼容性说明

MacOS用户需要注意：如果选择本地部署而非Docker方式，可能会遇到Docker共享磁盘导致的Hyperf启动缓慢问题。这是由于MacOS与Docker的文件系统交互机制决定的。

环境部署方案选择

开发者可以根据实际情况选择以下三种环境部署方案之一：

1. Docker容器化部署（推荐）
2. Box环境部署
3. 原生环境手动配置

详细环境要求

PHP版本要求

Hyperf要求PHP版本不低于8.1，这是利用了PHP 8.1的新特性和性能改进。

网络引擎选择

Hyperf支持两种网络引擎，开发者需至少安装其中一种：

1. Swoole PHP扩展（≥5.0版本）
   • 需在php.ini中设置swoole.use_shortname = Off
2. Swow PHP扩展（≥1.4版本）

必需PHP扩展

• JSON扩展（基础支持）
• OpenSSL扩展（HTTPS支持）
• PDO扩展（MySQL客户端支持）
• Redis扩展（Redis客户端支持）
• Protobuf扩展（gRPC服务/客户端支持）

注意：使用Swoole引擎时还需安装Pcntl扩展。

项目安装流程

通过Composer创建项目

Hyperf使用Composer管理依赖，安装前请确保已正确安装Composer。

基于Swoole引擎的项目创建

composer create-project hyperf/hyperf-skeleton

基于Swow引擎的项目创建

composer create-project hyperf/swow-skeleton

安装过程中，对于不确定的选项建议直接按Enter键使用默认值，避免因配置不当导致服务无法启动。

Docker开发环境配置

对于不满足原生环境要求或希望快速上手的开发者，Docker是最佳选择。

1. 启动容器

执行以下命令启动Hyperf开发容器：

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

参数说明：

• -v：挂载本地目录到容器
• -p：端口映射
• --privileged -u root：解决SELinux限制

2. 创建项目

进入容器后执行：

cd /data/project
composer create-project hyperf/hyperf-skeleton

3. 启动项目

cd hyperf-skeleton
php bin/hyperf.php start

开发提示：Hyperf是持久化CLI框架，代码修改后需要终止当前进程（Ctrl+C）并重新启动才能生效。

兼容性注意事项

由于Hyperf基于Swoole的协程特性，部分PHP扩展存在兼容性问题，主要包括：

• xhprof
• xdebug（PHP 8.1+和Swoole ≥5.0.2环境下可用）
• blackfire
• trace
• uopz

开发者在使用这些扩展时需要特别注意兼容性问题，建议在开发环境中进行充分测试。

通过以上步骤，开发者可以顺利完成Hyperf框架的安装和环境配置，为后续的高性能应用开发奠定基础。

【免费下载链接】hyperf 项目地址: https://gitcode.com/gh_mirrors/hyp/hyperf