Download the PHP package its-mieger/obj without Composer

On this page you can find all versions of the php package its-mieger/obj. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package obj

ItsMieger Obj - Native data type behavior for PHP objects

This library helps to implement behavior like native data types (casts, comparision, conversion, operator overloading ...) for custom PHP objects.

Since PHP does not support operator overloading, custom helper functions are implemented to apply operations using the implemented behavior.

Following interfaces are available:

Interface Purpose
Comparable Object can be compared with others (overrides comparision operators)
CastsAsBoolean Object can be represented as boolean
CastsAsFloat Object can be represented as float
CastsAsInteger Object can be represented as integer
CastsAsString Object can be represented as string
OperatorAdd Object implements custom add operator
OperatorSubtract Object implements custom subtract operator
OperatorMultiply Object implements custom multiply operator
OperatorDivide Object implements custom divide operator
Nullable Object can represent null

Helper functions

Since PHP does not support operator overloading special helper functions must be used to make objects behave as implemented by the specified interfaces. However helper functions are not autoloaded but may be imported by calling Obj::loadHelpers(). If not loaded, the helpers may be called using the static methods of the Obj-class

Native Helper function Call without helper function
== o_eq Obj::equal(...)
!= o_ne Obj::notEqual(...)
<=> o_comp Obj::compare(...)
< o_lt Obj::lessThan(...)
<= o_le Obj::lessThanOrEqual(...)
> o_gt Obj::greaterThan(...)
>= o_ge Obj::greaterThanOrEqual(...)
+ o_add Obj::add(...)
- o_sub Obj::subtract(...)
* o_mul Obj::multiply(...)
/ o_div Obj::divide(...)
isFloat() o_isFloat Obj::isFloat(...)
isInt() o_isInt Obj::isInt(...)
isBool() o_isBool Obj::isBool(...)
isString() o_isString Obj::isString(...)
(float) o_castFloat Obj::castFloat(...)
(int) o_castInt Obj::castInt(...)
(bool) o_castBool Obj::castBool(...)
(string) o_castString Obj::castString(...)
o_comparePipe Obj::comparePipe(...)

Behavior

Using one of the object helper functions, objects behave like native data types would do for the corresponding native operator.

Example:

class MyInt implements CastsAsInteger {

    public function toInt(): int {
        return 3;
    }

}
$a = new MyInt();

$result = op_add($a, 2);

In this example $result will be 5. Adding an integer to the object will call the toInt()-function to cast the object as integer and than execute the operation.

Important You should not implement more than one CastsAs*-interface in one class. Of you would do the object might behave unexpected since in some situations it might be converted eg. to int and in others to float. Rather than implementing both interface, you should only implement eg. int. If a float value is required, the returned int value is casted to float automatically.

Overriding operators

Sometimes casting objects is not enough. Imagine a custom Money implementation where you want to add two Money objects and want to receive a new Money object instead of a scalar number. Therefore you may implement one of the Operator*-interfaces and define your custom operator.

How operators are applied

Sometimes it is not obvious which operator function is called. Especially if having two objects implementing the same operator. The behavior described below concerns the Operator*-interfaces as well as the Comparable-interface which overrides all comparision operators with one function:

Testing

You may mock helpers by creating a mock object for the ObjectHelper-class and pass it to Obj::mock(...). This way all calls to object helpers (via helper functions or static interface) are redirected to the mocked object. Call Obj::resetMock() to remove the mocked object und make object logic be used again.

All versions of obj with dependencies

PHP Build Version
Package Version
Requires php Version >=7.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package its-mieger/obj contains the following files

Loading the files please wait ....