直接用 Docker 最省事，不用配 PHP、Swoole、扩展等底层环境；先安装 Docker，再拉取 hyperf/hyperf:8.1-alpine-v3.16-swoole 镜像，通过 docker run 启动容器并挂载本地目录，进入容器后用 composer create-project 初始化项目，执行 php bin/hyperf.php start 启动服务，访问 http://127.0.0.1:9501 即可验证成功。
直接用 Docker 最省事，不用配 PHP、Swoole、扩展这些底层环境，Debian 上装完 Docker 就能跑起来。
一、先装好 Docker 和基础工具
Hyperf 依赖 PHP + Swoole 协程运行时，自己编译安装对新手太不友好。Docker 镜像里已经打包好了全部运行环境，你只管写代码。
- 更新系统并安装 Docker：
sudo apt update && sudo apt install -y curl gnupg2 software-properties-common
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER（执行后退出终端重进，或运行 newgrp docker）
- 验证是否成功：
docker --version 和 docker run hello-world
二、拉取镜像并启动 Hyerf 容器
官方维护了多个版本的 hyperf/hyperf 镜像，推荐用带 Alpine 和 Swoole 的稳定版，比如 8.1-alpine-v3.16-swoole（兼容性好、体积小）。
- 拉镜像（首次会稍慢）：
docker pull hyperf/hyperf:8.1-alpine-v3.16-swoole
- 启动容器，映射本地目录和端口（例如把项目放在 ~/hyperf-app）：
mkdir -p ~/hyperf-app
docker run -it --name hyperf-dev \
-v ~/hyperf-app:/opt/www \
-p 9501:9501 \
--privileged -u root \
--entrypoint /bin/sh \
hyperf/hyperf:8.1-alpine-v3.16-swoole
执行后你就进入了容器内部的 shell，路径是 /opt/www，也就是你宿主机的 ~/hyperf-app。
三、初始化项目骨架
在容器内操作（就是上一步进入的黑框里）：
- 换阿里云 Composer 源（国内更快）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer
- 创建 Hyperf 项目（自动交互式配置，按需选 MySQL/Redis 等）：
cd /opt/www && composer create-project hyperf/hyperf-skeleton
提示选择时，时区填 Asia/Shanghai，数据库/Redis 选 y 或 n 都行，不影响启动。
- 进入项目并启动服务：
cd hyperf-skeleton && php bin/hyperf.php start
看到 Server started 就成功了。打开浏览器访问 http://127.0.0.1:9501，返回 {"method":"GET","message":"Hello Hyperf."} 即可。
四、后续开发小贴士
代码都在宿主机 ~/hyperf-app/hyperf-skeleton 里，用 VS Code、PhpStorm 直接编辑，改完保存后，在容器里按 Ctrl+C 停服务，再执行 php bin/hyperf.php start 重启即可生效。
- 常用命令备查：
docker ps — 查看正在运行的容器
docker start hyperf-dev — 启动已停止的容器
docker exec -it hyperf-dev /bin/sh — 重新进入容器
docker stop hyperf-dev — 停止容器
不复杂但容易忽略：每次改完代码必须重启服务，Hyperf 不支持热重载。
