首頁>PHP源碼>其他類別
下載

parameter

概括

parameter是一個圍繞parameter的函式庫，它提供了具有驗證規則和模式自省的附加功能。

安裝中

parameter可透過 Packagist 取得，儲存庫來源位於 chevere/ parameter 。 

composer require chevere/ parameter

它有什麼作用？

parameter可以使用額外的規則產生任何類型的動態parameter 。

例如，最小值為 10 的整數。

parameterint; $int = int(min: 10); $int($var); // exception if $var < 10">
 use function Chevere  parameter  int ;

$ int = int (min: 10 );
$ int ( $ var ); // exception if $var < 10

在函數或方法parameter中，您可以使用屬性來定義parameter和傳回值的驗證規則。

parameterAttributesFloatAttr; use Chevere parameter AttributesIntAttr; use Chevere parameter AttributesReturnAttr; use function Chevere parameter returnAttr; use function Chevere parameter validated; #[ReturnAttr( new FloatAttr(min: 0, max: 2400) )] function wageWeekWA( #[IntAttr(min: 1628)] int $cents, #[FloatAttr(min: 0, max: 40)] float $hours ) { return $cents*$hours/100; } validated('wageWeekWA', $cents, $hours);">
 use Chevere  parameter  Attributes  FloatAttr ;
use Chevere  parameter  Attributes  IntAttr ;
use Chevere  parameter  Attributes  ReturnAttr ;
use function Chevere  parameter  returnAttr ;
use function Chevere  parameter  validated ;

#[ReturnAttr(
    new FloatAttr (min: 0 , max: 2400 )
)]
function wageWeekWA (
    #[IntAttr(min: 1628 )]
    int $ cents ,
    #[FloatAttr(min: 0 , max: 40 )]
    float $ hours
) {
    return $ cents * $ hours / 100 ;
}
validated ( ' wageWeekWA ' , $ cents , $ hours );

可以使用validated （上面的範例）、內聯和/或委託給呼叫者包裝器來觸發驗證。 parameter提供了存取parameter和傳回值規則的幫助程序，以簡化接線過程。

每個parameter定義的規則提供了一個人類可讀的模式，允許公開驗證標準。

如何使用

parameter提供了一個API，可用來使用函數和/或屬性建立parameter 。 parameter物件可以直接在邏輯中使用，而屬性則需要讀取步驟。

內聯使用

使用內聯驗證從這裡開始： 

 if ( $ var > 10 || $ var < 1 ) {
    throw new InvalidArgumentException ();
}

對此：

parameterint; int(min: 1, max: 10)($var);">
 use function  Chevere  parameter  int ;

int (min: 1 , max: 10 )( $ var );

基於屬性的使用

使用屬性來定義parameter和傳回值的規則。

使用具有validated()函數的屬性委託驗證來實作： 

 function myFunction ( int $ var ): string
{
    if ( $ var > 10 || $ var < 1 ) {
        throw new InvalidArgumentException ();
    }
    $ return = ' done ok ' ;
    return preg_match ( ' /ok$/ ' , $ return )
        ? $ return
        : throw new InvalidArgumentException ();
}
$ result = myFunction ( $ var );

對此：

parameterAttributesIntAttr; use Chevere parameter AttributesReturnAttr; use Chevere parameter AttributesStringAttr; use function Chevere parameter validated; #[ReturnAttr( new StringAttr('/ok$/') )] function myFunction( #[IntAttr(min: 1, max: 10)] int $var ): string { return 'done ok'; } $result = validated('myFunction', $var);">
 use Chevere  parameter  Attributes  IntAttr ;
use Chevere  parameter  Attributes  ReturnAttr ;
use Chevere  parameter  Attributes  StringAttr ;
use function Chevere  parameter  validated ;

#[ReturnAttr(
    new StringAttr ( ' /ok$/ ' )
)]
function myFunction (
    #[IntAttr(min: 1 , max: 10 )]
    int $ var
): string
{
    return ' done ok ' ;
}
$ result = validated ( ' myFunction ' , $ var );

使用reflectionTo parameter s和reflectionToReturn函數手動驗證參數和傳回值：

parameter s; use function Chevere parameter reflectionToReturn; $reflection = new ReflectionFunction('myFunction'); $ parameter s = reflectionTo parameter s($reflection); $return = reflectionToReturn($reflection); $ parameter s(...$args); // valid $args $result = myFunction(...$args); // myFunction call $return($result); // valid $result">
 use ReflectionFunction ;
use function Chevere  parameter  reflectionTo parameter s ;
use function Chevere  parameter  reflectionToReturn ;

$ reflection = new ReflectionFunction ( ' myFunction ' );
$ parameter s = reflectionTo parameter s ( $ reflection );
$ return = reflectionToReturn ( $ reflection );
$ parameter s (... $ args ); // valid $args
$ result = myFunction (... $ args ); // myFunction call
$ return ( $ result ); // valid $result

使用屬性內聯驗證在函數體內進行手動驗證：

