datatablesダウンロード - datatablesソースコードのダウンロード

datatables

その他のカテゴリー

2.3.16

ダウンロード

PHP 用のdatatablesライブラリ

当社の超高速 PHP ライブラリを使用してdatatablesサーバー側処理を簡単に簡素化し、ワークフローをシームレスに合理化します。ライブデモ

特徴

使いやすい。わずか数行のコードを使用して json を生成します。
クロージャ機能を備えた編集可能な列。
カスタムフィルターをサポートします。
ほとんどの複雑なクエリを処理できます。
ネイティブ PHP の mysql と sqlite をサポートします。
対応機種:
- ララベル
- コードイグナイター 3
- コードイグナイター 4
- ファルコン 3+
- プレスタショップ
- PostgreSql

インストール

注:バージョン 2.0 以降には php 7.1.3 以降が必要です (php でサポートされているバージョン)

ライブラリをインストールする推奨方法は Composer を使用することです

Composer の使用をまだ始めていない場合は、使用することを強くお勧めします。

次の情報を含む、 composer.jsonという名前のファイルをプロジェクトのルートに置きます。

datatables": "2.*" } }">

 {
    "require": {
       "ozdemir/ datatables ": "2.*"
    }
}

そして、次を実行します。

 composer install

または単に実行します:

 composer require ozdemir/ datatables

オートローダーをプロジェクトに追加します。

    <?php

    require_once ' vendor/autoload.php ' ;

これで、 datatables php ライブラリの使用を開始する準備が整いました。

datatables ; use Ozdemir datatables DBMySQL; $config = [ 'host' => 'localhost', 'port' => '3306', 'username' => 'homestead', 'password' => 'secret', 'database' => 'sakila' ]; $dt = new datatables ( new MySQL($config) ); $dt->query('Select film_id, title, description from film'); echo $dt->generate();">

    <?php
    require_once ' vendor/autoload.php ' ;

    use Ozdemir  datatables  datatables ;
    use Ozdemir  datatables  DB  MySQL ;

    $ config = [ ' host '     => ' localhost ' ,
                ' port '     => ' 3306 ' ,
                ' username ' => ' homestead ' ,
                ' password ' => ' secret ' ,
                ' database ' => ' sakila ' ];

    $ dt = new datatables ( new MySQL ( $ config ) );

    $ dt -> query ( ' Select film_id, title, description from film ' );

    echo $ dt -> generate ();

codeigniter や laravel などの php フレームワークを使用している場合は、関連するデータベースアダプターを使用できます。

datatables ; use Ozdemir datatables DBCodeigniter4Adapter; class Home extends BaseController { public function index() { return view('index'); } public function ajax() { // CI 4 builder class $db = Database::connect(); $builder = $db->table('Track'); $builder->select('TrackId, Name, UnitPrice'); // datatables Php Library $ datatables = new datatables (new Codeigniter4Adapter); // using CI4 Builder $ datatables ->query($builder); // alternatively plain sql // $ datatables ->query('Select TrackId, Name, UnitPrice from Track'); return $this->response->setJSON($ datatables ->generate()->toJson()); } }">

 // Codeigniter 4 Example

<?php

namespace App  Controllers ;

use Config  Database ;
use Ozdemir  datatables  datatables ;
use Ozdemir  datatables  DB  Codeigniter4Adapter ;

class Home extends BaseController
{
    public function index ()
    {
        return view ( ' index ' );
    }

    public function ajax ()
    {
        // CI 4 builder class
        $ db = Database:: connect ();

        $ builder = $ db -> table ( ' Track ' );
        $ builder -> select ( ' TrackId, Name, UnitPrice ' );

        // datatables Php Library
        $ datatables = new datatables ( new Codeigniter4Adapter );

        // using CI4 Builder
        $ datatables -> query ( $ builder );

        // alternatively plain sql
        // $ datatables ->query('Select TrackId, Name, UnitPrice from Track');

        return $ this -> response -> setJSON ( $ datatables -> generate ()-> toJson ());
    }
}

datatables ; use Ozdemir datatables DBLaravelAdapter; Route::get('/ajax/laravel', function () { $dt = new datatables (new LaravelAdapter); $dt->query( Track::query() ->select([ 'TrackId', 'Track.Name', 'Title as Album', 'MediaType.Name as MediaType', 'UnitPrice', 'Milliseconds', 'Bytes', ]) ->join('Album', 'Album.AlbumId', 'Track.AlbumId') ->join('MediaType', 'MediaType.MediaTypeId', 'Track.MediaTypeId') ); // same as the previous example, sql statement can be used. return $dt->generate(); }); ">

 // Laravel Example

<?php
// routes/web.php 

use Ozdemir  datatables  datatables ;
use Ozdemir  datatables  DB  LaravelAdapter ;

Route:: get ( ' /ajax/laravel ' , function () {

    $ dt = new datatables ( new LaravelAdapter );

    $ dt -> query (
      Track:: query ()
          -> select ([
              ' TrackId ' ,
              ' Track.Name ' ,
              ' Title as Album ' ,
              ' MediaType.Name as MediaType ' ,
              ' UnitPrice ' ,
              ' Milliseconds ' ,
              ' Bytes ' ,
          ])
          -> join ( ' Album ' , ' Album.AlbumId ' , ' Track.AlbumId ' )
          -> join ( ' MediaType ' , ' MediaType.MediaTypeId ' , ' Track.MediaTypeId ' )
    ); // same as the previous example, sql statement can be used.

    return $ dt -> generate ();
});

メソッド

これは、利用可能なパブリックメソッドのリストです。

クエリ($query)が必要です

SQLクエリを設定します

生成()が必要です

クエリを実行して出力を構築します
出力を json として返します
generate()->toJson() と同じ

toJson()

出力を json として返します
Generate() の後に呼び出す必要があります

toArray()

出力を配列として返します
Generate() の後に呼び出す必要があります

add($column, function( $row ){})

カスタム使用のために追加の列を追加します

edit($column, function($row){})

列の編集が可能

フィルター($column, function(){})

カスタムフィルタリングが可能
以下のメソッドがあります
- エスケープ($値)
- 検索値()
- デフォルトフィルター()
- 間($low, $high)
- whereIn($array)
- より大きい($値)
- 未満($value)

非表示($column)

出力から列を削除します
add() メソッドまたは edit() メソッドでのみデータを使用する必要がある場合に便利です。

setDistinctResponseFrom($column)

指定された列名でクエリを実行し、返されたデータを uniqueData キーを使用して出力に追加します。

setDistinctResponse($output)

指定されたデータを、distinctData キーを使用して出力に追加します。

getColumns()

列名を返します (開発目的)

getQuery()

ライブラリによって作成された SQL クエリ文字列を返します (開発目的)

例

datatables ; use Ozdemir datatables DBSQLite; $path = __DIR__ . '/../path/to/database.db'; $dt = new datatables ( new SQLite($path) ); $dt->query('Select id, name, email, age, address, plevel from users'); $dt->edit('id', function($data){ // return a link. return "<a href='user.php?id=" . $data['id'] . "'>edit</a>"; }); $dt->edit('email', function($data){ // masks email : [email protected] => m***@mail.com return preg_replace('/(?<=.).(?=.*@)/u','*', $data['email']); }); $dt->edit('address', function($data){ // checks user access. $current_user_plevel = 4; if ($current_user_plevel > 2 && $current_user_plevel > $data['plevel']) { return $data['address']; } return 'you are not authorized to view this column'; }); $dt->hide('plevel'); // hides 'plevel' column from the output $dt->add('action', function($data){ // returns a link in a new column return "<a href='user.php?id=" . $data['id'] . "'>edit</a>"; }); $dt->filter('age', function (){ // applies custom filtering. return $this->between(15, 30); }); echo $dt->generate()->toJson(); // same as 'echo $dt->generate()';">

    <?php
    require_once ' vendor/autoload.php ' ;

    use Ozdemir  datatables  datatables ;
    use Ozdemir  datatables  DB  SQLite ;

    $ path = __DIR__ . ' /../path/to/database.db ' ;
    $ dt = new datatables ( new SQLite ( $ path ) );

    $ dt -> query ( ' Select id, name, email, age, address, plevel from users ' );

    $ dt -> edit ( ' id ' , function ( $ data ){
        // return a link.
        return " <a href='user.php?id= " . $ data [ ' id ' ] . " '>edit</a> " ;
    });

    $ dt -> edit ( ' email ' , function ( $ data ){
        // masks email : [email protected] => m***@mail.com
        return preg_replace ( ' /(?<=.).(?=.*@)/u ' , ' * ' , $ data [ ' email ' ]);
    });

    $ dt -> edit ( ' address ' , function ( $ data ){
        // checks user access.
        $ current_user_plevel = 4 ;
        if ( $ current_user_plevel > 2 && $ current_user_plevel > $ data [ ' plevel ' ]) {
            return $ data [ ' address ' ];
        }

        return ' you are not authorized to view this column ' ;
    });
    
    $ dt -> hide ( ' plevel ' ); // hides 'plevel' column from the output

    $ dt -> add ( ' action ' , function ( $ data ){
        // returns a link in a new column
        return " <a href='user.php?id= " . $ data [ ' id ' ] . " '>edit</a> " ;
    });

    $ dt -> filter ( ' age ' , function (){
        // applies custom filtering.
        return $ this -> between ( 15 , 30 );
    });

    echo $ dt -> generate ()-> toJson (); // same as 'echo $dt->generate()';