standardebooks/web
1
0
Fork 0
mirror of https://github.com/standardebooks/web.git synced 2025-07-14 10:31:59 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

Clarify comments in PropertyFromHttp trait

Browse source
This commit is contained in:
Alex Cabal 2024-11-11 14:22:25 -06:00
parent d4c7703cf0
commit a5bd5d18ad
1 changed files with 21 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

30
lib/Traits/PropertyFromHttp.php
View file

@ -7,6 +7,14 @@ trait PropertyFromHttp{
/**
* Given the string name of a property, try to fill it from HTTP data (POST by default).
*
* Keys in the `$_POST` array must be in the format: `<class-name>-<property-name>`, where `<property-name>` may contain dashes to separate words.
*
* For example:
*
* - `$_POST['test-foo-id']` maps to `Test::$FooId`.
*
* - `$_POST['test-bar']` maps to `Test::$Bar`.
*
* This function will try to infer the type of the class property using reflection.
*
* - If a variable doesn't match a class property (either by name or by type), then the class property is unchanged.
@ -30,39 +38,43 @@ trait PropertyFromHttp{
*
* - POST `['test-foo' => 'bar']`:
*
* No changes
* No changes, because `Test::$Foo` is not defined.
*
* - POST `['test-id' => '123']`:
*
* `$Id`: set to `123`
* `Test::$Id` set to `123`.
*
* - POST `['test-id' => '']`:
*
* `$Id`: unchanged, because it is not nullable
* `Test::$Id` unchanged, because it is not nullable.
*
* - POST `['test-name' => 'bob']`:
*
* `$Name`: set to `"bob"`
* `Test::$Name` set to `"bob"`.
*
* - POST `['test-name' => '']`:
*
* `$Name`: set to `""`, because it is not nullable
* `Test::$Name` set to `""` instead of `null`, because it is not nullable.
*
* - POST `['test-description' => 'abc']`:
*
* `$Description`: set to `abc`
* `Test::$Description` set to `"abc"`.
*
* - POST `['test-description' => '']`:
*
* `$Description`: set to `null`, because it is nullable
* `Test::$Description` set to `null`, because it is nullable.
*
* - POST `['test-chapter-number' => '456']`:
*
* `$ChapterNumber`: set to `456`
* `Test::$ChapterNumber` set to `456`.
*
* - POST `['test-chapter-number' => 'abc']`:
*
* `Test::$ChapterNumber` is unchanged, because we are passed a string but the corresponding property is an int.
*
* - POST `['test-chapter-number' => '']`:
*
* `$ChapterNumber`: set to `null`, because an empty string sets nullable properties to `null`.
* `Test::$ChapterNumber` set to `null`, because an empty string sets nullable properties to `null`.
*/
public function PropertyFromHttp(string $property, \Enums\HttpVariableSource $set = POST, ?string $httpName = null): void{
try{