浅谈PHP 8.5 核心特性

<?php

declare(strict_types=1);

use Uri\InvalidUriException;
use Uri\Rfc3986\Uri;
use Uri\WhatWg\Url;

echo '<pre>';

/******************* RFC 3986 解析示例 *******************/
// 方式一 : 直接使用构造函数（异常式）
$urlString = "https://user:pass@example.com:8080/path?query=1#fragment";
try{
    $uri = new Uri($urlString);
    // getScheme(): ?string 获取协议方案,未提供则返回 null
    var_dump($uri->getScheme()); // https
    // getUser(): ?string 获取用户信息部分的用户名,未提供则返回 null
    var_dump($uri->getUserInfo()); // user:pass
    // getHost(): ?string 获取主机名,未提供则返回 null
    var_dump($uri->getHost()); // example.com
    // getPort(): ?int 获取端口号,未提供则返回 null
    var_dump($uri->getPort()); // 8080
    // getPath(): ?string 获取路径,未提供则返回 null
    var_dump($uri->getPath()); // path
    // getQuery(): ?string 获取查询字符串,未提供则返回 null
    var_dump($uri->getQuery()); // query=1
    // getFragment(): ?string 获取锚点,未提供则返回 null
    var_dump($uri->getFragment()); // fragment
    // 转换为字符串
    var_dump($uri->toString()); // https://user:pass@example.com:8080/path?query=1#fragment
}catch(InvalidUriException $e){
    // URI 无效时抛出异常，可通过 $e->getMessage() 获取错误信息
    echo '解析失败：' . $e->getMessage();
}

// 方式二 ： 静态解析方法  传入的URI字符串无效时，它返回 null
$staticUri = Uri::parse($urlString);
var_dump($staticUri->getScheme()); // https

/******************* WHATWG URL 解析示例 *******************/
try {
    $whatWgUrl = new Url($urlString);
    var_dump($whatWgUrl->getScheme()); // https
} catch (InvalidUriException $e) {
    // URI 无效时抛出异常，可通过 $e->getMessage() 获取错误信息
    echo '解析失败：' . $e->getMessage();
}

<?php

declare(strict_types=1);

$title = ' PHP 8.5 Released ';
//>> 传统嵌套写法
$slug = strtolower(str_replace('.', '', str_replace(' ', '-', trim($title))));
echo '<pre>';
print_r($slug); // php-85-released

//>> 管道操作符写法
$slugRe = $title
    |> trim(...) // 去除首尾空格
    |> (fn($str) => str_replace(' ','-', $str)) // 空格转连字符
    |> (fn($str) => str_replace('.', '', $str)) // 移除点号
    |> strtolower(...); // 转为小写
echo '<br/>';
print_r($slugRe); // php-85-released

<?php

declare(strict_types=1);

class Example {

    public static function staticProcess(mixed $data) : string 
    {
        return '静态方法调用' . $data;
    }

    public function process(mixed $data):string 
    {
        return '实例方法调用' . $data;
    }
}

$data = 'MyClass';
//>> 静态方法调用
$result = $data |> Example::staticProcess(...);
print_r($result); // 静态方法调用MyClass

//>> 实例方法调用
$myClass = new Example();
$result = $data |> $myClass->process(...);
echo '<br/>';
print_r($result); // 实例方法调用MyClass

//>> 闭包调用（必须加括号）
$number = 2;
$result = $number |> (fn($x) => $x * 2) |> (fn($x) => $x + 1);
echo '<br/>';
print_r($result); // 5


function someFunc( int $params){
    return $params !== 7 ? $params * 2 : null;
}

// 等价于 (5 + 3) |> someFunc(...)
$result = 5 + 3 |> someFunc(...);
echo '<br/>';
print_r($result); // 16

// 等价于 ('beep' |> strlen(...)) == 4
$result = 'beep' |> strlen(...) == 4;
echo '<br/>';
print_r($result); // 1(true)

// 等价于 ((5 + 2) |> get_username(...)) ?? 'default'
$result = 5 + 2 |> someFunc(...) ?? 'default';
echo '<br/>';
print_r($result); // default

