华为云弹性云服务器搭建Hyperf部署指南

在华为云ECS上部署Hyperf需构建常驻进程式PHP协程环境：选用CentOS 7.9/Ubuntu 22.04镜像，安装PHP 8.1+Swoole 5.1+并启用ZTS与OPcache，配置server.php绑定0.0.0.0:9501，禁止root运行，通过systemd托管服务并统一日志路径。

在华为云ECS上部署Hyperf，核心是构建稳定、高性能的PHP协程微服务环境。Hyperf依赖于Swoole扩展和PHP 8.0+，不能直接用传统Apache/Nginx+PHP-FPM方式运行，必须以常驻进程模式启动。

一、ECS基础配置与系统准备

选择兼容Hyperf的实例规格和镜像：

• 推荐镜像：CentOS 7.9 或 Ubuntu 22.04 LTS（确保内核≥5.4，利于Swoole协程调度）
• CPU架构：X86_64（当前Hyperf主版本对ARM64支持有限，鲲鹏需验证swoole-arm64编译兼容性）
• 内存建议≥2GB（Hyperf常驻进程+Redis/MySQL连接池会占用较多内存）
• 安全组务必放行业务端口（如9501）、SSH（22）及必要数据库端口（3306/6379）

二、安装运行环境（PHP + Swoole + Composer）

Hyperf要求PHP ≥8.0且启用ZTS线程安全，Swoole ≥5.0（推荐5.1+）：

Hyperf 3.2.4

Hyperf 3.2.4 官方源码下载，适合 PHP 协程框架、微服务组件和高并发应用升级，覆盖 3.2 分支新增函数与稳定性优化。

下载

• Ubuntu用户可使用ondrej/php PPA源快速安装：sudo add-apt-repository ppa:ondrej/php && sudo apt update && sudo apt install php8.1-cli php8.1-zip php8.1-mbstring php8.1-curl php8.1-xml php8.1-bcmath php8.1-sqlite3
• CentOS需手动编译Swoole（官方推荐）：wget https://github.com/swoole/swoole-src/archive/v5.1.3.tar.gz && tar -xzf v5.1.3.tar.gz && cd swoole-src-5.1.3 && phpize && ./configure --enable-openssl --enable-http2 && make && sudo make install
• 启用扩展：在/etc/php/*/cli/php.ini中添加extension=swoole，并确认zend_extension=opcache已开启
• 安装Composer：curl -sS https://getcomposer.org/installer | php && sudo mv composer.phar /usr/local/bin/composer

三、创建与部署Hyperf项目

使用Hyperf官方脚手架初始化项目，并适配华为云网络环境：

• 执行composer create-project hyperf/hyperf-skeleton myapp生成项目
• 修改config/autoload/server.php中的server配置：将bind_address设为0.0.0.0（非127.0.0.1），端口按需设为9501或其它非特权端口
• 若需HTTPS，不建议在Hyperf层直接处理，应由华为云ELB或Nginx反向代理终止SSL；Hyperf保持HTTP明文通信
• 启动服务：cd myapp && php bin/hyperf.php start（生产环境建议用systemd托管）

四、生产环境加固与运维要点

避免常见上线故障，重点关注权限、日志与进程管理：

• 禁止root用户运行Hyperf：创建普通用户（如hyperf），用chown -R hyperf:hyperf myapp授权
• 配置systemd服务文件（/etc/systemd/system/hyperf.service），含User=hyperf、Restart=always、WorkingDirectory=/var/www/myapp
• 日志路径建议统一到/var/log/hyperf/，并在config/autoload/logger.php中配置rotate策略
• 华为云ECS若启用了主机安全（HSS），需确认其未拦截php进程的网络监听行为，必要时在HSS控制台添加白名单