在华为云服务器上快速搭建hyperf环境,需选用centos 8 stream或ubuntu 22.04 lts镜像,安装php 8.1+及swoole扩展,通过composer创建skeleton项目并启动服务,默认监听9501端口,生产环境需调优worker_num、关闭debug、配合supervisor守护进程。

在华为云服务器上快速搭建Hyperf环境,核心是选对系统镜像、装好基础依赖、用标准方式初始化项目——不需要 Docker 也能跑得稳,尤其适合生产部署场景。
系统与PHP环境准备
推荐使用华为云官方提供的 CentOS 8 Stream 或 Ubuntu 22.04 LTS 镜像(已预装常用工具,兼容性好)。创建实例后,执行以下命令:
- 更新系统并安装基础编译工具:
sudo apt update && sudo apt install -y php8.1-cli php8.1-mbstring php8.1-xml php8.1-json php8.1-opcache php8.1-pdo php8.1-mysql php8.1-redis php8.1-curl php8.1-zip unzip git(Ubuntu)
或 CentOS 使用:sudo dnf install -y php php-cli php-mbstring php-xml php-json php-opcache php-pdo php-mysqlnd php-pecl-redis php-curl php-zip unzip git - 确认 PHP 版本不低于 8.1:
php -v - 安装 Swoole 扩展(Hyperf 默认驱动):
pecl install swoole,然后在/etc/php/*/cli/php.ini中添加extension=swoole,重启 CLI 环境(无需 Apache/Nginx)
安装 Composer 并创建项目
Composer 是 Hyerf 的标配依赖管理器:
- 下载并全局安装 Composer:
curl -sS https://getcomposer.org/installer | php<br>sudo mv composer.phar /usr/local/bin/composer
- 用骨架项目快速启动(推荐 Swoole 驱动):
composer create-project hyperf/hyperf-skeleton myapp - 进入目录并启动服务:
cd myapp<br>php bin/hyperf.php start
默认监听 0.0.0.0:9501,确保华为云安全组已放行该端口(TCP 协议)。
配置与优化要点
刚启动的服务只是开发态,生产需微调:
- 修改
config/autoload/server.php中的worker_num(建议设为 CPU 核数 × 2),并启用max_coroutine(如100000)提升并发能力 - 关闭调试模式:将
.env中的APP_ENV=prod和DEBUG=false - 若需 HTTPS,安装 OpenSSL 扩展,并在 server 配置中开启
ssl_cert_file和ssl_key_file - 建议搭配 Supervisor 管理进程,避免终端断开导致服务退出
可选:轻量级容器化(非必须)
如果偏好容器,华为云 ECS 已预装 Docker。可直接拉取官方镜像:docker run -d --name hyperf-app -p 9501:9501 -v $(pwd)/myapp:/opt/www -w /opt/www hyperf/hyperf:8.1-alpine php bin/hyperf.php start
但注意:本地开发更推荐原生部署,避免 Docker 文件挂载性能损耗。











