在 centos 上用 docker 快速安装 hyperf 的核心是跳过本地 php 环境搭建，直接复用官方镜像启动容器并挂载代码目录；需先确认 docker 已就绪、配置镜像加速器，再拉取 hyperf/hyperf 镜像、运行容器、在容器内用 composer 初始化项目并启动服务。
在 CentOS 上用 Docker 快速安装 Hyperf，核心是跳过本地 PHP 环境搭建，直接复用官方镜像启动容器，并挂载代码目录实现开发联动。整个过程不依赖宿主机的 PHP、Composer 或扩展配置，5 分钟内可跑起项目骨架。
确认 Docker 已就绪
先确保 Docker 在 CentOS 上已正确安装并运行：
- 执行 docker --version 查看版本（建议 ≥ 20.10）
- 运行 sudo docker run hello-world 验证引擎正常
- 若提示权限错误，把当前用户加入 docker 组：sudo usermod -aG docker $USER，然后退出终端重登
- 国内网络建议提前配置镜像加速器（如阿里云
https://alzgoonw.mirror.aliyuncs.com），写入/etc/docker/daemon.json后执行 sudo systemctl restart docker
拉取并运行 Hyperf 官方镜像
Hyperf 提供了多版本预装 Swoole 的 Alpine 镜像，推荐使用带 CLI 和 Swoole 的轻量版：
- 拉取镜像（例如 PHP 8.2 + Swoole 5）：docker pull hyperf/hyperf:8.2-alpine-v3.19-swoole
- 创建本地项目目录：mkdir -p ~/hyperf-app
- 运行容器并挂载目录：
docker run -v $(pwd)/hyperf-app:/hyperf -p 9501:9501 -it --entrypoint /bin/sh hyperf/hyperf:8.2-alpine-v3.19-swoole - 注意：
-v参数中宿主机路径需写绝对路径（可用$(pwd)动态展开），容器内路径固定为/hyperf
在容器内初始化 Hyperf 项目
进入容器后，直接用内置 Composer 创建骨架：
- 切换到挂载目录：cd /hyperf
- 执行安装命令：composer create-project hyperf/hyperf-skeleton .（末尾的
.表示当前目录） - 等待完成，会生成标准 Hyperf 目录结构（
app/、config/、bin/hyperf.php等） - 启动服务：php bin/hyperf.php start
- 此时服务已在容器 9501 端口运行，宿主机访问 http://localhost:9501 即可看到默认欢迎页
后续开发与调试建议
项目代码位于宿主机 ~/hyperf-app，可直接用 VS Code、PhpStorm 等编辑，修改后容器内实时生效（无需重启）：
- 如需安装新组件（如 Redis 扩展），进容器执行 pecl install redis && docker-php-ext-enable redis
- 日志和配置文件都在宿主机目录，便于备份和版本管理
- 生产部署时，建议改用
docker build构建自定义镜像，而非交互式运行 - 若需 MySQL/Redis 等配套服务，可用
docker-compose.yml一键编排（Hyperf 官方文档提供模板）
