PHPackages                             nsbucky/gridview - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. nsbucky/gridview

ActiveLibrary[Utility & Helpers](/categories/utility)

nsbucky/gridview
================

A simple way to generate a table from an array

1.0(11y ago)55101MITPHPPHP >=5.3.0

Since Jun 1Pushed 11y ago1 watchersCompare

[ Source](https://github.com/nsbucky/gridview)[ Packagist](https://packagist.org/packages/nsbucky/gridview)[ Docs](https://github.com/nsbucky/gridview)[ RSS](/packages/nsbucky-gridview/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (1)DependenciesVersions (2)Used By (0)

GridView
========

[](#gridview)

Inspired by Yii's CGridView, this class strives to be a simple way to generate a table from an array, ie; a database result set. It works off of an array of arrays, or an array of objects. You decide which array columns or object properties to display. It does not rewrite queries or handle paging, that is up to you.

Features
--------

[](#features)

- Configurable headers
- Generates sort urls
- Uses Bootstrap table css by default
- Provided column types enable quicker development time
- Table implements ArrayAccess for easier building of tables.

Column Types
------------

[](#column-types)

GridView offers a few different column types for calculations or displaying certain data types.

- Column: default column type, supports visiblity and custom headers and filters
- CalcColumn: Pass in a closure to perform a calculation
- CheckBoxColumn: Generate a checkbox in a table cell
- DateTimeColumn: Use php's DateTime object to format date strings
- LinkColumn: generate anchor tags
- TotalColumn: sum columns and puts a total in the table footer
- ButtonColumn: useful for actions like view/edit/delete or whatever you would like. Comes with sample buttons

### Required setup

[](#required-setup)

In the `require` key of `composer.json` file add the following

```
"nsbucky/gridview": "dev-master"

```

Quick Example
-------------

[](#quick-example)

```
$dataSource = array();
for($i=0; $iuniqid(),
	            	'loop_iterator'=>$i.' times',
	            	'date'=>date('Y-m-d'),
	            	'total'=>rand(1,25)
	           	);
}

$table = new GridView\Table($dataSource);
echo $table; // renders table based on results

$table = new GridView\Table($dataSource);
$table->addViewButton('view/{uniqid}')
    ->addEditButton('edit/me')
    ->addDeleteButton('delete/it');
echo $table; // will render table based on results with some buttons in last column

// in a list view
$table = new GridView\TableList($dataSource[0]);
echo $table; // will render a 2 column table with the column headers on left

```

Longer Example
--------------

[](#longer-example)

```
$dataSource = array();
for($i=0; $iuniqid(),
	            	'loop_iterator'=>$i.' times',
	            	'date'=>date('Y-m-d'),
	            	'total'=>rand(1,25)
	           	);
}

$table = new GridView\Table($dataSource);
$table->addColumn(
	array('name'=>'uniqid') // defaults to GridView\Columns\Column
)
->addColumn(
	new GridView\Columns\LinkColumn(array(
		'url'=>'/link/to/date/{date}',
		'label'=>'Date Link'
	))
)
->addColumn(
	new GridView\Columns\Column(array(
		'name'=>'total',
		'value'=>function($data, $index) {
			return $data['total']. ' dinosaurs were eaten today'
		}
	))
)
->addColumn(
	new GridView\Columns\DateTimeColumn(array(
		'name'=>'date',
		'visible'=> (date('j') % 2)
	))
);

// or via array access
$table[] = array('name'=>'loop_iterator');

$table[] = new GridView\Columns\ButtonColumn(array(
        'buttons'=>array(
            new GridView\Buttons\ViewButton('/view'),
            new GridView\Buttons\EditButton('/edit'),
            new GridView\Buttons\DeleteButton('/delete'),
        )
    ));

echo (string) $table; // renders table

```

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

4366d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/32774749088f18fbec2f13062d79251cb780b3fc0e1103a08eaa1786d9c3a9f2?d=identicon)[nsbucky](/maintainers/nsbucky)

---

Top Contributors

[![nsbucky](https://avatars.githubusercontent.com/u/286796?v=4)](https://github.com/nsbucky "nsbucky (1 commits)")

---

Tags

gridtable

### Embed Badge

![Health badge](/badges/nsbucky-gridview/health.svg)

```
[![Health](https://phpackages.com/badges/nsbucky-gridview/health.svg)](https://phpackages.com/packages/nsbucky-gridview)
```

###  Alternatives

[desandro/masonry

Cascading grid layout library

16.7k424.4k1](/packages/desandro-masonry)[kartik-v/yii2-grid

Yii 2 GridView on steroids. Various enhancements and utilities for the Yii 2.0 GridView widget.

5576.6M179](/packages/kartik-v-yii2-grid)[codenco-dev/nova-grid-system

A Laravel Nova tool to have a grid system

80300.1k](/packages/codenco-dev-nova-grid-system)[datatables.net/datatables.net

DataTables is a plug-in for the jQuery Javascript library. It is a highly flexible tool, based upon the foundations of progressive enhancement, which will add advanced interaction controls to any HTML table. This is jQuery DataTables

56156.5k25](/packages/datatablesnet-datatablesnet)[tomshaw/electricgrid

A feature-rich Livewire package designed for projects that require dynamic, interactive data tables.

116.6k](/packages/tomshaw-electricgrid)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)