library struct

eggbe/struct

Struct features emulation for php.

Introduction

The phpABLE struct emulation library., _(*1)

Requirements

• PHP >= 8.0.0
• able/helpers
• able/prototypes
• able/exceptions
• able/reglib

Features

The mission of this library is to emulate the structures' behavior most naturally., _(*2)

Install

There's a simple way to install the able/struct package via composer:, _(*3)

composer require able/struct

Usage

Basic

Let's try to declare a structure:, _(*4)

use \Able\Struct;

class MyStruct extends AStruct {

    protected static $Prototype = ['field1', 'field2'];
}

Now we can use it in a siple way:, _(*5)

$Struct = new MyStruct(1,2);
echo $Struct->field1;

//> 1

It's also possible to fill fields later:, _(*6)

$Struct = new MyStruct();

$Struct->field1 = "Test string!";
echo $Struct->field1;

//> Test string!

Mutators

Mutators are pretty helpful in case it needed to customize the default structure behavior., _(*7)

use \Able\Struct;

class MyStruct extends AStruct {

    protected static $Prototype = ['field1', 'field2'];

    protected final function setField1Property($value) {
        return 'The mutated via setter value is: ' . $value;
    }

    protected final function getField2Property($value) {
        return 'The mutated via getter value is: ' . $value;
    }
}

Let's test it:, _(*8)

$Struct = new MyStruct(1,2);

echo $Struct->field1;
echo $Struct->field2;

//> The mutated via setter value is: 1
//> The mutated via getter value is: 2

The next example just illustrates the difference between setters and getters., _(*9)

$Data = $Struct->toArray();

echo $Data['field1'];
echo $Data['field2'];

//> The mutated via setter value is: 1
//> 2

Default values

The default values could be set via constants., _(*10)

use \Able\Struct;

class MyParentStruct extends AStruct {

    protected static array $Prototype = ['field1', 'field2'];

    protected const defaultField1Value = "default value for field1";
    protected const defaultField2Value = "default value for field2";
}

Inheritance

The inheritance level isn't limited. All fields defined at parent classes will also be accessible at child classes., _(*11)

use \Able\Struct;

class MyParentStruct extends AStruct {

    protected static array $Prototype = ['field1', 'field2'];
}

class MyChildStruct extends MyParentStruct {

    protected static array $Prototype = ['field3'];
}

It perfectly works:, _(*12)

$Struct = new MyChildStruct(1,2,3);

echo $Struct->field1;
echo $Struct->field2;
echo $Struct->field3;

//> 1
//> 2
//> 3

Advanced

To retrieve all structure keys:, _(*13)

$Struct->keys();

To retrieve all structure values:, _(*14)

$Struct->values();

To copy all data into an array:, _(*15)

$Struct->toArray();

To get fields count:, _(*16)

$Struct->count();

To clean all fields and restore its default values:, _(*17)

$Struct->flush();

IDEs support

If you use a PHPDoc-friendly IDE you can gain additional advantages by using the syntax below:, _(*18)

use \Able\Struct;

/**
 * @property int field1
 * @property string field2
 */
class MyStruct extends AStruct {

    protected static array $Prototype = ['field1', 'field2'];
}

License

This package is released under the MIT license., _(*19)