replaceState(string $stateName, StateInterface $newState)

Replace the default state by the custom object state that we are adding as an input.


$exportState = new MyCustomExportState($crud);
$crud->replaceState('Export', $exportState);

A most common use of this state is on export, where we would like to have a different export way for your data. The below example still uses the queries from Zend Db calls but you can literally use your own libraries even for database calls (e.g. when we have more than 10.000 rows).

Step 1. Make sure that you have installed a PHP library for exporting to a spreadsheet. For example in my case i am using composer and I've wrote the below command line in my console:

composer require mk-j/php_xlsxwriter

Step 2. Create a custom State that will implement the GroceryCrud\Core\State\StateInterface (required). We have a complete example by using the php_xlswriter library below:

namespace MyCustomStates;

use GroceryCrud\Core\GroceryCrud as GCrud;
use GroceryCrud\Core\State\StateInterface;
use GroceryCrud\Core\State\ExportState as GcExportState;

class ExportState implements StateInterface {

    protected $exportStateObject;
    protected $gCrud;

     * DatagridState constructor.
     * @param \GroceryCrud\Core\GroceryCrud $gCrud
     * @throws \GroceryCrud\Core\Exceptions\Exception
    function __construct(GCrud $gCrud)
        $this->gCrud = $gCrud;
        $this->exportStateObject = new GcExportState($gCrud);


        // Please have in mind that our new limitation is 10.000 as we've tested and checked that the database
        // memory has some limitations with Zend db when we are calling more than 10.000 rows and send all of
        // our results.

    public function render() {
        // As this is a custom file and you can literaly do whatever you wish, if the queries are not optimized for your
        // needs (e.g. the 10.000 rows are too little) then you can use the function:
        // $this->exportStateObject->getStateParameters(); and create your own queries with your way to export data to
        // excel (e.g. you don't have to use the getFinalData if it doesn't fit your needs)
        $output = $this->exportStateObject->getFinalData();

        $results = $output->data;
        $columns = $output->columns;

        // Use your own folder that you have all the exported spreadsheets. In our example we are 
        // using "export/" (have in mind that I am not adding the slash at the end)
        $temporaryFolderPath = 'export';

        $this->exportToExcelWithXlsWriter($results, $columns, $temporaryFolderPath);


    public function exportToExcelWithXlsWriter($results, $columns, $temporaryFolderPath) {

        $header  = [];

        foreach ($columns as $column) {
            $header[] = $column->displayAs;

        $data = [

        foreach ($results as $row) {
            $tmp_row = [];
            foreach ($columns as $column) {
                $tmp_row[] = $row[$column->name];

            $data[] = $tmp_row;

        $subjectPlural = $this->gCrud->getSubjectPlural();

        $filename = !empty($subjectPlural) ? $subjectPlural : 'Spreadsheet';
        $filename .= '_' . date('Y-m-d');

        $filePath = $temporaryFolderPath. '/' . $filename . '_' . uniqid() .'.xlsx';

        $writer = new \XLSXWriter();

        // WARNING! This is just an example of a way to export an excel file without running out of memory
        // Before using this redirection with a public access please make sure that you understand the security risks
        // and that you have cronjobs to remove older spreadsheets or else this could drive you to a security and
        // privacy breach
        header('Location:' . $filePath);


Step 3. Include the PHP library into your CRUD by adding at the beginning of your file (e.g. Controller if we are talking about Codeigniter):

// states is the folder that I have all my custom states

// It is better to use namespaces so it will not be conflicted with other libraries
use MyCustomStates\ExportState;

Step 4. Lastly, let's replace our default ExportState with our custom one. Please have in mind that the library is completely replacing the default one so if you are going to use this you will also need to make sure that you have validated the input data:

// ExportState is from MyCustomStates\ExportState
$exportState = new ExportState($crud);
$crud->replaceState('Export', $exportState);

For security reasons we don't have a demo of the above replacement as it may impact the bandwidth limitations of the website. The current example works fine for 10.000 rows but you can go further than that by also replacing the database queries and use your custom queries by also using the framework default database connection (e.g. For Codeigniter you can use Models)