# PHP 现代特性 ## 简介现代 PHP（7.4+、8.0+、8.1+、8.2+）已经发生了巨大的发展，其功能可提高类型安全性、表现力和开发人员体验。这些新增功能将 PHP 从一种松散类型的脚本语言转变为一个强大的、类型安全的平台，用于构建健壮的应用程序。主要改进包括严格类型、属性和参数类型、并集和交集类型、匹配表达式、命名参数、属性（注释）、枚举和只读属性。这些功能可实现更清晰的意图、更好的 IDE 支持和更少的运行时错误。该技能涵盖类型化属性、并集/交集类型、匹配表达式、枚举、属性、命名参数以及有效利用现代 PHP 的模式。 ## 类型属性和参数类型声明通过在运行时强制执行类型并实现更好的静态分析来提高代码可靠性。 name = "爱丽丝"; // 好的 $用户->年龄 = 30; // 好的 // $user->age = "三十"; // 类型错误 // 构造函数属性提升 (PHP 8.0+) 产品类{ 公共函数 __construct( 公共字符串 $name, 公众持股量$价格，公共 int $股票，私有？字符串 $sku = null ）{} } $product = new Product("笔记本电脑", 999.99, 10); 回显$产品->名称； //“笔记本电脑” // 回显 $product->sku; // 错误：私有财产 // 返回类型声明函数calculateTotal(float $price, int $quantity): float { 返回$价格*$数量； } 函数 findUser(int $id): ?User { // 返回用户或 null 返回 $id > 0 ？新用户（）：空； } 函数 getUsers(): 数组 { 返回[新用户（），新用户（）]； } // 空返回类型函数 logMessage(字符串 $message): void { 回显$消息。 “\n”； } // 从不返回类型 (PHP 8.1+) 函数失败（字符串$message）：从不{ 抛出新的异常（$消息）； } // 混合类型 (PHP 8.0+) 函数过程（混合$值）：混合{ 返回$值； } // 静态返回类型类生成器{ 公共函数 setName(string $name): static { 返回$这个； } 公共函数构建（）：静态{ 返回新的静态（）； } } // 参数类型函数问候（字符串 $name, 整数$年龄，布尔 $formal = false ): 字符串 { $问候=$正式？ “美好的一天”：“你好”； return "$greeting, $name ($age)"; } // 可变类型参数函数 sum(int ...$numbers): int { 返回 array_sum($numbers); } $总计 = 总和(1, 2, 3, 4, 5); // 15 类型化属性和参数尽早捕获类型错误，并为函数接口提供清晰的契约。 ## 并集和交集类型联合类型允许多种类型的可能性，而交集类型则需要同时指定所有类型。 0 ？新产品（“项目”，10.0，5）：空； } // 多种联合类型函数格式(int|float|string $value): string { 返回匹配（真）{ is_int($value) => "整数：$value", is_float($value) => "浮动: $value", is_string($value) => "字符串：$value", }; } // 联合中的错误伪类型函数parseValue（字符串$输入）：int | false { $结果 = filter_var($input, FILTER_VALIDATE_INT); 返回 $结果 !== false ? $结果：假； } // 具有内置类型的联合类型函数 getData(): 数组|对象|null { 返回['键'=>'值']; } // 交叉点类型 (PHP 8.1+) 接口可记录{ 公共函数 log(): void; } 接口可缓存{ 公共函数缓存（）：无效； } // 接受交集类型的函数函数过程(Loggable&Cacheable $object): void { $对象->log(); $对象->缓存(); } 类 Service 实现 Loggable、Cacheable { 公共函数日志（）：无效{ echo "正在记录\n"; } 公共函数缓存（）：无效{ echo "缓存\n"; } } // 与并集的交集函数句柄((Loggable&Cacheable)|null $object): void { $object?->log(); } // DNF 类型（PHP 8.2+ - 析取范式）函数高级((Loggable&Cacheable)|(Loggable&Serialized) $object): void { $对象->log(); } 并集类型支持灵活的参数接受，而交集类型同时强制执行多种功能。 ## 匹配表达式匹配表达式提供具有严格比较和详尽检查的模式匹配，从而改进了 switch 语句。 “服务器错误”，默认=>“未知”， }; 回显$消息； //“好的” // 多个条件 $结果=匹配（$状态）{ 200, 201, 202 => “成功”, 400, 401, 403 => "客户端错误", 500, 502, 503 => "服务器错误", 默认=>“未知”， }; // 与表达式匹配 $年龄=25； $类别=匹配（真）{ $age < 13 => "儿童", $age < 18 => “青少年”， $年龄< 65 =>“成人”，默认=>“高级”， }; // 无默认匹配（不匹配则抛出异常）函数 getColor(string $type): string { 返回匹配（$类型）{ '主要' => '#007bff', '成功' => '#28a745', '危险' => '#dc3545', // 缺少默认值会抛出 UnhandledMatchError }; } // 与复杂表达式匹配枚举状态{ 案件草案；案例发布；案例已存档； } 函数 canEdit(状态 $status): bool { 返回匹配（$status）{ 状态::草稿 => true, 状态::已发布 => false, 状态::已存档 => false, }; } // 匹配返回不同类型函数过程（混合$值）：int | string { 返回匹配 (gettype($value)) { '整数' => $值 * 2, '字符串' => strtoupper($value), '数组' => 计数（$值），默认=> 0， }; } // Match 与 switch 严格比较 $值=“1”； // Switch 使用 == （松散）开关（$值）{ 案例1： echo "与开关匹配\n"; // 打印打破； } // 匹配使用===（严格） $结果=匹配（$值）{ 1 => “匹配匹配”, "1" => "严格匹配", // 这匹配默认=>“不匹配”， }; 回显$结果； //“严格匹配” 由于严格的比较和详尽的检查要求，匹配表达式比 switch 更安全。 ## 枚举枚举提供类型安全的可能值集，用显式类型替换魔术字符串和常量。名称。 “\n”； } updateOrder(状态::已批准); // 带值的支持枚举枚举优先级：int { 情况低=1；案例中= 2；情况高= 3；情况严重 = 4； } $priority = 优先级::高； echo $优先级->值； // 3 echo $优先级->名称； //“高” // 字符串支持的枚举枚举角色：字符串{ 案例管理员 = '管理员'; 案例用户 = '用户'; case Guest = '客人'; } // 枚举方法枚举 HttpStatus: int { 情况正常 = 200；创建案例 = 201；案例错误请求= 400；案例未经授权= 401；未找到案例 = 404；案例服务器错误 = 500; 公共函数 isSuccess(): bool { 返回 $this->value >= 200 && $this->value < 300; } 公共函数 isError(): bool { 返回$this->值>=400； } 公共函数消息（）：字符串{ 返回匹配 ($this) { self::OK => "请求成功", self::Created => "资源已创建", self::BadRequest => "无效请求", self::Unauthorized => “需要身份验证”, self::NotFound => "资源未找到", self::ServerError => "内部服务器错误", }; } } $status = HttpStatus::NotFound; 回声 $status->isError() ？ "错误：" : "成功："; 回声 $status->message(); // 具有静态方法的枚举枚举颜色：字符串{ 案例红色 = '#FF0000'; 案例绿色 = '#00FF00'; 案例蓝色 = '#0000FF'; 公共静态函数 fromRgb(int $r, int $g, int $b): string { 返回 sprintf('#%02X%02X%02X', $r, $g, $b); } 公共静态函数 random(): self { $cases = self::cases(); 返回$cases[array_rand($cases)]; } } // 枚举迭代 foreach (Priority::cases() as $priority) { 回显 $priority->name 。 ”：“。 $优先级->值。 “\n”； } // 从值枚举 $优先级=优先级::来自(2); // 优先级::中 $priority = Priority::tryFrom(10); // null（安全版本） // 匹配中的枚举函数 getPriorityColor(优先级 $priority): string { 返回匹配（$优先级）{ 优先级::低 => '绿色', 优先级::中 => '黄色', 优先级::高 => '橙色', 优先级::关键 => '红色', }; } 枚举用支持 IDE 自动完成和重构的类型安全替代方案替换了魔术字符串和常量。 ## 属性（注释）属性将元数据附加到声明，从而启用声明性配置和基于反射的框架。 []]; } #[路线('/users/{id}', 方法: ['GET'])] #[验证（规则：['id' => '必需|整数']）] 公共函数 show(int $id): 数组 { 返回 ['user' => ['id' => $id]]; } #[路线（'/用户'，方法：['POST']）] #[Validate(规则: ['姓名' => '必填', '电子邮件' => '必填|电子邮件'])] 公共函数存储（数组$数据）：数组{ 返回 ['用户' => $data]; } } // 通过反射读取属性函数 getRoutes(string $class): 数组 { $reflection = new ReflectionClass($class); $路线= []; foreach ($reflection->getMethods() as $method) { $attributes = $method->getAttributes(Route::class); foreach（$attributes 作为$attribute）{ $route = $attribute->newInstance(); $路线[] = [ '路径' => $route->路径, '方法' => $route->方法, 'handler' => [$class, $method->getName()], ]; } } 返回$路线； } $routes = getRoutes(UserController::class); // 多个属性 #[属性（属性::TARGET_METHOD）] 类缓存{ 公共函数 __construct( 公共整数 $ttl = 3600 ）{} } #[属性（属性::TARGET_METHOD）] 类速率限制{ 公共函数 __construct( 公共 int $maxRequests, 公共 int $perSeconds ）{} } 类 ApiController { #[路由('/api/data')] #[缓存(ttl: 300)] #[RateLimit(最大请求数: 100, 每秒: 60)] 公共函数 getData(): 数组 { 返回['数据'=> []]; } } // 类属性 #[属性（属性::TARGET_CLASS）] 类实体{ 公共函数 __construct( 公共字符串$表）{} } #[实体（表：'用户'）] 类用户实体{ 公共 int $id; 公共字符串$名称； } // 属性属性 #[属性（属性::TARGET_PROPERTY）] 类列{ 公共函数 __construct( 公共字符串 $name, 公共字符串 $type = '字符串' ）{} } 类帖子{ #[列(名称:'id',类型:'整数')] 公共 int $id; #[列(名称:'标题')] 公共字符串$标题； #[列（名称：'创建时间'，类型：'日期时间'）] 公共日期时间$createdAt; } 属性为依赖注入、路由、验证、ORM 映射和其他框架功能启用声明性元数据。 ## 命名参数和其他现代功能命名参数提高了可读性并使可选参数更可用。名称=$名称； $用户->年龄=$年龄； $用户->电子邮件=$电子邮件； $用户->活动= $活动；返回$用户； } // 传统调用 $user1 = createUser("Alice", 30, "alice@example.com", true); // 命名参数（任意顺序，跳过默认值） $user2 = createUser(姓名：“鲍勃”，年龄：25); $user3 = createUser(年龄: 28, 姓名: "查理", 活动: false); // 混合位置和命名 $user4 = createUser("Dave", 35, 活动: false); // 只读属性 (PHP 8.1+) 类配置{ 公共函数 __construct( 公共只读字符串 $apiKey, 公共只读字符串$endpoint ）{} } $config = new Config("key123", "https://api.example.com"); // $config->apiKey = "新"; // 错误：只读属性 // 只读类 (PHP 8.2+) 只读类点{ 公共函数 __construct( 公共整数$x，公共整数 $y ）{} } // 一流的可调用语法 (PHP 8.1+) $数组 = [1, 2, 3, 4, 5]; // 老方法 $doubled = array_map(fn($n) => $n * 2, $array); // 第一类可调用函数 double(int $n): int { 返回 $n * 2； } $doubled = array_map(double(...), $array); // 初始化器中的新增功能 (PHP 8.1+) 类服务{ 公共函数 __construct( 私有记录器 $logger = new Logger() ）{} } // Nullsafe 运算符 (PHP 8.0+) $country = $user?->getAddress()?->getCountry()?->getName(); // 抛出表达式 (PHP 8.0+) $值 = $输入 ?? throw new InvalidArgumentException('需要输入'); // str_contains、str_starts_with、str_ends_with (PHP 8.0+) $text = "你好，世界！"; if (str_contains($text, "世界")) { echo "包含世界\n"; } if (str_starts_with($text, "你好")) { echo "以你好开始\n"; } if (str_ends_with($text, "世界!")) { echo "世界结束！\n"; } 命名参数使函数调用自记录，并允许跳过参数列表中间的可选参数。 ## 最佳实践 1. **在文件开始处使用严格类型声明**以启用严格类型检查并尽早捕获类型错误 2. **利用所有类属性的类型化属性**来记录预期类型并启用验证 3. 对于基于值的调度，**优先选择匹配而不是切换**，以从严格比较和详尽性中受益 4. **用枚举替换魔术常量**以创建类型安全、自记录的允许值集 5. **对可选参数使用命名参数**以提高可读性并跳过不必要的默认值 6. **对不可变数据应用只读**以防止意外突变并表达不可变意图 7. **当函数接受多种类型而不是接受混合类型时，使用联合类型作为灵活的参数** 8. **利用元数据的属性**而不是基于反射的框架和工具的文档块 9. **使用构造函数属性提升**来减少具有许多简单属性的类中的样板文件 10. **应用 nullsafe 运算符** 对潜在 null 对象进行安全属性访问，无需显式 null 检查 ## 常见陷阱 1. **忘记声明(strict_types=1)**允许类型强制，从而违背类型声明的目的 2. **过度使用联合类型**和过多的替代方案会降低类型安全优势并使逻辑复杂化 3. **不处理匹配中的所有枚举案例**，如果添加新案例，没有默认值会导致运行时错误 4. **将枚举用于非穷举集**，例如编译时值未知的用户 ID 5. **错误地混合位置参数和命名参数**可能会导致错误；位置必须出现在命名之前 6. **在适当的时候不标记只读**允许破坏不变性假设的突变 7. **在不了解反射的情况下使用属性**会导致未使用的元数据没有效果 8. **过度使用混合类型**而不是特定的联合或泛型会降低类型安全优势 9. **不检查 enum::tryFrom() 返回值**会在提供无效值时导致崩溃 10. **对于总是抛出异常影响控制流分析的函数，**在不合适的情况下使用 void** ## 何时使用此技能在 PHP 7.4+ 或最好是 PHP 8.0+ 上构建应用程序时，使用现代 PHP 功能，以利用改进的类型安全性和开发人员体验。在设计类和函数时应用类型化属性和参数，以尽早捕获类型错误并改进 IDE 支持。在对状态、优先级或角色等固定值集进行建模时使用枚举，而不是使用字符串或整数常量。利用匹配表达式来实现基于值的更清晰的条件逻辑，尤其是对于枚举或类型化值。使用框架级元数据的属性，例如路由、验证、ORM 映射或依赖项注入配置。 ## 资源 * [PHP 8.0 发行说明]() * [PHP 8.1 发行说明]() * [PHP 8.2 发行说明]() * [PHP：正确的方法]() * [PHP 类型系统文档]()

PHP 现代特性

包含技能