Documentation
Server Side Filtering with jqxGrid using PHP and MySQL
This help topic shows how to implement server-side filtering with the jqxGrid widget. The Grid will request data from the server when the user applies a new filter or clears the filtering. The server-side script is going to deliver the data records in JSON format depending on the filter expression. We will obtain the data from Northwind Database and especially from the Orders table. You can download the Northwind database .sql script here and run it into MySQL to create the database. You can download the Northwind database .sql script here and run it into MySQL to create the database. The first thing we need to do is create the file we’ll connect with. We’ll call this file connect.php<?php# FileName="connect.php"$hostname = "localhost";$database = "northwind";$username = "root";$password = "";?>
<?php #Include the connect.php file include ('connect.php');// Connect to the database$mysqli = new mysqli($hostname, $username, $password, $database);/* check connection */if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); }$query = "SELECT OrderDate, ShippedDate, ShipName, ShipAddress, ShipCity, ShipCountry FROM Orders";$result = $mysqli->prepare($query);// filter data.if (isset($_GET['filterscount'])) { $filterscount = $_GET['filterscount']; if ($filterscount > 0) { $where = " WHERE ("; $tmpdatafield = ""; $tmpfilteroperator = ""; $valuesPrep = ""; $values = []; for ($i = 0; $i < $filterscount; $i++) { // get the filter's value. $filtervalue = $_GET["filtervalue" . $i]; // get the filter's condition. $filtercondition = $_GET["filtercondition" . $i]; // get the filter's column. $filterdatafield = $_GET["filterdatafield" . $i]; // get the filter's operator. $filteroperator = $_GET["filteroperator" . $i]; if ($tmpdatafield == "") { $tmpdatafield = $filterdatafield; } else if ($tmpdatafield <> $filterdatafield) { $where.= ")AND("; } else if ($tmpdatafield == $filterdatafield) { if ($tmpfilteroperator == 0) { $where.= " AND "; } else $where.= " OR "; } // build the "WHERE" clause depending on the filter's condition, value and datafield. switch ($filtercondition) { case "CONTAINS": $condition = " LIKE "; $value = "%{$filtervalue}%"; break; case "DOES_NOT_CONTAIN": $condition = " NOT LIKE "; $value = "%{$filtervalue}%"; break; case "EQUAL": $condition = " = "; $value = $filtervalue; break; case "NOT_EQUAL": $condition = " <> "; $value = $filtervalue; break; case "GREATER_THAN": $condition = " > "; $value = $filtervalue; break; case "LESS_THAN": $condition = " < "; $value = $filtervalue; break; case "GREATER_THAN_OR_EQUAL": $condition = " >= "; $value = $filtervalue; break; case "LESS_THAN_OR_EQUAL": $condition = " <= "; $value = $filtervalue; break; case "STARTS_WITH": $condition = " LIKE "; $value = "{$filtervalue}%"; break; case "ENDS_WITH": $condition = " LIKE "; $value = "%{$filtervalue}"; break; case "NULL": $condition = " IS NULL "; $value = "%{$filtervalue}%"; break; case "NOT_NULL": $condition = " IS NOT NULL "; $value = "%{$filtervalue}%"; break; } $where.= " " . $filterdatafield . $condition . "? "; $valuesPrep = $valuesPrep . "s"; $values[] = & $value; if ($i == $filterscount - 1) { $where.= ")"; } $tmpfilteroperator = $filteroperator; $tmpdatafield = $filterdatafield; } // build the query. $query = "SELECT OrderDate, ShippedDate, ShipName, ShipAddress, ShipCity, ShipCountry FROM Orders" . $where; $result = $mysqli->prepare($query); call_user_func_array(array( $result, "bind_param" ) , array_merge(array( $valuesPrep ) , $values)); } }$result->execute();/* bind result variables */$result->bind_result($OrderDate, $ShippedDate, $ShipName, $ShipAddress, $ShipCity, $ShipCountry);/* fetch values */while ($result->fetch()) { $orders[] = array( 'OrderDate' => $OrderDate, 'ShippedDate' => $ShippedDate, 'ShipName' => $ShipName, 'ShipAddress' => $ShipAddress, 'ShipCity' => $ShipCity, 'ShipCountry' => $ShipCountry ); }echo json_encode($orders);/* close statement */$result->close();/* close connection */$mysqli->close();?>
- sortdatafield - the sort column's datafield.
- sortorder - the sort order - 'asc', 'desc' or ''
- pagenum - the current page's number when the paging feature is enabled.
- pagesize - the page's size which represents the number of rows displayed in the view.
- groupscount - the number of groups in the Grid
- group - the group's name. The group's name for the first group is 'group0', for the second group is 'group1' and so on.
- filterscount - the number of filters applied to the Grid
- filtervalue - the filter's value. The filtervalue name for the first filter is "filtervalue0", for the second filter is "filtervalue1" and so on.
- filtercondition - the filter's condition. The condition can be any of these: "CONTAINS", "DOES_NOT_CONTAIN", "EQUAL", "EQUAL_CASE_SENSITIVE", NOT_EQUAL","GREATER_THAN", "GREATER_THAN_OR_EQUAL", "LESS_THAN", "LESS_THAN_OR_EQUAL", "STARTS_WITH", "STARTS_WITH_CASE_SENSITIVE", "ENDS_WITH", "ENDS_WITH_CASE_SENSITIVE", "NULL", "NOT_NULL", "EMPTY", "NOT_EMPTY"
- filterdatafield - the filter column's datafield
- filteroperator - the filter's operator - 0 for "AND" and 1 for "OR"
The following code gets the value of the filter with index i.
$filtervalue = $_GET["filtervalue" . $i];
The following code gets the condition('Contains', 'Starts With', etc.) of the current filter.
$filtercondition = $_GET["filtercondition" . $i];
The current filter's column is stored in the 'filterdatafield' property.
$filterdatafield = $_GET["filterdatafield" . $i];
The filter operator specifies the relation of the current filter with the filters from the same column. Its value can be 0 for "AND" and 1 for "OR".
For example, if you have multiple filters applied to the same column the filter expression could mean the following ( filter all records in the 'First Name' column that start with 'a' and end with 'b'). The 'and' keyword is the filter operator.
$filteroperator = $_GET["filteroperator" . $i];
Depending on the value of the $filtercondition property, we build the query's WHERE clause.
The last step is to initialize the Grid. In order to enable the filtering, we need to reference the jqxgrid.filter.js and to set the Grid's filterable property to true. In the source object's initialization we override the built-in filtering by setting the filter member to a custom function. That function is called when the user changes the filtering expression by adding or removing a filter. In the filter function's implementation, we call the Grid's 'updatebounddata' method which makes a request to the server and passes the filtering parameters.
<!DOCTYPE html><html lang="en"><head> <link rel="stylesheet" href="../jqwidgets/styles/jqx.base.css" type="text/css" /> <link rel="stylesheet" href="../jqwidgets/styles/jqx.classic.css" type="text/css" /> <meta name="viewport" content="width=device-width, initial-scale=1"> <script type="text/javascript" src="../jquery-1.11.1.min.js"></script> <script type="text/javascript" src="../jqwidgets/jqxcore.js"></script> <script type="text/javascript" src="../jqwidgets/jqxbuttons.js"></script> <script type="text/javascript" src="../jqwidgets/jqxscrollbar.js"></script> <script type="text/javascript" src="../jqwidgets/jqxmenu.js"></script> <script type="text/javascript" src="../jqwidgets/jqxgrid.js"></script> <script type="text/javascript" src="../jqwidgets/jqxgrid.selection.js"></script> <script type="text/javascript" src="../jqwidgets/jqxgrid.filter.js"></script> <script type="text/javascript" src="../jqwidgets/jqxdata.js"></script> <script type="text/javascript" src="../jqwidgets/jqxlistbox.js"></script> <script type="text/javascript" src="../jqwidgets/jqxdropdownlist.js"></script> <script type="text/javascript"> $(document).ready(function () { // prepare the data var theme = 'classic'; var source = { datatype: "json", datafields: [ { name: 'ShippedDate', type: 'date' }, { name: 'ShipName' }, { name: 'ShipAddress' }, { name: 'ShipCity' }, { name: 'ShipCountry' } ], url: 'data.php', filter: function () { // update the grid and send a request to the server. $("#jqxgrid").jqxGrid('updatebounddata', 'filter'); } }; var dataAdapter = new $.jqx.dataAdapter(source); // initialize jqxGrid $("#jqxgrid").jqxGrid( { source: dataAdapter, theme: theme, filterable: true, columns: [ { text: 'Shipped Date', datafield: 'ShippedDate', cellsformat: 'd', width: 200 }, { text: 'Ship Name', datafield: 'ShipName', width: 200 }, { text: 'Address', datafield: 'ShipAddress', width: 180 }, { text: 'City', datafield: 'ShipCity', width: 100 }, { text: 'Country', datafield: 'ShipCountry', width: 140 } ] }); }); </script><script async src="https://www.googletagmanager.com/gtag/js?id=G-2FX5PV9DNT"></script><script>window.dataLayer = window.dataLayer || [];function gtag(){dataLayer.push(arguments);}gtag('js', new Date());gtag('config', 'G-2FX5PV9DNT');</script></head><body class='default'> <div id="jqxgrid"></div></body></html>