<?php

declare(strict_types=1);

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

echo '<pre>';

/******************* RFC 3986 解析示例 *******************/
// 方式一 : 直接使用構造函數(shù)（異常式）
$urlString = "https://user:pass@example.com:8080/path?query=1#fragment";
try{
    $uri = new Uri($urlString);
    // getScheme(): ?string 獲取協(xié)議方案,未提供則返回 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();
}

// 方式二 ： 靜態(tài)解析方法  傳入的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 ';
//>> 傳統(tǒng)嵌套寫法
$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 '靜態(tài)方法調用' . $data;
    }

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

$data = 'MyClass';
//>> 靜態(tài)方法調用
$result = $data |> Example::staticProcess(...);
print_r($result); // 靜態(tài)方法調用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

// 需要顯式括號改變優(yōu)先級
$result = 6 |> (someFunc(7) ?? someFunc(...));
// 觸發(fā)錯誤：PHP 的管道運算符 |> 要求右側必須是一個可調用對象（callable）。即使這個可調用對象執(zhí)行后可能返回 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 及更早版本（繁瑣實現(xiàn)）
    /* 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');

//>> 兼容舊版本的傳統(tǒng)寫法（完全保留，無BC break）
$cloneExample1 = clone $example;
$cloneExample2 = clone($example); // 并不是函數(shù)調用，而是 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, []); // 函數(shù)式調用 空屬性數(shù)組，等價于純克隆
$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); // 只調用不賦值 無返回值 觸發(fā)警示
// 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);

/*************** 靜態(tài)閉包在常量表達式中的應用 ************************/
// 1. 類常量中的靜態(tài)閉包
class Validator {
    public const DEFAULT_STRING_VALIDATOR = static function(string $value): bool {
        return strlen(trim($value)) > 0;
    };
}

// 2. 函數(shù)參數(shù)默認值
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. 屬性參數(shù)(注解)
#[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. 類常量中的靜態(tài)方法FCC
class StringUtils {
    public static function capitalize(string $str): string {
        return ucfirst(strtolower($str));
    }
    
    public const CAPITALIZE = self::capitalize(...);
}

// 3. 屬性參數(shù)中的FCC
#[Attribute]
class Transform {
    public function __construct(public Closure $callback) {}
}

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

// 4. 參數(shù)默認值中的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 必須是非空數(shù)組，元素為 CURL_LOCK_DATA_* 常量
 * 禁止包含 CURL_LOCK_DATA_COOKIE（會拋出 ValueError），防止用戶間敏感信息泄露
 *無效常量或非整數(shù)值會拋出 ValueError 或 TypeError
 * 
 * 支持的共享數(shù)據(jù)類型：
 * CURL_LOCK_DATA_DNS    DNS 解析緩存    安全（無用戶敏感信息）
 * CURL_LOCK_DATA_CONNECT    連接池與 SSL 會話    安全（連接級數(shù)據(jù)，無用戶標識）
 * CURL_LOCK_DATA_SSL_SESSION    SSL 會話緩存    安全
 * CURL_LOCK_DATA_PSL    公共后綴列表緩存    安全
 * CURL_LOCK_DATA_COOKIE    Cookie 數(shù)據(jù)    禁止（用戶敏感信息）
 * 
 */
// 創(chuàng)建或復用持久化共享句柄（共享DNS和連接）
$sh = curl_share_init_persistent([
    CURL_LOCK_DATA_DNS,
    CURL_LOCK_DATA_CONNECT
]);
// 初始化cURL句柄并關聯(lián)共享句柄
$ch = curl_init('https://example.com/api/data');
curl_setopt($ch, CURLOPT_SHARE, $sh);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// 執(zhí)行請求（第二次請求會復用連接和DNS緩存）
$response = curl_exec($ch);
echo '<pre>';
var_dump($response); // 返回的接口數(shù)據(jù) 字符串

<?php

declare(strict_types=1);

/**
 * 語法：$array    array    必需。要操作的輸入數(shù)組
 * function array_first(array $array): mixed;  // PHP 8.5+
 * function array_last(array $array): mixed;   // PHP 8.5+ 
 * 
 * 返回值: 
 * 如果數(shù)組非空，返回數(shù)組的第一個 / 最后一個元素值
 * 如果數(shù)組為空，返回null
 * 如果返回的元素是引用類型，會自動解引用，不會返回引用本身
 */
//>> 索引數(shù)組
$fruits = ["apple", "banana", "cherry"];
echo '<pre>';
var_dump(array_first($fruits)); // 輸出: apple
var_dump(array_last($fruits));  // 輸出: cherry

//>> 非連續(xù)索引數(shù)組
$numbers = [1 => "one", 3 => "three", 5 => "five"];
var_dump(array_first($numbers)); // 輸出: one (按數(shù)組內部順序，不是鍵名排序)
var_dump(array_last($numbers));  // 輸出: five

// 關聯(lián)數(shù)組
$config = [
    "host" => "localhost",
    "port" => 3306,
    "dbname" => "test"
];

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

//>> 空數(shù)組處理
$empty = [];
var_dump(array_first($empty));  // 輸出: NULL
var_dump(array_last($empty));   // 輸出: NULL

//>> 包含引用的數(shù)組
$str = "hello";
$array = [&$str, "world"];
var_dump(array_first($array));  // 輸出: string(5) "hello" (已解引用)
var_dump(array_last($array));   // 輸出: string(5) "world"