// 需要显式括号改变优先级
$result = 6 |> (someFunc(7) ?? someFunc(...));
// 触发错误：PHP 的管道运算符 |> 要求右侧必须是一个可调用对象（callable）。即使这个可调用对象执行后可能返回 null，但右侧本身不能是 null
// $result = 6 |> someFunc(7) ?? someFunc(...); // Fatal error: Uncaught Error: Value of type null is not callable in
echo '<br/>';
print_r($result); // 12

<?php

declare(strict_types=1);

readonly class Example {
    public function __construct(
        public string $user
    ){}
    
    // PHP 8.4 及更早版本（繁琐实现）
    /* public function withUser(string $user): self {
        $values = get_object_vars($this);
        $values['user'] = $user;
        return new self(...$values); // 需重新构造整个对象
    } */

    // 类内合法：可修改所有属性，包括private/protected/readonly
    public function withUser(string $user): self {
        return clone($this, ['user' => $user]);
    }

}

$example = new Example('user1');

//>> 兼容旧版本的传统写法（完全保留，无BC break）
$cloneExample1 = clone $example;
$cloneExample2 = clone($example); // 并不是函数调用，而是 clone 语法允许括号包裹被克隆的对象
$cloneExample3 = \clone($example); // 全局命名空间限定写法
echo '<pre>';
var_dump($cloneExample1->user); // user1
var_dump($cloneExample2->user); // user1
var_dump($cloneExample3->user); // user1

//>> 新增Clone With核心写法
$newExample1 = clone($example, []); // 函数式调用 空属性数组，等价于纯克隆
$newExample2 = $example->withUser('user2'); // Clone With 修改任何readonly属性
//  readonly 类中的所有属性都是只读的，任何外部赋值（包括克隆后的新对象）都会抛出 Error。属性设置为 public(set) string $user则正常
//$newExample3 = clone($example, ['user' => 'user3']);
var_dump($newExample1->user); // user1
var_dump($newExample2->user); // user2
//var_dump($newExample3->user); // 属性设置为 public(set) string $user 结果为 user3

<?php

declare(strict_types=1);

 #[\NoDiscard]
// #[\NoDiscard('自定义提示消息')] // 自定义提示信息
function validateEmail(string $email): bool {
    return filter_var($email, FILTER_VALIDATE_EMAIL) !== false;
}

$emailStr = 'xxxx@gmail.com';
// 警告信息： Warning: The return value of function validateEmail() should either be used or intentionally ignored by casting it as (void) in
// 警告信息： Warning: The return value of function validateEmail() should either be used or intentionally ignored by casting it as (void), 自定义提示消息 in
// validateEmail($emailStr); // 只调用不赋值 无返回值 触发警示
// PHP 8.5 引入(void)强制转换，用于明确表示故意忽略返回值，抑制警告
(void) validateEmail($emailStr); // 无警告

// 哪些算返回值？
/** 1.赋值给变量（即使是未使用的变量） */
$re = validateEmail($emailStr); // 无警告
$_ = validateEmail($emailStr); // 无警告（常用哑变量表示显式接收） 由于 (void) 强制转换是在 PHP 8.5 中新增的，如果你的代码需要兼容 PHP 8.4 及以下版本，可以使用临时变量来替代：

/** 2.作为表达式一部分 */
if (validateEmail($emailStr)) { /* ... */ } // 无警告
print_r(validateEmail($emailStr) ? 'Valid' : 'Invalid'); // 无警告 Valid

/** 3.进行类型转换 */
(bool) validateEmail($emailStr); // 无警告

<?php

declare(strict_types=1);

/*************** 静态闭包在常量表达式中的应用 ************************/
// 1. 类常量中的静态闭包
class Validator {
    public const DEFAULT_STRING_VALIDATOR = static function(string $value): bool {
        return strlen(trim($value)) > 0;
    };
}

// 2. 函数参数默认值
function processData(mixed $data, Closure $transformer = static function(mixed $input): mixed {
    return is_string($input) ? trim($input) : $input;
}): mixed {
    return $transformer($data);
}

// 3. 属性默认值
class User {
    private Closure $nameFormatter = static function(string $name): string {
        return ucwords(strtolower($name));
    };
    
    public function formatName(string $name): string {
        return ($this->nameFormatter)($name);
    }
}

