Cakephp中自定义查询的分页问题，解决方法

最新推荐文章于 2021-03-28 18:31:17 发布

转载最新推荐文章于 2021-03-28 18:31:17 发布 · 3.5k 阅读

文章标签：

#cakephp #user #date #join #null #function

php 专栏收录该内容

22 篇文章

订阅专栏

本文介绍如何在CakePHP中实现复杂的自定义分页功能，包括联合查询分页及数据统计，通过创建额外模型来支持特定需求。

Cakephp的默认分页功能是基于内置的表关联模型的，所以，如果我们有更多复杂的要求，比如：

联合两张表的查询分页

这样Cakephp的默认分页就达不到我们的要求，解决的方法是：

使用自定义的查询分页

使用自定义查询分页需要在模型中重载两个方法，paginate()和paginateCount()

1. paginate()

提供分页的数据支持，原型如下：

   1. 
   function paginate( $conditions ,  $fields ,  $order ,  $limit ,  $page = 1,  $recursive = null);   
  

参数由Cakephp自定传递，使用方法和find方法是一样的，参数通过在Controller中定义paginate变量传递，例如：

   1. 
   $limit = 5;   
  
   2. 
   $this ->paginate =  array (   
  
   3. 
        'SavedNote' => compact( 'limit' )   
  
   4. 
   );

注意：

如果重载paginate()的函数使用参数，请自己格式化参数为自己定义的格式，Cakephp不会自动格式化参数。

2. paginateCount()

提供分页的数据数量统计支持，原型如下：

   1. 
   function paginateCount( $conditions = null,  $recursive = 0);   
  

带来的问题

通过上述的方法确实能够给我们的自定义查询分页，但是问题是，这样做之后我们无法再使用原有的模型的分页。

解决方法：

使用额外的模型完成我们的自定义查询任务

我们新建一个模型，/models/saved_note.php ，代码如下：

   01. 
   <?php   
  
   02. 
   class SavedNote  extends AppModel {   
  
   03. 
        var $name =  'SavedNote' ;   
  
   04. 
      
   05. 
        //这个模型不使用任何表，它仅仅为我们提供自定义分页支持   
  
   06. 
        var $useTable = false;   
  
   07. 
        var $user_id = 0;   
  
   08. 
      
   09. 
        /*   
  
   10. 
         * Paginate Function   
  
   11. 
        */   
  
   12. 
        function paginate( $conditions ,  $fields ,  $order ,  $limit ,  $page = 1,  $recursive = null) {   
  
   13. 
            $offset = ((int) $page - 1) * (int) $limit ;   
  
   14. 
            $conditions = "   
  
   15. 
            //这里省略的SQL会在附录中列出   
  
   16. 
            ";   
  
   17. 
            return $this ->query( $conditions );   
  
   18. 
        }   
  
   19. 
      
   20. 
        /*   
  
   21. 
         * Paginate Count Function   
  
   22. 
        */   
  
   23. 
        function paginateCount( $conditions = null,  $recursive = 0) {   
  
   24. 
            $conditions = "   
  
   25. 
            //这里省略的SQL会在附录中列出   
  
   26. 
            ";   
  
   27. 
            $result =  $this ->query( $conditions );   
  
   28. 
            return (int) $result [0][0][ 'NUMS' ];   
  
   29. 
        }   
  
   30. 
   }   
  
   31. 
   ?>

我们可以在控制器中使用这个自定义查询了：

   01. 
   class NotesController  extends AppController{   
  
   02. 
        var $name =  'Notes' ;   
  
   03. 
        var $layout =  'notes' ;   
  
   04. 
      
   05. 
        //这里引入我们需要的模型   
  
   06. 
        var $uses =  array ( 'Note' , 'SavedNote' , 'TrashNote' );   
  
   07. 
      
   08. 
        function saved(){   
  
   09. 
            $user_id =  $this ->Auth->User( 'id' );   
  
   10. 
            $limit = 5;   
  
   11. 
      
   12. 
            //这里为我们的自定义查询，传递一些参数   
  
   13. 
            $this ->paginate =  array (   
  
   14. 
                'SavedNote' => compact( 'limit' )   
  
   15. 
            );   
  
   16. 
            $this ->SavedNote->user_id =  $user_id ;   
  
   17. 
      
   18. 
            //控制器的paginate方法，会自定寻找模型的相应方法，并调用   
  
   19. 
            $notes =  $this ->paginate( 'SavedNote' );   
  
   20. 
            $this ->set(compact( 'notes' ));   
  
   21. 
        }   
  
   22. 
      
   23. 
   }