parameterAttributesIntAttr; use Chevere parameter AttributesReturnAttr; use Chevere parameter AttributesStringAttr; use function Chevere parameter valid; use function Chevere parameter returnAttr; #[ReturnAttr( new StringAttr('/ok$/') )] function myFunction( #[IntAttr(min: 1, max: 10)] int $var ): string { valid(); // valid $var $return = 'ok'; return returnAttr()($return); // valid $return }">
 use Chevere  parameter  Attributes  IntAttr ;
use Chevere  parameter  Attributes  ReturnAttr ;
use Chevere  parameter  Attributes  StringAttr ;
use function Chevere  parameter  valid ;
use function Chevere  parameter  returnAttr ;

#[ReturnAttr(
    new StringAttr ( ' /ok$/ ' )
)]
function myFunction (
    #[IntAttr(min: 1 , max: 10 )]
    int $ var
): string
{
    valid (); // valid $var
    $ return = ' ok ' ;

    return returnAttr ()( $ return ); // valid $return
}

可調用屬性

PHP 中的屬性僅支援可在類別常數上使用的表達式。無法使用屬性直接定義動態parameter 。

為了避免此限制，您可以使用CallableAttr屬性，該屬性可以將parameter解析轉送到傳回parameter Interface介面實例的可呼叫物件。

parameter Interface; use Chevere parameter AttributesCallableAttr; function myCallable(): parameter Interface { return arrayp( email: string(), )->withOptional( name: string(), ); } #[CallableAttr('myCallable')]">
 use Chevere  parameter  Interfaces  parameter Interface ;
use Chevere  parameter  Attributes  CallableAttr ;

function myCallable (): parameter Interface
{
    return arrayp (
        email: string (),
    )-> withOptional (
        name: string (),
    );
}

#[CallableAttr( ' myCallable ' )]

類型

parameter是實現parameter Interface物件。每個parameter都可以定義description和default值，以及取決於類型的附加驗證規則。

可以使用函數和/或屬性來定義parameter ，兩者採用相同的參數。

當呼叫parameter $param('value')時，它將觸發對傳遞的參數的驗證。

細繩

使用函數string建立一個String parameter 。傳遞一個regex進行字串比對。

parameterstring; // Any string $string = string(); // String matching bin-<digits> $string = string('/^bin-[d]+$/'); $string('bin-123');">
 use function Chevere  parameter  string ;

// Any string
$ string = string ();
// String matching bin-<digits>
$ string = string ( ' /^bin-[d]+$/ ' );
$ string ( ' bin-123 ' );

使用StringAttr屬性定義字串parameter 。

parameterAttributesStringAttr; #[StringAttr('/^bin-[d]+$/')]">
 use Chevere  parameter  Attributes  StringAttr ;

#[StringAttr( ' /^bin-[d]+$/ ' )]

字串偽parameter s

下面的parameter都是基於String的。

列舉字串

使用函數enum建立與字串清單相符的String parameter 。

parameterenum; $enum = enum('on', 'off'); $enum('on'); $enum('off');">
 use function Chevere  parameter  enum ;

$ enum = enum ( ' on ' , ' off ' );
$ enum ( ' on ' );
$ enum ( ' off ' );

使用EnumAttr屬性定義枚舉字串parameter 。

parameterAttributesEnumAttr; #[EnumAttr('on', 'off')]">
 use Chevere  parameter  Attributes  EnumAttr ;

#[EnumAttr( ' on ' , ' off ' )]

整數字串

使用函數intString建立與字串整數相符的String parameter 。

parameterintString; $int = intString(); $int('100');">
 use function Chevere  parameter  intString ;

$ int = intString ();
$ int ( ' 100 ' );

布林字串

使用函數boolString建立符合0和1字串的String parameter 。

parameterboolString; $bool = boolString(); $bool('0'); $bool('1');">
 use function Chevere  parameter  boolString ;

$ bool = boolString ();
$ bool ( ' 0 ' );
$ bool ( ' 1 ' );

日期字串

使用函數date建立與YYYY-MM-DD字串相符的String parameter 。

parameterdate; $date = date(); $date('2021-01-01');">
 use function Chevere  parameter  date ;

$ date = date ();
$ date ( ' 2021-01-01 ' );

時間字串

使用函數time建立一個與hh:mm:ss字串相符的String parameter 。

parametertime; $time = time(); $time('12:00:00');">
 use function Chevere  parameter  time ;

$ time = time ();
$ time ( ' 12:00:00 ' );

日期時間字串

使用函數datetime建立與YYYY-MM-DD hh:mm:ss字串相符的String parameter 。

parameterdatetime; $datetime = datetime(); $datetime('2024-01-09 10:53:00');">
 use function Chevere  parameter  datetime ;

$ datetime = datetime ();
$ datetime ( ' 2024-01-09 10:53:00 ' );

INT

使用函數int建立一個Int parameter 。傳遞整數範圍的min和max ， accept接受的整數列表， reject拒絕的整數列表。

parameterint; // Any int $int = int(); $int(1); // Integer between 0 and 100 $int = int(min: 0, max: 100); $int(50); // Integer matching 1, 2 or 3 $int = int(accept: [1, 2, 3]); $int(2); // Integer not-matching 1, 2 or 3 $int = int(reject: [1, 2, 3]); $int(4);">
 use function Chevere  parameter  int ;

// Any int
$ int = int ();
$ int ( 1 );
// Integer between 0 and 100
$ int = int (min: 0 , max: 100 );
$ int ( 50 );
// Integer matching 1, 2 or 3
$ int = int (accept: [ 1 , 2 , 3 ]);
$ int ( 2 );
// Integer not-matching 1, 2 or 3
$ int = int (reject: [ 1 , 2 , 3 ]);
$ int ( 4 );

使用IntAttr屬性定義整數parameter 。

parameterAttributesIntAttr; #[IntAttr(min: 0, max: 100)]">
 use Chevere  parameter  Attributes  IntAttr ;

#[IntAttr(min: 0 , max: 100 )]

Int 偽parameter s

下面的parameter都是基於Int的。

布林整數

使用函數boolInt建立符合0和1整數的Int parameter 。

parameterboolInt; $bool = boolInt(); $bool(0); $bool(1);">
 use function Chevere  parameter  boolInt ;

$ bool = boolInt ();
$ bool ( 0 );
$ bool ( 1 );

漂浮

使用函數float建立一個Float parameter 。傳遞浮點數範圍的min和max ， accept接受浮點數的列表， reject拒絕浮點數的列表。

parameterfloat; // Any float $float = float(); $float(1.5); // Float between 0 and 100 $float = float(min: 0, max: 100); $float(50.5); // Float matching 1.5, 2.5 or 3.5 $float = float(accept: [1.5, 2.5, 3.5]); $float(2.5); // Float not-matching 1.5, 2.5 or 3.5 $float = float(reject: [1.5, 2.5, 3.5]); $float(4.5);">
 use function Chevere  parameter  float ;

// Any float
$ float = float ();
$ float ( 1.5 );
// Float between 0 and 100
$ float = float (min: 0 , max: 100 );
$ float ( 50.5 );
// Float matching 1.5, 2.5 or 3.5
$ float = float (accept: [ 1.5 , 2.5 , 3.5 ]);
$ float ( 2.5 );
// Float not-matching 1.5, 2.5 or 3.5
$ float = float (reject: [ 1.5 , 2.5 , 3.5 ]);
$ float ( 4.5 );

使用FloatAttr屬性定義浮點parameter 。

parameterAttributesFloatAttr; #[FloatAttr(min: 0, max: 100)]">
 use Chevere  parameter  Attributes  FloatAttr ;

#[FloatAttr(min: 0 , max: 100 )]

布林

使用函數bool建立Bool parameter 。

parameterbool; $bool = bool(); $bool(true); $bool(false);">
 use function Chevere  parameter  bool ;

$ bool = bool ();
$ bool ( true );
$ bool ( false );

使用BoolAttr屬性定義 bool parameter 。

parameterAttributesBoolAttr; #[BoolAttr]">
 use Chevere  parameter  Attributes  BoolAttr ;

#[BoolAttr]

無效的

使用函數null建立一個Null parameter 。

parameternull; $null = null(); $null(null);">
 use function Chevere  parameter  null ;

$ null = null ();
$ null ( null );

使用NullAttr屬性定義空parameter 。

parameterAttributesNullAttr; #[NullAttr]">
 use Chevere  parameter  Attributes  NullAttr ;

#[NullAttr]

目的

使用函數object建立Object parameter 。傳遞物件類別名稱的 className。

parameterobject; $object = object(stdClass::class); $object(new stdClass());">
 use function Chevere  parameter  object ;

$ object = object (stdClass::class);
$ object ( new stdClass ());

使用ObjectAttr屬性定義物件parameter 。

parameterAttributesObjectAttr; #[ObjectAttr(stdClass::class)]">
 use Chevere  parameter  Attributes  ObjectAttr ;

#[ObjectAttr(stdClass::class)]

混合

使用函數mixed建立Mixed parameter 。

parametermixed; $mixed = mixed(); $mixed(1); $mixed('1'); $mixed(true); $mixed(null);">
 use function Chevere  parameter  mixed ;

$ mixed = mixed ();
$ mixed ( 1 );
$ mixed ( ' 1 ' );
$ mixed ( true );
$ mixed ( null );

聯盟

使用函數union建立Union parameter 。傳遞一系列要匹配的parameter ，目標值必須至少匹配一個。

parameterunion; // Any string or null $union = union(string(), null()); $union('abc'); $union(null); // Any digit string or any integer $union = union( intString(), integer() ); $union('100'); $union(100);">
 use function Chevere  parameter  union ;

// Any string or null
$ union = union ( string (), null());
$ union ( ' abc ' );
$ union ( null );
// Any digit string or any integer
$ union = union (
    intString (),
    integer ()
);
$ union ( ' 100 ' );
$ union ( 100 );

大批

類型array的parameter被處理為複合parameter保存其每個成員的parameter定義。

使用函數arrayp為命名參數建立Array parameter作為所需的陣列鍵。

parameterarrayp; // Empty array $array = arrayp(); $array([]); // Required 'a' => <string> $array = arrayp(a: string()); $array(['a' => 'Hello world']);">
 use function Chevere  parameter  arrayp ;

// Empty array
$ array = arrayp ();
$ array ([]);
// Required 'a' => <string>
$ array = arrayp (a: string ());
$ array ([ ' a ' => ' Hello world ' ]);

parameter支援任意深度的巢狀數組：

parameterarrayp; use function Chevere parameter float; use function Chevere parameter int; $array = arrayp( id: int(min: 0), items: arrayp( id: int(min: 0), price: float(min: 0), ), ); $array([ 'id' => 1, 'items' => [ 'id' => 25, 'price' => 16.5, ] ]);">
 use function Chevere  parameter  arrayp ;
use function Chevere  parameter  float ;
use function Chevere  parameter  int ;

$ array = arrayp (
    id: int (min: 0 ),
    items: arrayp (
        id: int (min: 0 ),
        price: float (min: 0 ),
    ),
);
$ array ([
    ' id ' => 1 ,
    ' items ' => [
        ' id ' => 25 ,
        ' price ' => 16.5 ,
    ]
]);

使用ArrayAttr屬性定義陣列parameter 。

parameterAttributesArrayAttr; use Chevere parameter AttributesFloatAttr; use Chevere parameter AttributesIntAttr; #[ArrayAttr( id: new IntAttr(), items: new ArrayAttr( id: new IntAttr(), price: new FloatAttr(), ), )]">
 use Chevere  parameter  Attributes  ArrayAttr ;
use Chevere  parameter  Attributes  FloatAttr ;
use Chevere  parameter  Attributes  IntAttr ;

#[ArrayAttr(
    id: new IntAttr (),
    items: new ArrayAttr (
        id: new IntAttr (),
        price: new FloatAttr (),
    ),
)]

與所需的

使用withRequired方法來定義所需的parameter 。 

 $ array = $ array
    -> withRequired (
        username: string (),
        email: string ()
    );

有可選的

使用withOptional方法來定義可選parameter 。 

 $ array = $ array
    -> withOptional (address: string ());

注意：只有在提供相符的金鑰時，可選parameter才會被驗證。

帶修改

使用withModify方法來定義修改parameter 。 

 $ array = $ array
    -> withModify (
        username: string ( ' /w+/ ' ),
    );

帶有 make 可選

使用withMakeOptional方法使所需parameter可選。 

 $ array = $ array
    -> withMakeOptional ( ' username ' );

需要製作

使用withMakeRequired方法將可選parameter設為必要。 

 $ array = $ array
    -> withMakeRequired ( ' email ' );

沒有

使用方法without刪除parameter s。 

 $ array = $ array
    -> without ( ' a ' );

具有可選的最小值

使用withOptionalMinimum方法定義可選parameter的最小數量。如果除 1 之外所有parameter都是可選的，則很有用。 

 $ array = $ array
    -> withOptionalMinimum ( 1 );

數組偽parameter s

下面的parameter都是基於Array的。

數組字串

使用函數arrayString為字串值建立ArrayString parameter Interface 。它只支援字串parameter 。

parameterarrayString; use function Chevere parameter string; $array = arrayString( test: string(), ); $array(['test' => 'foo']);">
 use function Chevere  parameter  arrayString ;
use function Chevere  parameter  string ;

$ array = arrayString (
    test: string (),
);
$ array ([ ' test ' => ' foo ' ]);

文件

使用函數file建立一個用於檔案上傳的Array parameter 。

parameterfile; $array = file(); $file = [ 'name' => 'foo.txt', 'type' => 'text/plain', 'tmp_name' => '/tmp/phpYzdqkD', 'error' => 0, 'size' => 123, ]; $array($file);">
 use function Chevere  parameter  file ;

$ array = file ();
$ file = [
    ' name ' => ' foo.txt ' ,
    ' type ' => ' text/plain ' ,
    ' tmp_name ' => ' /tmp/phpYzdqkD ' ,
    ' error ' => 0 ,
    ' size ' => 123 ,
];
$ array ( $ file );

預設情況下，它提供$_FILES形狀的驗證，但您可以定義自己的驗證規則。例如，要驗證名稱和內容：

parameterfile; $array = file( name: string('/^.txt$/'), contents: string('/wage-/'), ); $array( 'name' => 'wage-2024.txt', 'type' => 'text/plain', 'tmp_name' => '/tmp/phpYzdqkD', 'error' => 0, 'size' => 27, 'contents' => 'yada yada wage-2024 bla bla', );">
 use function Chevere  parameter  file ;

$ array = file (
    name: string ( ' /^.txt$/ ' ),
    contents: string ( ' /wage-/ ' ),
);
$ array (
    ' name ' => ' wage-2024.txt ' ,
    ' type ' => ' text/plain ' ,
    ' tmp_name ' => ' /tmp/phpYzdqkD ' ,
    ' error ' => 0 ,
    ' size ' => 27 ,
    ' contents ' => ' yada yada wage-2024 bla bla ' ,
);

可迭代

