I'm developing a Laravel webapplication which hooks into Magento (don't ask me why..), which now throws Cannot redeclare __() since Magento tries to define this function as a translation helper.

Any ideas on how to circumvent this? The undescore-php helper function is declared first, so a simple if( ! function_exists( '__' ) ) { ... } won't suffice.

I used underscore.php for some time but it lacks support so I was very happy when I found your bundle.

It is not verbatim version of JS original as you warn, but it has some changes not so obvious for me. So I have a few questions.

1. Why did you remove map() method?
2. Why you do not pass a collection as an argument to an iterator.
3. And the last one is more of a wish: reduce is one of the most powerful methods in Underscore. Do you plan to add it anytime soon?

The code of your library is nicely structured and written. Digging it itself was very valuable for me. Thank you for sharing it.

I guess there is a typo and an error:

353: if ($arguments) return array_map($callable, $array, $callable);

Did you mean to pass $arguments? Anyway it won't work—the third argument is not a list of arguments for a callable. It is another array to be processed with it. It is not a Laravel class :)

It could be used to map arguments for each call of a callable, but it should have the same length as the main collection. Eg., if we want to trim underscore symbol we need to pass it as following:

$array = array('foo______', '_____bar');
$array = Arrays::invoke($array, 'trim', array('_','_'));
$this->assertEquals(array('foo', 'bar'), $array);

I find the current signature of without very limiting (aka, passing in an unbounded list of exclusion parameters) so I've written it so that this can be preserved but you can instead send in just one ARRAY parameter to act as the exclusion list.

That is probably not the clearest explanation but hopefully the code/unit test is clear enough.

I've added two related functions which operate on Array or Object collections:

1. filterBy - Allows you to filter down a collection to only those objects which have a matching name/value pair.

   usage:

    Object::filterBy($collection, $property, $value, $comparisonOperation = "eq");
    Arrays::filterBy($collection, $property, $value, $comparisonOperation = "eq");
   

2. findBy - Very similar to filterBy but assumes that only one result should be returned and therefore unpacks the surrounding array.

   usage:

    Object::findBy($collection, $property, $value, $comparisonOperation = "eq");
    Arrays::findBy($collection, $property, $value, $comparisonOperation = "eq");
   

note: If the filter operation actually does return more than one result, findBy will take the first object in the resulting array of objects.

In php7 there is this error:

Fatal error: Cannot use Underscore\Types\String as String because 'String' is a special class name in /myproject/vendor/anahkiasen/underscore-php/src/Methods/StringMethods.php on line 5

Php7 not allows the classes to have a name like string, bool, int, ... See http://php.net/manual/en/reserved.other-reserved-words.php for more details

Hi.

I am not sure if this is the intention, but I would expect to get "null" if nothing can be found that satisfies the predicate.

The code in ArraysMethods.php is:

  /**
   * Find the first item in an array that passes the truth test
   */
  public static function find($array, Closure $closure)
  {
    foreach ($array as $key => $value) {
      if ($closure($value, $key)) return $value;
    }

    return $array;
  }

Not sure if I can already efficiently do this with the current functions but I often used the following to convert a regular array of associative arrays to an associative array of same arrays by a given key (my example should make more sense).

I called it array hash map, probably not the best name though.

function array_hash_map($key, $array) {
        if (!$array) {
            return [];
        }
        $ret = [];
        foreach ($array as $a) {
            $ret[$a[$key]] = $a;
        }
        return $ret;
    }

Example:

$a = [
 ['id' => 5, 'name': foo],
 ['id' => 10, 'name': bar]
];

$a = array_hash_map('id', $a);

/*
  $a is now: 
  [
    '5' => ['id' => 5, 'name': foo],
    '10' => ['id' => 10, 'name': bar]
  ]
*/

Just a suggestion of a possible utility function for Arrays.

rel: https://github.com/Anahkiasen/underscore-php/issues/33

I would like to implement Types\Arrays::indexBy() that is implemented in underscore.js. It's _.indexBy() work like this:

> var stooges = [{name: 'moe', age: 40}, {name: 'larry', age: 50}, {name: 'curly', age: 60}];
undefined
> u.indexBy(stooges, 'age');
{ '40': { name: 'moe', age: 40 },
  '50': { name: 'larry', age: 50 },
  '60': { name: 'curly', age: 60 } }
>
> u.indexBy(stooges, 'hoge');
{ undefined: { name: 'curly', age: 60 } }

