PHP8 on Leanku 的博客

PHP 8 新特性之枚举

Sun, 11 Jun 2023 13:46:01 +0800

PHP 8 新特性之枚举

枚举概览

枚举，或称 “Enum”，能够让开发者自定义类型为一系列可能的离散值中的一个。在定义领域模型中很有用，它能够“隔离无效状态”（making invalid states unrepresentable）。

枚举以各种不同功能的形式出现在诸多语言中。在 PHP 中，枚举是一种特殊类型的对象。Enum 本身是一个类（Class），它的各种条目（case）是这个类的单例对象，意味着也是个有效对象 —— 包括类型的检测，能用对象的地方，也可以用它。

最常见的枚举例子是内置的 boolean 类型，该枚举类型有两个有效值 true 和 false。 Enum 使开发者能够任意定义出用户自己的、足够健壮的枚举。

Enum 类似 class，它和 class、interface、trait 共享同样的命名空间。也能用同样的方式自动加载。一个 Enum 定义了一种新的类型，它有固定、数量有限、可能的合法值。示例 #1 用注解实现接口的可选方法

1<?php
2
3// 通过传入参数：待搜索的注解类名，可返回指定的注解类， 而不需要再到反射类中迭代循环获取所有注解。

示例

 1<?php
 2
 3<?php
 4// 声明新的枚举类型 Suit，仅有四个有效的值： Suit::Hearts、Suit::Diamonds、 Suit::Clubs、Suit::Spades。
 5enum Suit
 6{
 7 case Hearts;
 8 case Diamonds;
 9 case Clubs;
10 case Spades;
11}
12
13// 变量可以赋值为以上有效值里的其中一个。 函数可以检测枚举类型，这种情况下只能传入类型的值。
14function pick_a_card(Suit $suit)
15{
16 /* ... */
17}
18
19$val = Suit::Diamonds;
20
21// OK
22pick_a_card($val);
23
24// OK
25pick_a_card(Suit::Clubs);
26?>

所有的case都有一个只读的属性 name，它大小写敏感，是case自身的名称

PHP 8 新特性之注解

Sun, 11 Jun 2023 13:46:01 +0800

PHP 8 新特性之注解功能

注解概览

注解功能提供了代码中的声明部分都可以添加结构化、机器可读的元数据的能力，注解的目标可以是类、方法、函数、参数、属性、类常量。通过反射 API 可在运行时获取注解所定义的元数据。因此注解可以成为直接嵌入代码的配置式语言。

通过注解的使用，在应用中实现功能、使用功能可以相互解耦。某种程度上讲，它可以和接口（interface）与其实现（implementation）相比较。但接口与实现是代码相关的，注解则与声明额外信息和配置相关。接口可以通过类来实现，而注解也可以声明到方法、函数、参数、属性、类常量中。因此它们比接口更灵活。

注解使用的一个简单例子：将接口（interface）的可选方法改用注解实现。我们假设接口 ActionHandler 代表了应用的一个操作：部分 action handler 的实现需要 setup，部分不需要。我们可以使用注解，而不用要求所有类必须实现 ActionHandler 接口并实现 setUp() 方法。因此带来一个好处——可以多次使用注解。

示例 #1 用注解实现接口的可选方法

 1<?php
 2interface ActionHandler
 3{
 4 public function execute();
 5}
 6
 7#[Attribute]
 8class SetUp {}
 9
10class CopyFile implements ActionHandler
11{
12 public string $fileName;
13 public string $targetDirectory;
14
15 #[SetUp]
16 public function fileExists()
17 {
18 if (!file_exists($this->fileName)) {
19 throw new RuntimeException("File does not exist");
20 }
21 }
22
23 #[SetUp]
24 public function targetDirectoryExists()
25 {
26 if (!file_exists($this->targetDirectory)) {
27 mkdir($this->targetDirectory);
28 } elseif (!is_dir($this->targetDirectory)) {
29 throw new RuntimeException("Target directory $this->targetDirectory is not a directory");
30 }
31 }
32
33 public function execute()
34 {
35 copy($this->fileName, $this->targetDirectory . '/' . basename($this->fileName));
36 }
37}
38
39function executeAction(ActionHandler $actionHandler)
40{
41 $reflection = new ReflectionObject($actionHandler);
42
43 foreach ($reflection->getMethods() as $method) {
44 $attributes = $method->getAttributes(SetUp::class);
45
46 if (count($attributes) > 0) {
47 $methodName = $method->getName();
48
49 $actionHandler->$methodName();
50 }
51 }
52
53 $actionHandler->execute();
54}
55
56$copyAction = new CopyFile();
57$copyAction->fileName = "/tmp/foo.jpg";
58$copyAction->targetDirectory = "/home/user";
59
60executeAction($copyAction);