可迭代型Traversable|array被視為持有鍵和值的通用定義的複合parameter 。 parameter能夠描述共享相同形狀的項目的集合。

使用函數iterable建立一個Iterable parameter 。傳遞通用鍵和值的V和K parameter 。

parameterint; use function Chevere parameter iterable; $iterable = iterable(int(min: 0)); $iterable([0, 1, 2, 3]);">
 use function Chevere  parameter  int ;
use function Chevere  parameter  iterable ;

$ iterable = iterable ( int (min: 0 ));
$ iterable ([ 0 , 1 , 2 , 3 ]);

它也適用於命名鍵：

parameterint; use function Chevere parameter iterable; use function Chevere parameter string; $iterable = iterable( V: arrayp( id: int(min: 0), name: string('^[w]{1,255}'), ) K: string(), ); $iterable([ 'based' => [ 'id' => 1, 'name' => 'OscarGangas' ], 'fome' => [ 'id' => 2, 'name' => 'BomboFica' ], ]);">
 use function Chevere  parameter  int ;
use function Chevere  parameter  iterable ;
use function Chevere  parameter  string ;

$ iterable = iterable (
    V: arrayp (
        id: int (min: 0 ),
        name: string ( ' ^[w]{1,255} ' ),
    )
    K: string (),
);
$ iterable ([
    ' based ' => [
        ' id ' => 1 ,
        ' name ' => ' OscarGangas '
    ],
    ' fome ' => [
        ' id ' => 2 ,
        ' name ' => ' BomboFica '
    ],
]);

幫手

parameter

使用函數parameter s建立parameter s實例。

parameter s; use function Chevere parameter sstring; $ parameter s = parameter s(foo: string());">
 use function Chevere  parameter s  parameter s ;
use function Chevere  parameter s  string ;

$ parameter s = parameter s (foo: string ());

論點

使用函數arguments建立Arguments實例。

parametersarguments; use function Chevere parameter sstring; $arguments = arguments($ parameter s, ['foo' => 'bar']);">
 use function Chevere  parameter s  arguments ;
use function Chevere  parameter s  string ;

$ arguments = arguments ( $ parameter s , [ ' foo ' => ' bar ' ]);

斷言命名參數

使用函數assertNamedArgument斷言命名參數。

parametersassertNamedArgument; use function Chevere parameter sint; use function Chevere parameter s parameter s; $ parameter = int(min: 10); assertNamedArgument( name: 'foo', parameter : $ parameter , argument: 20 );">
 use function Chevere  parameter s  assertNamedArgument ;
use function Chevere  parameter s  int ;
use function Chevere  parameter s  parameter s ;

$ parameter = int (min: 10 );
assertNamedArgument (
    name: ' foo ' ,
    parameter : $ parameter ,
    argument: 20
);

至parameter

使用函數to parameter從類型字串建立parameter Interface介面實例。在下面的範例中，產生的$ parameter將是Int parameter 。

parameter ; $ parameter = to parameter ('int');">
 use function Chevere  parameter s  to parameter ;

$ parameter = to parameter ( ' int ' );

數組來源

使用函數arrayFrom從另一個陣列parameter建立一個陣列parameter 。在下面的範例中，產生的$array將只包含$source中定義的name和id鍵。

parametersarrayFrom; use function Chevere parameter sarrayp; use function Chevere parameter sint; use function Chevere parameter sstring; $source = arrayp( id: int(), name: string(), email: string(), age: int(), ); $array = arrayFrom($source, 'name', 'id');">
 use function Chevere  parameter s  arrayFrom ;
use function Chevere  parameter s  arrayp ;
use function Chevere  parameter s  int ;
use function Chevere  parameter s  string ;

$ source = arrayp (
    id: int (),
    name: string (),
    email: string (),
    age: int (),
);
$ array = arrayFrom ( $ source , ' name ' , ' id ' );

拿鑰匙

使用函數takeKeys從parameter中擷取包含鍵的陣列。在下面的範例中， $keys將包含id和size 。

parametersarrayp; use function Chevere parameter sint; use function Chevere parameter stakeKeys; $array = arrayp( id: int(), size: int(), ); $keys = takeKeys($array);">
 use function Chevere  parameter s  arrayp ;
use function Chevere  parameter s  int ;
use function Chevere  parameter s  takeKeys ;

$ array = arrayp (
    id: int (),
    size: int (),
);
$ keys = takeKeys ( $ array );

取自

使用函數takeFrom從parameter中檢索具有所需鍵的迭代器。在下面的範例中， $iterator將產生size和name鍵。

parametersarrayp; use function Chevere parameter sint; use function Chevere parameter sstring; use function Chevere parameter stakeFrom; $array = arrayp( id: int(min: 0), size: int(min: 100), name: string(), ); $iterator = takeFrom($array, 'size', 'name');">
 use function Chevere  parameter s  arrayp ;
use function Chevere  parameter s  int ;
use function Chevere  parameter s  string ;
use function Chevere  parameter s  takeFrom ;

$ array = arrayp (
    id: int (min: 0 ),
    size: int (min: 100 ),
    name: string (),
);
$ iterator = takeFrom ( $ array , ' size ' , ' name ' );

