限时 5折! 详情

hyperf 实战之安装

2628 0 0

首先,我本地的环境是 Mac + PHP 7.4.21 + Swoole Version => 4.6.7 + Composer version 2.4.4,作为学习,建议大家统一选择官方的 docker 镜像。

我们先在本地创建一个目录,这个目录会直接映射到 hyperf 容器的 /data/project 目录。

~ » cd /data/work
/data/work » mkdir questions_learn

执行下面的命令安装 hyperf 镜像,可能需要等待几分钟等待时间(如果本地没有这个镜像的话)。

docker run --name hyperf-php-8.0 \
-v /data/work/questions_learn:/data/project \
-e APP_ENV=dev \
-e SCAN_CACHEABLE=false \
-p 9501:9501 -it \
--privileged -u root \
--entrypoint /bin/sh \
hyperf/hyperf:8.0-alpine-v3.15-swoole

在这一步中,大家记得把 -v 后面的 "/data/work/questions_learn" 改成你本地的目录,其他的保持不变。

上面的安装命令执行成功后,我们就已经在 hyperf 容器内了,来一起看下 hyperf 容器内的环境。

/ # php -v
PHP 8.0.18 (cli) (built: Apr 22 2022 22:53:40) ( NTS )
Copyright (c) The PHP Group
Zend Engine v4.0.18, Copyright (c) Zend Technologies
    with Zend OPcache v8.0.18, Copyright (c), by Zend Technologies
/ # php --ri swoole
swoole
Swoole => enabled
Author => Swoole Team <team@swoole.com>
Version => 5.0.0
Built => Aug  2 2022 03:09:01
coroutine => enabled with boost asm context
epoll => enabled
eventfd => enabled
signalfd => enabled
spinlock => enabled
rwlock => enabled
openssl => OpenSSL 1.1.1q  5 Jul 2022
dtls => enabled
http2 => enabled
json => enabled
curl-native => enabled
pcre => enabled
zlib => 1.2.12
brotli => E16777225/D16777225
mutex_timedlock => enabled
pthread_barrier => enabled
async_redis => enabled
Directive => Local Value => Master Value
swoole.enable_coroutine => On => On
swoole.enable_library => On => On
swoole.enable_preemptive_scheduler => Off => Off
swoole.display_errors => On => On
swoole.use_shortname => Off => Off
swoole.unixsock_buffer_size => 8388608 => 8388608
/ # composer -V
Composer version 2.2.1 2021-12-22 22:21:31
/ # composer config -gl
[repositories.packagist.org.type] composer
[repositories.packagist.org.url] https://repo.packagist.org
......(省略了其他代码)

可以看到,官方镜像默认支持了很多扩展,如果你选择自己本地的环境,请至少确保你的运行环境达到了以下要求:

  • PHP >= 8.0 and <= 8.1
  • Swoole PHP 扩展 >= 4.5,并关闭了 Short Name
  • JSON PHP 扩展
  • Pcntl PHP 扩展
  • enabled swoole coroutine、openssl、curl-native、async_redis、rwlock、pcre、zlib、brotl

另外,由于 Hyperf 基于 Swoole 协程实现,而 Swoole 4 带来的协程功能是 PHP 前所未有的,所以与不少扩展都仍存在兼容性的问题。

以下扩展(包括但不限于)都会造成一定的兼容性问题,不能与之共用或共存:

  • xhprof
  • xdebug
  • blackfire
  • trace
  • uopz

这些我们基本也用不上,推荐大家按照文中的操作,选择官方镜像。

下面我们继续在容器内操作。

创建一个项目,并命名 questions

# cd /data/project/
/data/project # composer create-project hyperf/hyperf-skeleton questions

执行 composer create-project 命令的时候,开始会一直提示我们安装一大堆东西,直接全部回车,后面需要我们再手动进行安装。

安装好之后,安装的 hyperf 是 3.0 版本,通过 composer info 命令可以查看已安装的 hyperf 相关的版本信息。

