安装运行Hyperf
安装运行Hyperf
上回讲到，我们对一个普通的 Laravel 框架进行了改造，让它可以在 Swoole 环境下使用，不过其中会有很多问题可能我们一时考虑不到，就会造成程序的稳定性出现问题。那么，今天我们就来学习一个原生的 Swoole 框架 Hyperf 。
这个框架也是国人开发的，并且还一直比较活跃，同时版本也比较新，目前写这篇文章时是 2.2 版本，需要 Swoole 4.5 以上才可以使用，而 PHP 版本需要大于等于 7.4 以上。
另外需要注意的是，运行这个框架要关闭 Swoole 配置中的 use_shortname ，也就是 php.ini 文件中，设置一下 swoole.use_shortname=0 或者 swoole.use_shortname=off 就可以了。大家也可以先不配置，然后看下在启用 use_shortname 时，运行 Hyperf 框架会报什么错。
安装过程非常简单，直接 composer 安装即可。
composer create-project hyperf/hyperf-skeleton
安装完了之后，看看目录，是不是就已经感觉和 Laravel 非常像了，怎么用呢？很简单，安装完了就可以在根目录执行下面这个命令行语句。
php bin/hyperf.php start
访问一下 localhost 的 9501 端口吧，我们就能看到 Hyperf 的首页已经输出了一段 json 语句。
{"method":"GET","message":"Hello Hyperf."}
恭喜你，安装完成了哦。
PHP8 的过时问题
在我的虚拟机环境中，因为安装的是 PHP8 所以在运行 Hyperf 的时候出现了下面的警告语句。
Deprecated: Return type of Hyperf\Database\Model\Model::offsetExists($offset) should either be compatible with ArrayAccess::offsetExists(mixed $offset): bool, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /home/www/6.框架/hyperf-skeleton/vendor/hyperf/database/src/Model/Model.php on line 1156
这其实是 PHP8 的一个新特性，ReturnTypeWillChange 的意思就是如果你要是实现了一个接口中的方法，那么返回值也要定义成和接口中的方法定义一样的，如果没有定义返回值或者不一样，就会报这种过时警告。其实这不是什么大事，你可以忽略它。如果看得不习惯的话，找到框架中的代码源文件，比如上面的 Hyperf\Database\Model\Model 这个类文件，然后在它的 offsetExists() 方法上加上 #[\ReturnTypeWillChange] 注解，或者给这个 offsetExists() 方法指定返回值就行了。
后面录制视频时，会在本机使用 PHP7 环境，不会出现这个问题。
路由、控制器及视图页面
Hyperf 的路由文件在 config/routes.php 中，可以看到默认首页的路由是这样子的。
Router::addRoute(['GET', 'POST', 'HEAD'], '/', 'App\Controller\IndexController@index');
它指向一个控制器，写法不陌生吧。IndexController 中的内容是这样的。
class IndexController extends AbstractController
{public function index(){$user = $this->request->input('user', 'Hyperf');$method = $this->request->getMethod();
return ['method' => $method,'message' => "Hello {$user}.",];}
}
也不陌生吧，注意，这里不要 echo 了哦，你可以 echo 一下试试，同样也是打印在控制台的，它最终输出的内容是需要 return 回去的，就像 Laravel 的 Response 对象一样。不过我们其实已经猜到了，这里的 Return 对象是会最终通过 Swoole 的 Response 对象发送回浏览器的。
我们也可以像 Laravel 那样定义直接操作的回调路由。
Router::get('/test1', function () {return 'This is Test1';
});
当然，我们也可以返回输出视图页面，不过这个要麻烦一点。为什么呢？因为 Hyperf 更倾向于去做后端服务，它的前端输出是需要单独再安装组件的。我们需要安装下面几个组件。
composer require hyperf/view composer require duncan3dc/blade composer require hyperf/task
然后生成一个 view 相关的配置。
php bin/hyperf.php vendor:publish hyperf/view
这时，会在 config/autoload 目录下多出一个 view.php 的配置文件，接着去配置它吧。
return ['engine' => \Hyperf\View\Engine\BladeEngine::class, // 使用和 Laravel 一样的 Blade 模板引擎'mode' => Mode::TASK, // 使用 Task 模式，还需要单独去配置 Task 相关的配置'config' => ['view_path' => BASE_PATH . '/storage/view/', // 模板文件路径，不存在自己创建下'cache_path' => BASE_PATH . '/runtime/view/', // 模板缓存文件路径，不存在自己创建下], ];
其中，mode 可以选择 Mode::SYNC 和 Mode::TASK 两种模式，SYNC 是同步模式，要使用协程安全的模板引擎，所以官方更推荐使用 TASK 模式，但开启 TASK 模式又需要一些别的配置，主要就是配置一下 config/autoload/server.php 这个配置文件。
// 在 setting 中添加 'setting' =>[// ...// Task Worker 数量，根据您的服务器配置而配置适当的数量'task_worker_num' => 8,// 因为 `Task` 主要处理无法协程化的方法，所以这里推荐设为 `false`，避免协程下出现数据混淆的情况'task_enable_coroutine' => false, ], // 在 callbacks 中添加 'callbacks' => [// Task callbacksEvent::ON_TASK => [Hyperf\Framework\Bootstrap\TaskCallback::class, 'onTask'],Event::ON_FINISH => [Hyperf\Framework\Bootstrap\FinishCallback::class, 'onFinish'], ]
准备工作好了之后，我们去 storage/view 目录下面新建一个 hello.blade.php 吧。
<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>Title</title>
</head>
<body>
hello {{$name}} !
</body>
</html>
然后定义一个控制器方法去使用这个模板文件并传值。
public function view(RenderInterface $render){return $render->render('hello', ['name' => 'Zyblog']);
}
RenderInterface 对象是通过依赖注入进来的一个模板渲染对象，直接调用它的 render() 方法就可以指定模板和传递参数了，其实和 Laravel 也很像，只是我们要做的准备工作更多一些。
注解定义路由
除了我们上面讲的和 Laravel 一样使用路由文件定义路由之外，我们还可以通过一种注解的方式来定义路由。
新建一个控制器。
namespace App\Controller;use Hyperf\HttpServer\Annotation\Controller;
use Hyperf\HttpServer\Annotation\RequestMapping;
use Hyperf\HttpServer\Contract\RequestInterface;#[Controller]
class AttributesController extends AbstractController
{/*** @RequestMapping(path="r", methods="get,post")*/public function route(RequestInterface $request){return ['This is Attributes Route Test','params', $request->all()];}
}
注意看哦，在类定义上面，我们使用了一个 PHP8 最新的原生注解。关于 PHP8 的注解功能，可以参考最下方参考链接中的第二条链接，鸟哥有详细的说明。然后在方法上，使用的 @RequestMapping(path="r", methods="get,post") 这种形式，它是 Hyperf 框架提供的注解能力。这两个注释的作用是什么呢？通过它们，我们可以不用去定义 routes.php 了，现在直接就可以通过 /attributes/r 来访问到这个控制器中的 route() 方法了哦，大家现在可以试试啦。
另外，还有一种更简单的路由定义方式，就是自动控制器注解。
/*** @AutoController()*/
class IndexController extends AbstractController{// ...public function test2(){return 'This is auto Test2';}
}
我把这个 AutoController 注解加到了 Index 控制器上，然后新定义了一个 test() 方法，试试用 /index/test2 这个链接来访问一下吧！
其实，注释实现的这一堆功能，很像是多年前那些老框架的实现，就像 tp3.2 时代，控制器中的方法路由就是以控制器类名和方法名来定义的。
命令行脚本
最后，我们再来看一下在 Hyperf 中如何定义运行一个 Command 脚本。这东西在 Laravel 中也很常用，而且它们非常相似。
创建命令行脚本的命令是：
php bin/hyperf.php gen:command TestCommand
运行之后在 app 目录下就会出现一个 Command 目录，里面就有一个 TestCommand.php 文件。
<?phpdeclare(strict_types=1);namespace App\Command;use Hyperf\Command\Command as HyperfCommand;
use Hyperf\Command\Annotation\Command;
use Psr\Container\ContainerInterface;/*** @Command*/
#[Command]
class TestCommand extends HyperfCommand
{/*** @var ContainerInterface*/protected $container;public function __construct(ContainerInterface $container){$this->container = $container;parent::__construct('test:show');
// parent::__construct('demo:command');}public function configure(){parent::configure();$this->setDescription('Hyperf Demo Command');}public function handle(){$this->line('Hello Hyperf!', 'info');}
}
我们就改了一个命令的名称，然后在命令行这样执行它。
php bin/hyperf.php test:show // [DEBUG] Event Hyperf\Framework\Event\BootApplication handled by Hyperf\Config\Listener\RegisterPropertyHandlerListener 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. // Hello Hyperf!
你没看错，Hyperf 的服务启动脚本和命令行启动脚本都是这个 bin/hyperf.php 文件，它还有很多其它的命令配置，后面不加参数就可以看到哦，和 Laravel 的 artisan 非常相似。
总结
今天的内容其实不少，但是经过这一篇的学习，其实我们对 Hyperf 就已经完成入门了。我们学习到了定义普通路由、注解路由，也看到了控制器和命令行的使用。后面我们将继续学习框架中的其它内容，但是，不会像 Laravel 一样进行源码级别的分析，只是简单讲讲使用哦，毕竟这个框架的复杂度又要高了不少。
测试代码：
https://github.com/zhangyue0503/swoole/tree/main/6.%E6%A1%86%E6%9E%B6/hyperf-skeleton
参考文档：
Hyperf
PHP 8新特性之Attributes(注解) - 风雪之隅
相关文章：
安装运行Hyperf
安装运行Hyperf 上回讲到，我们对一个普通的 Laravel 框架进行了改造，让它可以在 Swoole 环境下使用，不过其中会有很多问题可能我们一时考虑不到，就会造成程序的稳定性出现问题。那么，今天我们就来学习一个原生的 Swoo…...
回收站文件恢复，分享4个巧妙解决方法！
案例：回收站文件怎么恢复 【清理电脑时一不小心清空了我的回收站，有朋友知道该怎么恢复吗？急急急！】 回收站对于电脑用户来说，可以带来很多的方便，能让用户能够在删除文件后将其恢复。但是，有…...
CTF权威指南 笔记 -第三章汇编基础-3.2-x86/x64汇编基础
这节介绍PC最常见的架构 x86和扩展 x64框架 CPU操作模式 对x86处理器而言 有三个最主要的保护模式 保护模式 实地址模式 系统管理模式还有一个保护模式的子模式 虚拟8086模式 保护模式 保护模式是处理原生状态 这个时候所有指令和特性都是可以使用的 分配给程序的独立内…...
争夺汽车芯片「高地」
一直以来，汽车芯片无论是工艺制程，还是新技术的导入，都要落后消费类产品几年时间。不过，如今，随着汽车智能化进一步推动汽车制造商与上游芯片设计公司、晶圆代工厂的紧密互动，历史即将翻篇。 同时…...
SuperMap GIS基础产品三维GIS FAQ集锦（2）
SuperMap GIS基础产品三维GIS FAQ集锦（2） 【WebGL】桌面对三维缓存设置了最大最小可见高度，在iServer发布三维服务并进行预览是可以看到该效果的，但在前端代码打开该服务，最大最小可见高度效果丢失，请问怎…...
11.streamFile
1.Stream流 1.1体验Stream流【理解】 案例需求 按照下面的要求完成集合的创建和遍历 创建一个集合，存储多个字符串元素把集合中所有以"张"开头的元素存储到一个新的集合把"张"开头的集合中的长度为3的元素存储到一个新的集合遍历上一步得到的集…...
如何裁剪图片大小尺寸？
如何裁剪图片大小尺寸？平时我们在工作或者学习的时候，会经常需要将图片上传到不同的网站或者平台上，然而上传的时候经常会受到尺寸的限制，有时候尺寸太大就需要变小，为了确保上传成功，我们需要将图片进行裁…...
深度学习笔记之梯度下降、反向传播与内置优化器
文章目录 1. 梯度下降法2. 反向传播算法3. PyTorch内置的优化器3.1 SGD优化器3.2 RMSprop优化器3.3 Adam优化器 1. 梯度下降法 笔者往期的机器学习笔记： 机器学习之梯度下降算法 梯度下降法是一种致力于找到函数极值点的算法。 所谓“训练”或“学习”就是改进…...
Visual Studio 2022 搭建GLFW OpenGL开发环境
最近工作需要 需要写一个全景的视频播放器 网上搜了下大概解决方案是 ffmpegopengl b站有很多视频 按照视频 搭建了OpenGL的开发环境 先去GLFW的网站下载 windows平台的库文件 为什么使用GLFW 因为GLFW是跨平台的 我下的是64位版本解压后有目录如下 包含了动态库和静态…...
四元数快速入门【Quaternion】
四元数（Quaternion）是用于旋转和拉伸向量的数学运算符。 本文提供了一个概述，以帮助理解在空间导航等应用程序中对四元数的需求。 推荐：用 NSDT场景设计器 快速搭建3D场景。 可以通过多种方式在空间中准确定位、移动和旋转物体。 …...
为什么我们要使用向量化运算
问题背景 如果你是matlab用户，你一般都会使用向量化运算进行编程。原因也许很简单，因为matlab针对向量化运算在底层做了深度优化，尤其是针对矩阵乘法调用了MKL之类的高度优化的第三库来加速。所以我们在推演算法的阶段，尽量的以向…...
Makefile零基础教学(一)初识makefile
从这篇文章开始就开始进入 Makefile 的零基础教程，相信只要看了本教程的都可以对 Makefile 有一个清晰的理解和正确的运用。那么现在就开始我们的 Makefile 学习之路。 文章目录 一、什么是 Makefile，优点？二、什么是 make, 为什么使用make?…...
如何使用SpringMVC之常用注解
❣️关注专栏：JavaEE Spring MVC ⌛️ 1. Spring MVC 创建和连接⌛️ 1.1 RequestMapping⌛️ 1.2 GetMapping⌛️ 1.3 PostMapping ⌛️ 2. 获取参数⌛️ 2.1 传递/获取单个参数⌛️ 2.2 传递/获取多个参数⌛️ 2.3 传递/获取对象⌛️ 2.4 参数重命名⌛️ 2.4.1 …...
Vue3的axios请求封装，请求拦截，相应拦截
对于三者放在Service.js中封装，方便使用 axios.create 的作用是创建一个新的 axios 实例，该实例可以具有自定义配置。通过使用 axios.create，您可以为任何 API 生成一个客户端，并在使用同一客户端的任何调用中重复使用相同的配置…...
ZC706P试验PL_DDR3内存条的步骤方法
ZC706P 板卡完全兼容XILINX官方的ZC706,当然也支持PL外挂的1G的DDR3内存条，这个片BLOG我提供从官方下载的一个文档和一个项目，演示一下验证DDR3的步骤。 步骤1：准备好板子，安装好软件。 链接：https://pan.baidu.com/s…...
通达信W底形态选股公式，也称双底形态
W底形态，也称双底形态，是一种经典的技术分析形态，代表了跌势的逆转。看起来像字母 "W"，描述了一波下跌，反弹，再次下跌到与上一波下跌相同或相近的位置，最后是另一波反弹。W底形态两次…...
java语言与算法、数据结构的用法
Java语言是一种广泛使用的计算机编程语言，也是开发各种软件和操作系统的重要工具之一。除了具有高效性和可移植性之外，Java语言还具有丰富的算法和数据结构支持，可以帮助程序员轻松地解决各种问题。 算法和数据结构是计算机科学中的两个基本…...
中国社科院与美国杜兰大学金融管理硕士项目，引领你走在金融行业前沿
作为金融领域从业人员时刻都在关注行业最新资讯，只有掌握一手的前沿讯息，才能在职场上无往不胜。针对在职的你，如何利用业余时间让自己更增值呢，中国社科院与美国杜兰大学金融管理硕士项目引领你走在金融行业前沿。 金融管理硕士…...
第三十五章 Unity人形动画（下）
本章内容主要就是动画数据的独立文件使用方式。有了独立的动画文件，我们就可以将其应用到其他模型上面了。最简单的方式就是，我们可以给其他模型编辑动画控制器的时候，使用这些动画文件。Unity则给我们提供了更加高级的共享方式，就…...
vue导入导出excel、设置单元格背景色、文字居中、合并单元格、设置列宽（使用xlsx库和xlsx-style库）
xlsx xlsx是由SheetJS开发的一个处理excel文件的npm库 适用于前端开发者实现导入导出excel文件的经典需求 为了区别于xlsx文件，突出其应用语言，该库通常又被称为js-xlsx 导出js数据为Excel文件 需要以下步骤： 安装 xlsx 库 你可以使用 …...
未来机器人的大脑：如何用神经网络模拟器实现更智能的决策？
编辑：陈萍萍的公主一点人工一点智能 未来机器人的大脑：如何用神经网络模拟器实现更智能的决策？RWM通过双自回归机制有效解决了复合误差、部分可观测性和随机动力学等关键挑战，在不依赖领域特定归纳偏见的条件下实现了卓越的预测准…...
19c补丁后oracle属主变化，导致不能识别磁盘组
补丁后服务器重启，数据库再次无法启动 ORA01017: invalid username/password; logon denied Oracle 19c 在打上 19.23 或以上补丁版本后，存在与用户组权限相关的问题。具体表现为，Oracle 实例的运行用户（oracle）和集…...
【项目实战】通过多模态+LangGraph实现PPT生成助手
PPT自动生成系统 基于LangGraph的PPT自动生成系统，可以将Markdown文档自动转换为PPT演示文稿。 功能特点 Markdown解析：自动解析Markdown文档结构PPT模板分析：分析PPT模板的布局和风格智能布局决策：匹配内容与合适的PPT布局自动…...
大模型多显卡多服务器并行计算方法与实践指南
一、分布式训练概述 大规模语言模型的训练通常需要分布式计算技术，以解决单机资源不足的问题。分布式训练主要分为两种模式： 数据并行：将数据分片到不同设备，每个设备拥有完整的模型副本 模型并行：将模型分割到不同设备，每个设备处理部分模型计算 现代大模型训练通常结合…...
Java入门学习详细版（一）
大家好，Java 学习是一个系统学习的过程，核心原则就是“理论 实践 坚持”，并且需循序渐进，不可过于着急，本篇文章推出的这份详细入门学习资料将带大家从零基础开始，逐步掌握 Java 的核心概念和编程技能。 …...
[Java恶补day16] 238.除自身以外数组的乘积
给你一个整数数组 nums，返回 数组 answer ，其中 answer[i] 等于 nums 中除 nums[i] 之外其余各元素的乘积 。 题目数据 保证 数组 nums之中任意元素的全部前缀元素和后缀的乘积都在 32 位 整数范围内。 请 不要使用除法，且在 O(n) 时间复杂度…...
Spring AI与Spring Modulith核心技术解析
Spring AI核心架构解析 Spring AI（https://spring.io/projects/spring-ai）作为Spring生态中的AI集成框架，其核心设计理念是通过模块化架构降低AI应用的开发复杂度。与Python生态中的LangChain/LlamaIndex等工具类似，但特别为多语…...
3-11单元格区域边界定位(End属性)学习笔记
返回一个Range 对象，只读。该对象代表包含源区域的区域上端下端左端右端的最后一个单元格。等同于按键 End 向上键(End(xlUp))、End向下键(End(xlDown))、End向左键(End(xlToLeft)End向右键(End(xlToRight)) 注意：它移动的位置必须是相连的有内容的单元格…...
ABAP设计模式之---“简单设计原则(Simple Design)”
“Simple Design”（简单设计）是软件开发中的一个重要理念，倡导以最简单的方式实现软件功能，以确保代码清晰易懂、易维护，并在项目需求变化时能够快速适应。 其核心目标是避免复杂和过度设计，遵循“让事情保…...
JavaScript基础-API 和 Web API
在学习JavaScript的过程中，理解API（应用程序接口）和Web API的概念及其应用是非常重要的。这些工具极大地扩展了JavaScript的功能，使得开发者能够创建出功能丰富、交互性强的Web应用程序。本文将深入探讨JavaScript中的API与Web AP…...