parameter sFrom

使用函數parameter sFrom從parameter建立具有所需鍵的parameter s 。在下面的範例中， $ parameter s將包含size和name鍵。

parametersarrayp; use function Chevere parameter sint; use function Chevere parameter sstring; use function Chevere parameter s parameter sFrom; $array = arrayp( id: int(min: 0), size: int(min: 100), name: string(), ); $ parameter s = parameter sFrom($array, 'size', 'name');">
 use function Chevere  parameter s  arrayp ;
use function Chevere  parameter s  int ;
use function Chevere  parameter s  string ;
use function Chevere  parameter s  parameter sFrom ;

$ array = arrayp (
    id: int (min: 0 ),
    size: int (min: 100 ),
    name: string (),
);
$ parameter s = parameter sFrom ( $ array , ' size ' , ' name ' );

取得parameter s

使用函數get parameter s從實作parameter AccessInterface或parameter sInterface物件中檢索parameter s實例。

parameter s; $ parameter s = get parameter s($object);">
 use function Chevere  parameter s  get parameter s ;

$ parameter s = get parameter s ( $ object );

獲取類型

使用函數getType檢索該庫已知的類型。

parametersgetType; $type = getType(1); // int">
 use function Chevere  parameter s  getType ;

$ type = getType ( 1 ); // int

parameter屬性

使用函數parameter Attr從函數或類別方法parameter中檢索實作parameter AttributeInterface的物件。

parameter Attr; use Chevere parameter AttributesStringAttr; function myFunction( #[StringAttr('/^bin-[d]+$/')] string $foo ): void { // ... } $stringAttr = parameter Attr('foo', 'myFunction'); $stringAttr('bin-123');">
 use function Chevere  parameter s  parameter Attr ;
use Chevere  parameter  Attributes  StringAttr ;


function myFunction (
    #[StringAttr( ' /^bin-[d]+$/ ' )]
    string $ foo
): void {
    // ...
}

$ stringAttr = parameter Attr ( ' foo ' , ' myFunction ' );
$ stringAttr ( ' bin-123 ' );

ReflectionTo parameter

使用函數reflectionTo parameter s從ReflectionFunction或ReflectionMethod實例檢索parameter s實例。

parameter s; $ parameter s = reflectionTo parameter s($reflection);">
 use function Chevere  parameter  reflectionTo parameter s ;

$ parameter s = reflectionTo parameter s ( $ reflection );

反射返回

使用函數reflectionToReturn從ReflectionFunction或ReflectionMethod實例檢索parameter Interface實例。

parameterreflectionToReturn; $ parameter = reflectionToReturn($reflection);">
 use function Chevere  parameter  reflectionToReturn ;

$ parameter = reflectionToReturn ( $ reflection );

反射parameter屬性

使用函數reflected parameter Attribute從Reflection parameter實例中擷取實作parameter AttributeInterface的物件。

parameter Attribute; $ parameter Attribute = reflected parameter Attribute($reflection parameter );">
 use function Chevere  parameter  reflected parameter Attribute ;

$ parameter Attribute = reflected parameter Attribute ( $ reflection parameter );

已驗證

使用函數validated來驗證函數或方法參數。

parametervalidated; $result = validated('myFunction', $arg1, $arg2,);">
 use function Chevere  parameter  validated ;

$ result = validated ( ' myFunction ' , $ arg1 , $ arg2 ,);

範例

內聯驗證

  • 驗證以“a”開頭的字串：
parameterstring; $value = 'ahhh'; string('/^a.+/')($value);">
 use function Chevere  parameter  string ;

$ value = ' ahhh ' ;
string ( ' /^a.+/ ' )( $ value );
  • 驗證最小值100的 int ：
parameterint; $value = 100; int(min: 100)($value);">
 use function Chevere  parameter  int ;

$ value = 100 ;
int (min: 100 )( $ value );
  • 驗證 int 接受列表：
parameterint; $value = 1; int(accept: [1, 2, 3])($value);">
 use function Chevere  parameter  int ;

$ value = 1 ;
int (accept: [ 1 , 2 , 3 ])( $ value );
  • 驗證浮動拒絕清單：
parameterfloat; $value = 3.1; float(reject: [1.1, 2.1])($value);">
 use function Chevere  parameter  float ;

$ value = 3.1 ;
float (reject: [ 1.1 , 2.1 ])( $ value );
  • 驗證數組：
parameterarrayp; use function Chevere parameter int; use function Chevere parameter string; $value = [ 'id' => 1, 'name' => 'Pepe' ]; arrayp( id: int(min: 1), name: string('/^[A-Z]{1}w+$/') )($value);">
 use function Chevere  parameter  arrayp ;
use function Chevere  parameter  int ;
use function Chevere  parameter  string ;

$ value = [
    ' id ' => 1 ,
    ' name ' => ' Pepe '
];
arrayp (
    id: int (min: 1 ),
    name: string ( ' /^[A-Z]{1}w+$/ ' )
)( $ value );
  • 驗證可迭代int列表：
parameterint; use function Chevere parameter iterable; $value = [1, 2, 3]; iterable(int())($value);">
 use function Chevere  parameter  int ;
use function Chevere  parameter  iterable ;

$ value = [ 1 , 2 , 3 ];
iterable ( int ())( $ value );
  • 使用字串鍵類型規則驗證可迭代 int 列表：
parameterint; use function Chevere parameter iterable; $value = [ 'unila' => 1, 'dorila' => 2, 'tirifila' => 3, ]; iterable( K: string('/ila$/'), V: int(min: 1) )($value);">
 use function Chevere  parameter  int ;
use function Chevere  parameter  iterable ;

$ value = [
    ' unila ' => 1 ,
    ' dorila ' => 2 ,
    ' tirifila ' => 3 ,
];
iterable (
    K: string ( ' /ila$/ ' ),
    V: int (min: 1 )
)( $ value );
  • 驗證 ?int 類型的聯合：
parameterint; use function Chevere parameter null; $value = 1; union(int(), null())($value);">
 use function Chevere  parameter  int ;
use function Chevere  parameter  null ;

$ value = 1 ;
union ( int (), null())( $ value );

屬性委託驗證

  • 使用函數validated()來取得針對所有規則進行驗證的回傳值。
parametervalidated; $result = validated('myFunction', $var);">
 use function Chevere  parameter  validated ;

$ result = validated ( ' myFunction ' , $ var );
  • 使用函數reflectionTo parameter s()取得驗證參數的規則。
parameterAttributesIntAttr; use function Chevere parameter arguments; use function Chevere parameter reflectionTo parameter s; $class = new class() { public function wea( #[IntAttr(accept: [1, 10, 100])] int $base ): void { } }; $object = new $class(); $reflection = new ReflectionMethod($object, 'wea'); $ parameter s = reflectionTo parameter s($reflection); $args = ['base' => 10]; $ parameter s(...$args); // valid $args $result = $object->wea(...$args);">
 use ReflectionMethod ;
use Chevere  parameter  Attributes  IntAttr ;
use function Chevere  parameter  arguments ;
use function Chevere  parameter  reflectionTo parameter s ;

$ class = new class () {
    public function wea (
        #[IntAttr(accept: [ 1 , 10 , 100 ])]
        int $ base
    ): void {
    }
};
$ object = new $ class ();
$ reflection = new ReflectionMethod ( $ object , ' wea ' );
$ parameter s = reflectionTo parameter s ( $ reflection );
$ args = [ ' base ' => 10 ];
$ parameter s (... $ args ); // valid $args
$ result = $ object -> wea (... $ args );
  • 使用函數reflectionToReturn()取得驗證函數/方法傳回值的規則：
parameterAttributesIntAttr; use Chevere parameter AttributesReturnAttr; use function Chevere parameter reflectionToReturn; $function = #[ReturnAttr( new IntAttr(min: 1000) )] function (int $base): int { return 10 * $base; }; $reflection = new ReflectionFunction($function); $return = reflectionToReturn($reflection); $base = 10; $result = $function($base); $result = $return($result); // Validates result">
 use ReflectionFunction ;
use Chevere  parameter  Attributes  IntAttr ;
use Chevere  parameter  Attributes  ReturnAttr ;
use function Chevere  parameter  reflectionToReturn ;

$ function =
    #[ReturnAttr(
        new IntAttr (min: 1000 )
    )]
    function ( int $ base ): int {
        return 10 * $ base ;
    };
$ reflection = new ReflectionFunction ( $ function );
$ return = reflectionToReturn ( $ reflection );
$ base = 10 ;
$ result = $ function ( $ base );
$ result = $ return ( $ result ); // Validates result

屬性內聯驗證

在函數/方法主體上使用valid()來觸發參數驗證。

  • 驗證Hugo 、 Paco 、 Luis的字串枚舉：
  • 驗證最小浮點數值1000 ：
parameterAttributesEnumAttr; use function Chevere parameter validate; function myEnum( #[EnumAttr('Hugo', 'Paco', 'Luis')] string $name, #[FloatAttr(min: 1000)] float $money ): void { valid(); // Or single... valid('name'); valid('money'); } $arg1 = 'Paco'; $arg2 = 1000.50; myEnum($arg1, $arg2);">
 use Chevere  parameter  Attributes  EnumAttr ;
use function Chevere  parameter  validate ;

function myEnum (
    #[EnumAttr( ' Hugo ' , ' Paco ' , ' Luis ' )]
    string $ name ,
    #[FloatAttr(min: 1000 )]
    float $ money
): void
{
    valid ();
    // Or single...
    valid ( ' name ' );
    valid ( ' money ' );
}
$ arg1 = ' Paco ' ;
$ arg2 = 1000.50 ;
myEnum ( $ arg1 , $ arg2 );
  • 驗證0和100以外的任何值的 int ：
parameterAttributesIntAttr; use function Chevere parameter validate; function myInt( #[IntAttr(reject: [0, 100])] int $id ): void { valid(); } $value = 50; myInt($value);">
 use Chevere  parameter  Attributes  IntAttr ;
use function Chevere  parameter  validate ;

function myInt (
    #[IntAttr(reject: [ 0 , 100 ])]
    int $ id
): void
{
    valid ();
}
$ value = 50 ;
myInt ( $ value );
  • 驗證一個可惡的嵌套數組：
parameterAttributesArrayAttr; use Chevere parameter AttributesIntAttr; use Chevere parameter AttributesStringAttr; use Chevere parameter AttributesIterableAttr; use function Chevere parameter validate; function myArray( #[ArrayAttr( id: new IntAttr(min: 1), role: new ArrayAttr( mask: new IntAttr(accept: [64, 128, 256]), name: new StringAttr('/[a-z]+/'), tenants: new IterableAttr( new IntAttr(min: 1) ) ), )] array $spooky ): void { valid(); } $value = [ 'id' => 10, 'role' => [ 'mask' => 128, 'name' => 'admin', 'tenants' => [1, 2, 3, 4, 5] ], ]; myArray($value);">
 use Chevere  parameter  Attributes  ArrayAttr ;
use Chevere  parameter  Attributes  IntAttr ;
use Chevere  parameter  Attributes  StringAttr ;
use Chevere  parameter  Attributes  IterableAttr ;
use function Chevere  parameter  validate ;

function myArray (
    #[ArrayAttr(
        id: new IntAttr (min: 1 ),
        role: new ArrayAttr (
            mask: new IntAttr (accept: [ 64 , 128 , 256 ]),
            name: new StringAttr ( ' /[a-z]+/ ' ),
            tenants: new IterableAttr (
                new IntAttr (min: 1 )
            )
        ),
    )]
    array $ spooky
): void
{
    valid ();
}
$ value = [
    ' id ' => 10 ,
    ' role ' => [
        ' mask ' => 128 ,
        ' name ' => ' admin ' ,
        ' tenants ' => [ 1 , 2 , 3 , 4 , 5 ]
    ],
];
myArray ( $ value );
  • 驗證可迭代 int 列表：
parameterAttributesIntAttr; use Chevere parameter AttributesIterableAttr; use function Chevere parameter validate; function myIterable( #[IterableAttr( new IntAttr(), )] array $list = [0,1,2] ): void { valid(); }">
 use Chevere  parameter  Attributes  IntAttr ;
use Chevere  parameter  Attributes  IterableAttr ;
use function Chevere  parameter  validate ;

function myIterable (
    #[IterableAttr(
        new IntAttr (),
    )]
    array $ list = [ 0 , 1 , 2 ]
): void
{
    valid ();
}

在函數/方法主體上使用函數returnAttr() 。

  • 驗證 int min: 0, max: 5回傳：
parameterAttributesIntAttr; use Chevere parameter AttributesReturnAttr; use function Chevere parameter returnAttr; #[ReturnAttr( new IntAttr(min: 0, max: 5) )] public function myReturnInt(): int { $result = 1; return returnAttr()($result); }">
 use Chevere  parameter  Attributes  IntAttr ;
use Chevere  parameter  Attributes  ReturnAttr ;
use function Chevere  parameter  returnAttr ;

#[ReturnAttr(
    new IntAttr (min: 0 , max: 5 )
)]
public function myReturnInt (): int
{
    $ result = 1 ;

    return returnAttr ()( $ result );
}
  • 驗證數組傳回：
parameterAttributesArrayAttr; use Chevere parameter AttributesIntAttr; use Chevere parameter AttributesStringAttr; use Chevere parameter AttributesReturnAttr; use function Chevere parameter returnAttr; #[ReturnAttr( new ArrayAttr( id: new IntAttr(min: 0), name: new StringAttr() ) )] public function myReturnArray(): array { $result = [ 'id' => 1, 'name' => 'Peoples Hernandez' ]; return returnAttr()($result); }">
 use Chevere  parameter  Attributes  ArrayAttr ;
use Chevere  parameter  Attributes  IntAttr ;
use Chevere  parameter  Attributes  StringAttr ;
use Chevere  parameter  Attributes  ReturnAttr ;
use function Chevere  parameter  returnAttr ;

#[ReturnAttr(
    new ArrayAttr (
        id: new IntAttr (min: 0 ),
        name: new StringAttr ()
    )
)]
public function myReturnArray (): array
{
    $ result = [
        ' id ' => 1 ,
        ' name ' => ' Peoples Hernandez '
    ];

    return returnAttr ()( $ result );
}

依照約定，當省略ReturnAttr時，方法public static function return(): parameter Interface （如果有）將用於確定返回驗證規則。

文件

文件可在 chevere.org 上取得。

執照

版權所有魯道夫·貝裡奧斯 A.

Chevere 根據 Apache 授權 2.0 版授權。請參閱許可證以取得完整的許可證文字。

除非適用法律要求或書面同意，否則根據許可證分發的軟體均以「原樣」分發，不帶任何明示或暗示的保證或條件。請參閱許可證，了解許可證下管理權限和限制的特定語言。

展開
附加信息
相關應用
爲您推薦
相關資訊 全部