/data/project/questions # composer info | grep hyperf
hyperf/cache                       v3.0.0  A cache component for hyperf.
hyperf/command                     v3.0.0  Command for hyperf
hyperf/config                      v3.0.0  An independent component that provides configuration container.
hyperf/context                     v3.0.0  A coroutine context library.
hyperf/contract                    v3.0.0  The contracts of Hyperf.
hyperf/coordinator                 v3.0.0  Hyperf Coordinator
hyperf/database                    v3.0.0  A flexible database library.
hyperf/db-connection               v3.0.0  A hyperf db connection handler for hyperf/database.
hyperf/devtool                     v3.0.0  A Devtool for Hyperf.
hyperf/di                          v3.0.0  A DI for Hyperf.
hyperf/dispatcher                  v3.0.0  A HTTP Server for Hyperf.
hyperf/engine                      v2.1.1
hyperf/engine-contract             v1.2.0  Contract for Coroutine Engine
hyperf/event                       v3.0.0  an event manager that implements PSR-14.
hyperf/exception-handler           v3.0.0  Exception handler for hyperf
hyperf/framework                   v3.0.0  A coroutine framework that focuses on hyperspeed and flexible, specifically use for build microservices and middlewares.
hyperf/guzzle                      v3.0.0  Swoole coroutine handler for guzzle
hyperf/http-message                v3.0.0  microservice framework base on swoole
hyperf/http-server                 v3.0.0  A HTTP Server for Hyperf.
hyperf/logger                      v3.0.0  A logger component for hyperf.
hyperf/macroable                   v3.0.0  Hyperf Macroable package which come from illuminate/macroable
hyperf/memory                      v3.0.0  An independent component that use to operate and manage memory.
hyperf/model-listener              v3.0.0  A model listener for Hyperf.
hyperf/pool                        v3.0.0  An independent universal connection pool component.
hyperf/process                     v3.0.0  A process component for hyperf.
hyperf/redis                       v3.0.0  A redis component for hyperf.
hyperf/server                      v3.0.0  A base server library for Hyperf.
hyperf/testing                     v3.0.0  Testing for hyperf
hyperf/utils                       v3.0.0  A tools package that could help developer solved the problem quickly.

启动项目测试下是否安装成功

/data/project/questions # php bin/hyperf.php start
[DEBUG] Event Hyperf\Framework\Event\BootApplication handled by Hyperf\Config\Listener\RegisterPropertyHandlerListener listener.
[DEBUG] Event Hyperf\Framework\Event\BootApplication handled by Hyperf\ExceptionHandler\Listener\ErrorExceptionHandler listener.
[DEBUG] Event Hyperf\Framework\Event\BootApplication handled by Hyperf\ExceptionHandler\Listener\ExceptionHandlerListener listener.
[DEBUG] Event Hyperf\Framework\Event\BootApplication handled by Hyperf\DbConnection\Listener\RegisterConnectionResolverListener listener.
[DEBUG] Event Hyperf\Framework\Event\BeforeMainServerStart handled by Hyperf\Process\Listener\BootProcessListener listener.
[DEBUG] Event Hyperf\Framework\Event\OnManagerStart handled by Hyperf\Server\Listener\InitProcessTitleListener listener.
[INFO] Worker#3 started.
[INFO] Worker#2 started.
[DEBUG] Event Hyperf\Framework\Event\OnStart handled by Hyperf\Server\Listener\InitProcessTitleListener listener.
[DEBUG] Event Hyperf\Framework\Event\AfterWorkerStart handled by Hyperf\Server\Listener\AfterWorkerStartListener listener.
[DEBUG] Event Hyperf\Framework\Event\AfterWorkerStart handled by Hyperf\Server\Listener\AfterWorkerStartListener listener.
[INFO] Worker#0 started.
[DEBUG] Event Hyperf\Framework\Event\AfterWorkerStart handled by Hyperf\Server\Listener\InitProcessTitleListener listener.
[DEBUG] Event Hyperf\Framework\Event\AfterWorkerStart handled by Hyperf\Server\Listener\InitProcessTitleListener listener.
[INFO] HTTP Server listening at 0.0.0.0:9501
[DEBUG] Event Hyperf\Framework\Event\AfterWorkerStart handled by Hyperf\Server\Listener\AfterWorkerStartListener listener.
[INFO] Worker#1 started.
[DEBUG] Event Hyperf\Framework\Event\AfterWorkerStart handled by Hyperf\Server\Listener\InitProcessTitleListener listener.
[DEBUG] Event Hyperf\Framework\Event\AfterWorkerStart handled by Hyperf\Server\Listener\AfterWorkerStartListener listener.
[INFO] Worker#4 started.
[DEBUG] Event Hyperf\Framework\Event\AfterWorkerStart handled by Hyperf\Server\Listener\InitProcessTitleListener listener.
[DEBUG] Event Hyperf\Framework\Event\AfterWorkerStart handled by Hyperf\Server\Listener\AfterWorkerStartListener listener.
[DEBUG] Event Hyperf\Framework\Event\AfterWorkerStart handled by Hyperf\Server\Listener\InitProcessTitleListener listener.

这里注意,更改过框架内的任何代码,都需要手动执行 php bin/hyperf.php start 命令,已经启动的服务可以在终端按住 Ctrl + C 键停止服务。

本地我们先按照这个模式走,后期上线会全自动操作,这点无需担心。

窗口卡着不动即表示安装成功。

以上,我们都是在容器内执行的命令操作。

回到宿主机内,对本地的 9501 端口请求测试。

/data/work » curl 127.0.0.1:9501
{"method":"GET","message":"Hello Hyperf."}%

至此,hyperf 框架已经安装完毕。

教程中演示的所有代码,都会上传在 https://github.com/bailangzhan/questions_learn。

安装上如果有任何问题,可以在文章下面或者在 http://funqas.com/ 上提问留言。

立即购买