php/yii2
1
0
Fork 0
mirror of https://github.com/yiisoft/yii2.git synced 2025-11-02 04:37:42 +08:00
Code Issues Packages Projects Releases Wiki Activity

Improved explanation in start-database.md (#17748) [skip ci]

Browse Source
This commit is contained in:
Nisuga Jayawardana
2020-01-10 14:48:18 +05:30
committed by Alexander Makarov
parent f226c3cb38
commit ad83952197
1 changed files with 7 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
docs/guide/start-databases.md
View File

@ -178,16 +178,19 @@ class CountryController extends Controller
Save the above code in the file `controllers/CountryController.php`.
The `index` action calls `Country::find()`. This Active Record method builds a DB query that can be used to retrieve all of the data from the `country` table.
To limit the number of countries returned in each request, the query is paginated with the help of a
First, The `index` action calls `Country::find()`. This [find()](https://www.yiiframework.com/doc/api/2.0/yii-db-activerecord#find()-detail) method creates a [ActiveQuery](https://www.yiiframework.com/doc/api/2.0/yii-db-activequery) query object, which provides methods to access data from the `country` table.
To limit the number of countries returned in each request, the query object is paginated with the help of a
[[yii\data\Pagination]] object. The `Pagination` object serves two purposes:
* Sets the `offset` and `limit` clauses for the SQL statement represented by the query so that it only
* Sets the `offset` and `limit` clauses for the SQL statement represented by the query object so that it only
returns a single page of data at a time (at most 5 rows in a page).
* It's used in the view to display a pager consisting of a list of page buttons, as will be explained in
the next subsection.
Next, [all()](https://www.yiiframework.com/doc/api/2.0/yii-db-activequery#all()-detail) returns all `country` records based on the query results.
At the end of the code, the `index` action renders a view named `index`, and passes the country data as well as the pagination
At the end of the code, the `index` action renders a view named `index`, and passes the returned country data as well as the pagination
information to it.