ramda-php

This is a PHP implementation of ramda.js - a functional programming library. (http://ramdajs.com/)

So far only the curry functions and part of the functions implemented. The library is capable of doing the what's in the ramda.js examples.

Implemented Methods

• add
• addIndex
• adjust
• all
• allPass
• allUniq
• always
• and
• any
• anyPass
• ap
• aperture
• append
• apply
• applySpec
• assoc
• assocPath
• binary
• bind
• both
• call
• chain
• clamp
• clone
• comparator
• complement
• compose
• composeK
• composeP
• concat
• cond
• construct
• constructN
• contains
• converge
• countBy
• curry
• curryN
• dec
• defaultTo
• difference
• differenceWith
• dissoc
• dissocPath
• divide
• drop
• dropLast
• dropLastWhile
• dropRepeats
• dropRepeatsWith
• dropWhile
• either
• empty
• eqBy
• eqProps
• equals
• evolve
• filter
• find
• findIndex
• findLast
• findLastIndex
• flatten
• flip
• forEach
• fromPairs
• groupBy
• gt
• gte
• has
• hasIn
• head
• identical
• identity
• ifElse
• inc
• indexBy
• indexOf
• init
• insert
• insertAll
• internal
• intersection
• intersectionWith
• intersperse
• into
• invert
• invertObj
• invoker
• is
• isArrayLike
• isEmpty
• isNil
• join
• juxt
• keys
• keysIn
• last
• lastIndexOf
• length
• lens
• lensIndex
• lensPath
• lensProp
• lift
• liftN
• lt
• lte
• map
• mapAccum
• mapAccumRight
• mapObjIndexed
• match
• mathMod
• max
• maxBy
• mean
• median
• memoize
• merge
• mergeAll
• mergeWith
• mergeWithKey
• min
• minBy
• modulo
• multiply
• nAry
• negate
• none
• not
• nth
• nthArg
• objOf
• of
• omit
• once
• or
• over
• pair
• partial
• partialRight
• partition
• path
• pathEq
• pathOr
• pathSatisfies
• pick
• pickAll
• pickBy
• pipe
• pipeK
• pipeP
• pluck
• prepend
• product
• project
• prop
• propEq
• propIs
• propOr
• propSatisfies
• props
• range
• reduce
• reduceBy
• reduceRight
• reduced
• reject
• remove
• repeat
• replace
• reverse
• scan
• sequence
• set
• slice
• sort
• sortBy
• split
• splitAt
• splitEvery
• splitWhen
• subtract
• sum
• symmetricDifference
• symmetricDifferenceWith
• tail
• take
• takeLast
• takeLastWhile
• takeWhile
• tap
• test
• times
• toLower
• toPairs
• toPairsIn
• toString
• toUpper
• transduce
• transpose
• traverse
• trim
• tryCatch
• type
• unapply
• unary
• uncurryN
• unfold
• union
• unionWith
• uniq
• uniqBy
• uniqWith
• unless
• unnest
• update
• useWith
• values
• valuesIn
• view
• when
• where
• whereEq
• without
• wrap
• xprod
• zip
• zipObj
• zipWith

Introduced Methods

R::$flatten1 - flatten in non-recursive way (for 1 depth only).

How to Use

Compose functions:

  require_once 'ramda.php';
  
  $getIncompleteTaskSummaries = function($membername) {
    return (R::$compose)(
      (R::$sortBy)((R::$prop)('dueDate')),
      (R::$map)((R::$pick)(['id', 'dueDate', 'title', 'priority'])),
      (R::$reject)((R::$propEq)('complete', true)),
      (R::$filter)((R::$propEq)('username', $membername)),
      (R::$prop)('tasks'));
  };

Use the function on data:

  $data = [
      'result' => "SUCCESS",
      'interfaceVersion' => "1.0.3",
      'requested' => "10/17/2013 15:31:20",
      'lastUpdated' => "10/16/2013 10:52:39",
      'tasks' => [
          ['id' => 104, 'complete' => false,            'priority' => "high",
                    'dueDate' => "2013-11-29",      'username' => "Scott",
                    'title' => "Do something",      'created' => "9/22/2013"],
          ['id' => 105, 'complete' => false,            'priority' => "medium",
                    'dueDate' => "2013-11-22",      'username' => "Lena",
                    'title' => "Do something else", 'created' => "9/22/2013"],
          ['id' => 107, 'complete' => false,             'priority' => "high",
                    'dueDate' => "2013-11-22",      'username' => "Mike",
                    'title' => "Fix the foo",       'created' => "9/22/2013"],
          ['id' => 108, 'complete' => false,            'priority' => "low",
                    'dueDate' => "2013-11-15",      'username' => "Punam",
                    'title' => "Adjust the bar",    'created' => "9/25/2013"],
          ['id' => 110, 'complete' => false,            'priority' => "medium",
                    'dueDate' => "2013-11-15",      'username' => "Scott",
                    'title' => "Rename everything", 'created' => "10/2/2013"],
          ['id' => 112, 'complete' => true,             'priority' => "high",
                    'dueDate' => "2013-11-27",      'username' => "Lena",
                    'title' => "Alter all quuxes",  'created' => "10/5/2013"],
          ['id' => 122, 'complete' => false,             'priority' => "high",
                    'dueDate' => "2013-11-01",      'username' => "Mike",
                    'title' => "Fix the bar",       'created' => "9/22/2013"],
          ['id' => 123, 'complete' => true,             'priority' => "high",
                    'dueDate' => "2013-11-22",      'username' => "Mike",
                    'title' => "Fix the foobar",       'created' => "9/22/2013"],

      ]
  ];
  $tasks = $getIncompleteTaskSummaries("Mike")($data);
  print_r($tasks);

Outputs:

(
    [0] => Array
        (
            [id] => 122
            [dueDate] => 2013-11-01
            [title] => Fix the bar
            [priority] => high
        )

    [1] => Array
        (
            [id] => 107
            [dueDate] => 2013-11-22
            [title] => Fix the foo
            [priority] => high
        )

)

Note: as a defect of PHP compiler, static method R::$add(1,2) wouldn't compile. To get around, place the static method inside parenthesis (R::$add)(1,2)

Curry functions:

(Note: R::$_ is the placeholder parameter.)

  $f3 = function($a, $b, $c) {
      return $a*2+$b*3+$c*4;
  };
  $c = R::curry($f3);
  $cc = $c(R::$_,2,R::$_);
  print_r($cc(1,3));

Outputs:

  20

(More examples can be found in the /tests folder.)