注解语法

首先，注解声明总是以 #[ 开头，以 ] 结尾来包围。

PHP 8 新特性

Thu, 11 May 2023 13:46:01 +0800

PHP 8 新特性

命名参数（8.0）

新增命名参数的功能:

在函数或方法调用时，可通过参数名来指定参数的值，而不仅仅依赖参数的位置

从 PHP 8.0.0 开始，函数参数列表可以包含一个尾部的逗号，这个逗号将被忽略。这在参数列表较长或包含较长的变量名的情况下特别有用，这样可以方便地垂直列出参数。

 1<?php
 2function takes_many_args(
 3 $first_arg,
 4 $second_arg,
 5 $again = 'a default string', // 在 8.0.0 之前，这个尾部的逗号是不允许的。
 6){
 7 // ...
 8}
 9z
10takes_many_args(1, 2); //按照参数顺序传参
11takes_many_args(first_arg:1, second_arg:2); //指定参数，不分顺序
12
13// 类也可以使用命名参数，假设Demo类构造函数有$first_arg，$second_arg,两个参数，有takes_many_args方法
14$demo = new Demo(first_arg:1, second_arg:2); 
15$demo->takes_many_args(first_arg:1, second_arg:2);
16
17// 不能用位置的参数和命名的参数一起
18// 可选参数必须在必选参数后面 例如上面的$again
19?>

注解（Attributes）（8.0）

新增注解的功能。此篇单独介绍

构造器属性提升（Constructor Property Promotion）（8.0）

新增构造器属性提升功能在构造函数中声明类的属性）。

构造器的参数也可以相应提升为类的属性。构造器的参数赋值给类属性的行为很普遍，否则无法操作。而构造器提升的功能则为这种场景提供了便利。

 1<?php
 2class Point {
 3 protected int $x;
 4 protected int $y;
 5
 6 public function __construct(int $x, int $y = 0) {
 7 $this->x = $x;
 8 $this->y = $y;
 9 }
10}
11
12// 两个参数都传入
13$p1 = new Point(4, 5);
14// 仅传入必填的参数。 $y 会默认取值 0。
15$p2 = new Point(4);
16// 使用命名参数（PHP 8.0 起）:
17$p3 = new Point(y: 5, x: 4);
18
19// 上面的例子可以用以下方式重写：
20class Point {
21 public function __construct(protected int $x, protected int $y = 0) {
22 }
23}

联合类型（8.0）

新增联合类型。

PHP8新特性之match表达式

Tue, 14 Mar 2023 20:46:01 +0800

PHP8 alpha2发布了，最近引入了一个新的关键字：match, 这个关键字的作用跟switch有点类似。

虽然我一般对语法糖无感，但这个我觉得还是有点意思，match这个词也挺好看，那么它是干啥的呢？

在以前我们可能会经常使用switch做值转换类的工作，类似:

 1 switch ($input) {
 2     case "true":
 3         $result = 1;
 4     break;
 5     case "false":
 6         $result = 0;
 7     break;
 8     case "null":
 9         $result = NULL;
10     break;
11 }

(当然，有的同学会说，谁会这么写，用个数组转换不行么？拜托，这是举例啊，数组也只能数字键和整数啊，万一key是需要其他表达式呢，万一你要多个key对应一个值呢，对吧？)

那么如果使用match关键字呢，可以变成类似:

1$result = match($input) {
2         "true" => 1,
3         "false" => 0,
4         "null" => NULL,
5};

相比switch， match会直接返回值，可以直接赋值给$result了。

并且，类似switch的多个case一个block一样，match的多个条件也可以写在一起，比如:

1 $result = match($input) {
2     "true", "on" => 1,
3     "false", "off" => 0,
4     "null", "empty", "NaN" => NULL,
5};

需要注意的和switch不太一样的是，以前我们用switch可能会经常遇到这种诡异的问题:

1 $input = "2 person";
2 switch ($input) {
3     case 2:
4         echo "bad";
5     break;
6}

你会发现，bad竟然被输出了，这是因为switch使用了宽松比较(==)。match就不会有这个问题了, 它使用的是严格比较(===)，就是值和类型都要完全相等。

还有就是，当input并不能被match中的所有条件满足的时候，match会抛出一个UnhandledMatchError exception:

1 $input = "false";
2 $result = match($input) {
3         "true" => 1,
4 };

会得到:

Fatal error: Uncaught UnhandledMatchError: Unhandled match value of type string

这样就不用担心万一match条件没写全导致了不可预知的错误。

另外还是要说明，match是关键字，也就是从PHP8开始它不能出现在namespace或者类名中，如果你的项目中有用match作为类名的: