Home

Awesome

jQuery DataTables API for Laravel

Join the chat at https://gitter.im/yajra/laravel-datatables Donate Donate

Laravel 4.2|5.x|6|7|8|9|10|11 Latest Stable Version Continuous Integration Static Analysis

Total Downloads License

Laravel package for handling server-side works of DataTables jQuery Plugin via AJAX option by using Eloquent ORM, Fluent Query Builder or Collection.

use Yajra\DataTables\Facades\DataTables;

return DataTables::eloquent(User::query())->toJson();
return DataTables::query(DB::table('users'))->toJson();
return DataTables::collection(User::all())->toJson();

return DataTables::make(User::query())->toJson();
return DataTables::make(DB::table('users'))->toJson();
return DataTables::make(User::all())->toJson();

Sponsors

<table> <body> <tr> <td><img src="https://www.npmjs.com/npm-avatar/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdmF0YXJVUkwiOiJodHRwczovL3MuZ3JhdmF0YXIuY29tL2F2YXRhci9lZDQwMmM1NjY2YjJlNjUxMTIyOWE4ZjM0NDdkNWMzYT9zaXplPTEwMCZkZWZhdWx0PXJldHJvIn0.aWU-snChAWu9abJV3dtBo-iy-2v_7JAxXUN1UHL_pDQ" width="50" alt="DataTables Logo"></td> <td>A big thank you to <a href="https://editor.datatables.net">DataTables</a> for supporting this project with a free DataTables Editor license.</td> </tr> </body> </table> <table> <body> <tr> <td><img src="https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.png" width="50" alt="JetBrains Logo"></td> <td>A big thank you to <a href="https://www.jetbrains.com">JetBrains</a> for supporting this project with free open-source licenses of their IDEs.</td> </tr> </body> </table> <table> <body> <tr> <td><img src="https://i.imgur.com/zR8rsqk.png" width="100" alt="Blackfire.io Logo"></td> <td>A big thank you to <a href="https://blackfire.io/docs/introduction?utm_source=laravel-datatables&utm_medium=github_readme&utm_campaign=logo">Blackfire.io</a> for supporting this project with a free open-source license.</td> </tr> </body> </table>

Requirements

Documentations

Laravel Version Compatibility

LaravelPackage
4.2.x3.x
5.0.x6.x
5.1.x6.x
5.2.x6.x
5.3.x6.x
5.4.x7.x, 8.x
5.5.x8.x
5.6.x8.x
5.7.x8.x
5.8.x9.x
6.x9.x
7.x9.x
8.x9.x
9.x10.x
10.x10.x
11.x11.x

Quick Installation

Option 1: Install all DataTables libraries

composer require yajra/laravel-datatables:"^11"

Option 2: Install only this library

composer require yajra/laravel-datatables-oracle:"^11"

Service Provider & Facade (Optional on Laravel 5.5+)

Register the provider and facade on your config/app.php file.

'providers' => [
    ...,
    Yajra\DataTables\DataTablesServiceProvider::class,
]

'aliases' => [
    ...,
    'DataTables' => Yajra\DataTables\Facades\DataTables::class,
]

Configuration (Optional)

php artisan vendor:publish --provider="Yajra\DataTables\DataTablesServiceProvider"

And that's it! Start building out some awesome DataTables!

Debugging Mode

To enable debugging mode, just set APP_DEBUG=true and the package will include the queries and inputs used when processing the table.

[!IMPORTANT] Please ensure that the APP_DEBUG config is set to false when your app is in production.

PHP ARTISAN SERVE BUG

Please avoid using php artisan serve when developing the package. There are known bugs when using this where Laravel randomly returns a redirect and 401 (Unauthorized) if the route requires authentication and a 404 NotFoundHttpException on valid routes.

It is advised to use Homestead or Valet when working with the package.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security-related issues, please email aqangeles@gmail.com instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.