jdwx/param

一个简单的PHP模块,用于从字符串中解析值,具有类型安全。

v1.1.13 2024-09-14 21:41 UTC

This package is auto-updated.

Last update: 2024-09-15 16:04:07 UTC


README

一个简单的PHP模块,用于从字符串中解析值,具有类型安全。

这在许多情况下都很有用

  • 解析HTTP请求参数。
  • 解析作为字符串或NULL返回的数据库值。
  • 解析配置文件中的值。
  • 解析命令行参数中的值。

安装

您可以直接使用Composer要求它

composer require jdwx/param

或者从GitHub下载源代码: https://github.com/jdwx/param.git

要求

此库需要PHP 8.1或更高版本。它不与早期版本兼容。(使用只读属性。)它需要mbstring扩展,并使用Ds数据结构扩展或polyfill,但没有其他外部依赖。

用法

<?php

declare( strict_types = 1 );

require 'vendor/autoload.php';

use JDWX\Param\Parameter;

$st = readline( "Enter an integer: " );
if ( $st === false ) {
    echo "No input\n";
    exit( 1 );
}

try {
    $p = new Parameter( $st );
    $i = $p->asInt();
    echo "You entered: {$i}\n";
} catch ( TypeError $e ) {
    echo "ERROR: ", $e->getMessage(), "\n";
}

稳定性

此库是稳定的,已在生产代码中使用。它不会以破坏现有代码的方式改变。未来可能会添加额外的解析方法,但现有方法不应以破坏现有代码的方式改变,除非至少进行一次小版本更新。

历史

此库已在生产代码中使用多年。它最初是更大库的一部分,在2023年被拆分为更小的部分,并在2024年作为独立库发布。