https://github.com/vector-php/vector
A PHP functional programming library.
https://github.com/vector-php/vector
autoload currying functional library memoization php vector
Last synced: 4 months ago
JSON representation
A PHP functional programming library.
- Host: GitHub
- URL: https://github.com/vector-php/vector
- Owner: vector-php
- License: mit
- Created: 2016-01-18T19:56:10.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2020-11-27T21:15:56.000Z (over 5 years ago)
- Last Synced: 2025-09-13T10:59:27.030Z (8 months ago)
- Topics: autoload, currying, functional, library, memoization, php, vector
- Language: PHP
- Size: 1.13 MB
- Stars: 19
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
Awesome Lists containing this project
README
[](https://niceme.me/)
## The Elevator Pitch
Vector gives you php functional superpowers.
- The evolution:
- _Native PHP_
```php
array_sum(
array_map(
fn($a) => $a + 1,
[1, 2, 3]
)
);
// 9
```
- 👎 More than 1 or 2 function chains is unmaintainable
- _Laravel Collections_
```php
collect([1, 2, 3])
->map(fn($a) => $a + 1)
->sum();
// 9
```
- 👍 More than 1 or 2 function chains is unmaintainable
- 👎 Unfortunately you can't do this with every type in the same elegant way (only works with collections)
- _Vector_
```php
vector([1, 2, 3])
->pipe(Arrays::map(Math::add(1))) // or `fn($a) => $a + 1)`
->pipe(Math::sum())();
// [2, 3, 4]
```
- 👍 Works super similarly to collections, but just accepts & returns normal arrays (no ->toArray()-ing necessary)
- 👍 Works super similarly to collections for everything else too!
- 👎 Unfortunately it is an extra dependency (we don't have the native pipe operator yet https://wiki.php.net/rfc/pipe-operator-v2)
- You can add currying to any function, it isn't only limited to Vector built ins.
- `Module::curry('explode')(',')('a,b,c')(PHP_INT_MAX)` `// ['a', 'b', 'c']`
## PHP Version Support
- 8.0+
## Install
```
composer require vector/core
```
## Show Me Some More Code
More automatic currying.
```php
$addOne = Arrays::map(Math::add(1));
$addOne([1, 2, 3]); // [2, 3, 4]
```
First class composition (Functional Pipelines).
```php
$addSix = Lambda::compose(Math::add(4), Math::add(2)); // (Or ::pipe for the opposite flow direction)
$addSix(4); // 10;
```
Pattern Matching (Maybe & Result monads included).
```php
Pattern::match([
fn(Just $value) => fn ($unwrapped) => $unwrapped,
fn(Nothing $value) => 'nothing',
])(Maybe::just('just')); // 'just'
```
Granular control flow (without try/catch).
```php
$errorHandler = function (Err $err) {
return Pattern::match([
function (QueryException $exception) {
Log::info($exception);
return response(404);
},
function (DBException $exception) {
Log::error($exception);
return response(500);
},
]);
};
return Pattern::match([
fn(Ok $value) => fn (User $user) => $user,
$errorHandler
])(Result::from(fn() => User::findOrFail(1)));
```
Make your own modules with auto-curried methods
```php
use Vector\Core\Curry;
use Vector\Core\Module;
class MyModule
{
use Module;
#[Curry]
protected static function myCurriedFunction($a, $b)
{
return $a + $b;
}
}
```