PHPivot

A flexible Pivot Table library for PHP.

#Example01

• Using the film dataset from: https://perso.telecom-paristech.fr/~eagan/class/igr204/datasets
• Go to Example01/Example.php to see how the library is used
• See the output of Example.php here

#Supported Features:

• Nested (infinite) rows and columns
• Sum and Count Functions
• Generate HTML Table
  • Ignore empty rows [ setIgnoreBlankValues ]
• Filters (Equal, Not Equal)
  • Filters support UNIX Wildcards (shell patterns), like *, ?, [ae], etc. (see php.net/fnmatch )
  • Support for Multiple Values matched as ALL(AND)/OR(ANY)/NONE(NOR) (MATCH_ALL, MATCH_NONE, MATCH_ANY)
  • Additional User-Defined functions as Filters
    • addCustomFilter( user_defined_filter_function, $extra_params = null )
      • @user_defined_filter_function($recordset, $rowID, $extra_params = null) -> should return true whenever a row should be INCLUDED.
  • User-defined "filters" can be setup using calculated columns and regular filters!
• Calculated Columns
  • User defined functions.
  • They can return an array with "key-value" pairs, resulting in multiple calculated columns,named as CALC_COL_NAME_KEY
• Sorting(Ascending by default, Descending, User defined functions)
  • Different Row and Column Sorting methods
  • Can give array argument for multiple level/different sorting
  • User-defined sorting functions
    • @user-defined-sorting-function($a,$b) -> should return $a < $b as boolean
• Display as:
  • Actual Values
  • Percentage of col/row

#Features that need migration to the latest version/TODOs

• Display as: -Percentage of deepest level (@fix)
• Color Coding (background) of data: (@fix)
  • Low->High/High->Low gradient
• "Pivot Comparison" mechanism

#Usage example:

require 'PHPivot.php';

//@table: an associative array containing rows of columns (like JSON)
function printPivotHTML(){
    $filmsByActorAndGenre = PHPivot::create($data)
            ->setPivotRowFields('Actor')
            ->setPivotColumnFields('Genre')
            ->setPivotValueFields('Genre',PHPivot::PIVOT_VALUE_COUNT, PHPivot::DISPLAY_AS_VALUE_AND_PERC_ROW, 'Frequency of Genre in each year')
            ->addFilter('Genre','', PHPivot::COMPARE_NOT_EQUAL) //Filter out blanks/unknown genre
            ->generate();
    echo $filmsByActorAndGenre->toHtml();
}