In case of non-existing key is specified, underscore.js's _.indexBy() return last element with key undefined (this might not be intentionally).

But it's better not to include in result in PHP. So,

$ php -r 'print_r(Arrays::indexOf(..., "hoge");'
Array
(
)

For now it is a very simple function. It uses Array::contains for comparison.

differences with regular lodash

• no key for Array of Objects support
• No sorting option

I don't if you consider those crucial for the method? I could very easily implement them, no problem.

Normally, Types\Arrays::group() works like this.

<?php

require __DIR__ . '/../vendor/autoload.php';

use Underscore\Types\Arrays;

$rows = [
    ['id' => 1, 'category' => 'a'],
    ['id' => 2, 'category' => 'b'],
    ['id' => 3, 'category' => 'a']
];

var_export(Arrays::group($rows, 'category'));

❯ php src/arrays_group.php
array (
  'a' =>
  array (
    0 =>
    array (
      'id' => 1,
      'category' => 'a',
    ),
    1 =>
    array (
      'id' => 3,
      'category' => 'a',
    ),
  ),
  'b' =>
  array (
    0 =>
    array (
      'id' => 2,
      'category' => 'b',
    ),
  ),
)

When I specify key that some rows in $rows doesn't have corresponded value, Arrays::group() returns result like this. It's hard to predict.

print_r(Arrays::group($rows, 'unknown'));

❯ php src/arrays_group.php
array (
  '' =>
  array (
    '' =>
    array (
      '' =>
      array (
        0 =>
        array (
          'id' => 1,
          'category' => 'a',
        ),
      ),
      0 =>
      array (
        'id' => 2,
        'category' => 'b',
      ),
    ),
    0 =>
    array (
      'id' => 3,
      'category' => 'a',
    ),
  ),
)

I would like it to return empty array. Because nothing exists for the key unknown.

print_r(Arrays::group($rows, 'unknown'));

❯ php src/arrays_group.php
array (
)

Recently after upgrading to php7.2 I have received the following error "PHP message: PHP Fatal error: Cannot use Underscore\Types\Object as Object because 'Object' is a special class name". I've been noticing this across multiple libraries.

Frustrated by the lack of updates, we built our own Underscore-like functional programming library since none of the tools out there were maintained, easy to use, or well-documented: https://github.com/nextbigsoundinc/dash

$avgMaleAge = Dash\chain([
	['name' => 'John', 'age' => 12, 'gender' => 'male'],
	['name' => 'Jane', 'age' => 34, 'gender' => 'female'],
	['name' => 'Pete', 'age' => 23, 'gender' => 'male'],
	['name' => 'Mark', 'age' => 11, 'gender' => 'male'],
	['name' => 'Mary', 'age' => 42, 'gender' => 'female'],
])
->filter(['gender', 'male'])
->map('age')
->average()
->value();

echo "Average male age is $avgMaleAge.";

Highlights:

• Many data types supported: arrays, objects, generators (coming soon), Traversable, DirectoryIterator, and more
• Chaining
• Currying
• Lazy evaluation
• Custom operations
• Well-tested: Comprehensive tests with nearly 3,000 test cases and 100% code coverage

I hope it can be useful to someone. Feedback welcome!

When installing underscore-php v2.0.0, it reports that it requires php: >=5.4.0 in its composer.json, however at the same time it requires doctrine/inflector (^1.0) which installs v1.3.0 and it requires PHP ^7.1.

Test on empty folder:

$ composer require anahkiasen/underscore-php:2.0.0
$ find vendor -name \*.php -exec php56 -l {} ';'
No syntax errors detected in vendor/composer/ClassLoader.php
PHP Parse error:  syntax error, unexpected ':', expecting ';' or '{' in vendor/doctrine/inflector/lib/Doctrine/Common/Inflector/Inflector.php on line 265

Parse error: syntax error, unexpected ':', expecting ';' or '{' in vendor/doctrine/inflector/lib/Doctrine/Common/Inflector/Inflector.php on line 265
Errors parsing vendor/doctrine/inflector/lib/Doctrine/Common/Inflector/Inflector.php
No syntax errors detected in vendor/patchwork/utf8/src/Normalizer.php
...

On your site under Array::reject there is a typo in the method usage example. The example uses Array::filter method insted of Array::reject The example says:

Arrays::filter(array(1, 2, 3), function($value) {
    return $value % 2 != 0; // Returns array(2)
});

It should rather say:

Arrays::reject(array(1, 2, 3), function($value) {
    return $value % 2 != 0; // Returns array(2)
});