最后，希望大家看到的是，自定义模型中的paginate参数的使用是需要自己手动解析和分配的，如果要使用Cakephp的默认查询样式，还需要自己解析一下。

附录：

1. 模型中paginate方法用到的SQL

   01. 
   SELECT   
  
   02. 
        DISTINCT (SavedNote.note_id),   
  
   03. 
        SavedNote.*,   
  
   04. 
        Note.subject,   
  
   05. 
        Note.body,   
  
   06. 
        Note.created,   
  
   07. 
        SentUser. name ,   
  
   08. 
        ReceivedUser. name   
  
   09. 
   FROM (   
  
   10. 
        SELECT   
  
   11. 
            ReceivedNote.note_id  AS note_id,   
  
   12. 
            ReceivedNote.receive_user_id  AS receive_user_id,   
  
   13. 
            ReceivedNote.send_user_id  AS send_user_id,   
  
   14. 
            ReceivedNote.is_deleted  AS is_deleted,   
  
   15. 
            ReceivedNote.is_saved  AS is_saved,   
  
   16. 
            ReceivedNote.read_date  AS read_date,   
  
   17. 
            'received' as src   
  
   18. 
        FROM   
  
   19. 
            received_notes  AS ReceivedNote   
  
   20. 
        WHERE   
  
   21. 
            receive_user_id = {$this->user_id}   
  
   22. 
        UNION ALL   
  
   23. 
        SELECT   
  
   24. 
            SentNote.note_id  AS note_id,   
  
   25. 
            SentNote.receive_user_id  AS receive_user_id,   
  
   26. 
            SentNote.send_user_id  AS send_user_id,   
  
   27. 
            SentNote.is_deleted  AS is_deleted,   
  
   28. 
            SentNote.is_saved  AS is_deleted,   
  
   29. 
            SentNote.read_date  AS read_date,   
  
   30. 
            'sent' as src   
  
   31. 
        FROM   
  
   32. 
            sent_notes  AS SentNote   
  
   33. 
        WHERE   
  
   34. 
            send_user_id = {$this->user_id}   
  
   35. 
   )  as SavedNote   
  
   36. 
   LEFT JOIN notes  AS Note  ON Note.id = SavedNote.note_id   
  
   37. 
   LEFT JOIN users  AS SentUser  ON SentUser.id = SavedNote.send_user_id   
  
   38. 
   LEFT JOIN users  AS ReceivedUser  ON ReceivedUser.id = SavedNote.receive_user_id   
  
   39. 
   WHERE   
  
   40. 
   SavedNote.is_saved = 1   
  
   41. 
   ORDER BY   
  
   42. 
   Note.created  DESC   
  
   43. 
   LIMIT {$offset},{$limit}

2. 模型中paginateCount方法用到的SQL

   01. 
   SELECT   
  
   02. 
        COUNT ( DISTINCT (SavedNote.note_id))  AS NUMS   
  
   03. 
   FROM (   
  
   04. 
        SELECT   
  
   05. 
            ReceivedNote.note_id  AS note_id,   
  
   06. 
            ReceivedNote.receive_user_id  AS receive_user_id,   
  
   07. 
            ReceivedNote.send_user_id  AS send_user_id,   
  
   08. 
            ReceivedNote.is_saved  AS is_saved,   
  
   09. 
            'received' as src   
  
   10. 
        FROM   
  
   11. 
            received_notes  AS ReceivedNote   
  
   12. 
        WHERE   
  
   13. 
            receive_user_id = {$this->user_id}   
  
   14. 
        UNION ALL   
  
   15. 
        SELECT   
  
   16. 
            SentNote.note_id  AS note_id,   
  
   17. 
            SentNote.receive_user_id  AS receive_user_id,   
  
   18. 
            SentNote.send_user_id  AS send_user_id,   
  
   19. 
            SentNote.is_saved  AS is_saved,   
  
   20. 
            'received' as src   
  
   21. 
        FROM   
  
   22. 
            sent_notes  AS SentNote   
  
   23. 
        WHERE   
  
   24. 
            send_user_id = {$this->user_id}   
  
   25. 
   )  as SavedNote   
  
   26. 
   WHERE   
  
   27. 
   SavedNote.is_saved = 1