// 4. 属性参数(注解)
#[Attribute]
class Sanitize {
    public function __construct(public Closure $callback) {}
}

class Article {
    #[Sanitize(static function(string $content): string {
        return strip_tags($content);
    })]
    public string $content;
}

/*************** First-class 可调用对象 (FCC) 的常量表达式支持 ************************/
// 1. 常量中的FCC
const STRLEN_CALLABLE = strlen(...);
const ARRAY_FILTER_CALLABLE = array_filter(...);

// 2. 类常量中的静态方法FCC
class StringUtils {
    public static function capitalize(string $str): string {
        return ucfirst(strtolower($str));
    }
    
    public const CAPITALIZE = self::capitalize(...);
}

// 3. 属性参数中的FCC
#[Attribute]
class Transform {
    public function __construct(public Closure $callback) {}
}

class Product {
    #[Transform(strtoupper(...))]
    public string $name;
    
    #[Transform(StringUtils::capitalize(...))]
    public string $description;
}

// 4. 参数默认值中的FCC
function mapArray(array $array, Closure $mapper = strval(...)): array {
    return array_map($mapper, $array);
}

<?php

declare(strict_types=1);

/**
 * 语法：curl_share_init_persistent(array $share_options): CurlSharePersistentHandle
 * $share_options 必须是非空数组，元素为 CURL_LOCK_DATA_* 常量
 * 禁止包含 CURL_LOCK_DATA_COOKIE（会抛出 ValueError），防止用户间敏感信息泄露
 *无效常量或非整数值会抛出 ValueError 或 TypeError
 * 
 * 支持的共享数据类型：
 * CURL_LOCK_DATA_DNS    DNS 解析缓存    安全（无用户敏感信息）
 * CURL_LOCK_DATA_CONNECT    连接池与 SSL 会话    安全（连接级数据，无用户标识）
 * CURL_LOCK_DATA_SSL_SESSION    SSL 会话缓存    安全
 * CURL_LOCK_DATA_PSL    公共后缀列表缓存    安全
 * CURL_LOCK_DATA_COOKIE    Cookie 数据    禁止（用户敏感信息）
 * 
 */
// 创建或复用持久化共享句柄（共享DNS和连接）
$sh = curl_share_init_persistent([
    CURL_LOCK_DATA_DNS,
    CURL_LOCK_DATA_CONNECT
]);
// 初始化cURL句柄并关联共享句柄
$ch = curl_init('https://example.com/api/data');
curl_setopt($ch, CURLOPT_SHARE, $sh);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// 执行请求（第二次请求会复用连接和DNS缓存）
$response = curl_exec($ch);
echo '<pre>';
var_dump($response); // 返回的接口数据 字符串

<?php

declare(strict_types=1);

/**
 * 语法：$array    array    必需。要操作的输入数组
 * function array_first(array $array): mixed;  // PHP 8.5+
 * function array_last(array $array): mixed;   // PHP 8.5+ 
 * 
 * 返回值: 
 * 如果数组非空，返回数组的第一个 / 最后一个元素值
 * 如果数组为空，返回null
 * 如果返回的元素是引用类型，会自动解引用，不会返回引用本身
 */
//>> 索引数组
$fruits = ["apple", "banana", "cherry"];
echo '<pre>';
var_dump(array_first($fruits)); // 输出: apple
var_dump(array_last($fruits));  // 输出: cherry

//>> 非连续索引数组
$numbers = [1 => "one", 3 => "three", 5 => "five"];
var_dump(array_first($numbers)); // 输出: one (按数组内部顺序，不是键名排序)
var_dump(array_last($numbers));  // 输出: five

// 关联数组
$config = [
    "host" => "localhost",
    "port" => 3306,
    "dbname" => "test"
];

var_dump(array_first($config)); // 输出: localhost
var_dump(array_last($config));  // 输出: test

//>> 空数组处理
$empty = [];
var_dump(array_first($empty));  // 输出: NULL
var_dump(array_last($empty));   // 输出: NULL

//>> 包含引用的数组
$str = "hello";
$array = [&$str, "world"];
var_dump(array_first($array));  // 输出: string(5) "hello" (已解引用)
var_dump(array_last($array));   // 输出: string(5) "world"