安装

    hyperf-cloud\hyperf-docker 项目内已经为您准备好了各种版本的 Dockerfile ，或直接基于已经构建好的 镜像来运行。

    • PHP >= 7.2
    • Swoole PHP 扩展 >= 4.4，并关闭了 Short Name
    • OpenSSL PHP 扩展
    • JSON PHP 扩展
    • PDO PHP 扩展 （如需要使用到 MySQL 客户端）
    • Protobuf PHP 扩展 （如需要使用到 gRPC 服务端或客户端）

    Hyperf 使用 Composer 来管理项目的依赖，在使用 Hyperf 之前，请确保你的运行环境已经安装好了 Composer。

    Docker 下开发

    假设您的本机环境并不能达到 Hyperf 的环境要求，或对于环境配置不是那么熟悉，那么您可以通过以下方法来运行及开发 Hyperf 项目：

    1. # 下载并运行 hyperf/hyperf 镜像，并将镜像内的项目目录绑定到宿主机的 /tmp/skeleton 目录
    2. docker run -v /tmp/skeleton:/hyperf-skeleton -p 9501:9501 -it --entrypoint /bin/sh hyperf/hyperf:7.2-alpine-cli
    4. # 镜像容器运行后，在容器内安装 Composer
    6. chmod u+x composer.phar
    7. mv composer.phar /usr/local/bin/composer
    8. # 将 Composer 镜像设置为阿里云镜像，加速国内下载速度
    9. composer config -g repo.packagist composer https://mirrors.aliyun.com/composer
    10. # 通过 Composer 安装 hyperf/hyperf-skeleton 项目
    13. # 进入安装好的 Hyperf 项目目录
    14. cd hyperf-skeleton
    15. # 启动 Hyperf
    16. php bin/hyperf.php start

    由于 Hyperf 基于 Swoole 协程实现，而 Swoole 4 带来的协程功能是 PHP 前所未有的，所以与不少扩展都仍存在兼容性的问题。以下扩展（包括但不限于）都会造成一定的兼容性问题，不能与之共用或共存：

    • xhprof
    • xdebug
    • blackfire
    • uopz