mirror of
https://github.com/yiisoft/yii2.git
synced 2025-11-01 11:39:41 +08:00
Updates pt-BR translation (#17105) [skip ci]
This commit is contained in:
Sidney Lins
committed by
Alexander Makarov
Alexander Makarov
parent
c776cf6240
commit
fe3ae964cd
@ -1,102 +1,101 @@
|
||||
Trabalhando com Bancos de Dados
|
||||
===============================
|
||||
|
||||
Esta seção descreverá como criar uma nova página que exibe dados de países
|
||||
buscados de uma tabela do banco de dados chamada `country`. Para isso, você
|
||||
Esta seção descreverá como criar uma nova página que exibe informações de países obtidos de uma tabela de banco de dados chamada `pais`. Para isso, você
|
||||
configurará uma conexão com o banco de dados, criará uma classe de
|
||||
[Active Record](db-active-record.md), definirá uma [action](structure-controllers.md) (ação),
|
||||
e criará uma [view](structure-views.md) (visão).
|
||||
[Active Record](db-active-record.md), definirá uma [action](structure-controllers.md) e criará uma [view](structure-views.md).
|
||||
|
||||
Através deste tutorial, você aprenderá como:
|
||||
Ao longo deste tutorial, você aprenderá como:
|
||||
|
||||
* Configurar uma conexão de BD
|
||||
* Definir uma classe de Active Record
|
||||
* Consultar dados usando a classe de Active Record
|
||||
* Exibir dados em uma view de forma paginada
|
||||
* configurar uma conexão de BD
|
||||
* definir uma classe Active Record
|
||||
* consultar dados usando a classe de Active Record
|
||||
* exibir dados em uma view de forma paginada
|
||||
|
||||
Perceba que para terminar essa seção, você deve ter conhecimento e experiência
|
||||
básica usando bancos de dados. Em particular, você deveria saber como criar um
|
||||
banco de dados, e como executar instruções SQL usando uma ferramenta de cliente
|
||||
de BD.
|
||||
básicos em bancos de dados. Em particular, você deve saber como criar um banco de dados e como executar instruções SQL usando uma ferramenta cliente de bancos de dados.
|
||||
|
||||
|
||||
Preparando o Banco de Dados <span id="preparing-database"></span>
|
||||
---------------------------
|
||||
|
||||
Para começar, crie um banco de dados chamado `yii2basic`, a partir do qual você
|
||||
buscará os dados em sua aplicação. Você pode criar um banco de dados SQLite, MySQL,
|
||||
PostgreSQL, MSSQL ou Oracle, já que o Yii tem suporte embutido a muitas aplicações
|
||||
de bancos de dados. Por questões de simplicidade, será assumido o uso do MySQL
|
||||
Para começar, crie um banco de dados chamado `yii2basico`, de onde você
|
||||
obterá os dados em sua aplicação. Você pode criar um banco de dados SQLite, MySQL,
|
||||
PostgreSQL, MSSQL ou Oracle, já que o Yii tem suporte embutido a vários gerenciadores de bancos de dados. Por questões de simplicidade, será assumido o uso do MySQL
|
||||
na descrição a seguir.
|
||||
|
||||
Em seguida, crie uma tabela chamada `country` no banco de dados, e insira alguns
|
||||
dados de exemplo. Você pode rodar as seguintes declarações SQL para fazê-lo:
|
||||
> Info: O MariaDB costumava ser um substituto transparente do MySQL. Isto já não é mais totalmente verdade. Caso você queira usar recursos avançados como suporte a `JSON` no MariaDB, por favor, consulte a extensão do MariaDB listada mais à frente.
|
||||
|
||||
Em seguida, crie uma tabela chamada `pais` no banco de dados e insira alguns
|
||||
dados de exemplo. Você pode rodar as seguintes declarações SQL para fazer isso:
|
||||
|
||||
```sql
|
||||
CREATE TABLE `country` (
|
||||
`code` CHAR(2) NOT NULL PRIMARY KEY,
|
||||
`name` CHAR(52) NOT NULL,
|
||||
`population` INT(11) NOT NULL DEFAULT '0'
|
||||
CREATE TABLE `pais` (
|
||||
`codigo` CHAR(2) NOT NULL PRIMARY KEY,
|
||||
`nome` CHAR(52) NOT NULL,
|
||||
`populacao` INT(11) NOT NULL DEFAULT '0'
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
|
||||
|
||||
INSERT INTO `country` VALUES ('AU','Australia',24016400);
|
||||
INSERT INTO `country` VALUES ('BR','Brazil',205722000);
|
||||
INSERT INTO `country` VALUES ('CA','Canada',35985751);
|
||||
INSERT INTO `country` VALUES ('CN','China',1375210000);
|
||||
INSERT INTO `country` VALUES ('DE','Germany',81459000);
|
||||
INSERT INTO `country` VALUES ('FR','France',64513242);
|
||||
INSERT INTO `country` VALUES ('GB','United Kingdom',65097000);
|
||||
INSERT INTO `country` VALUES ('IN','India',1285400000);
|
||||
INSERT INTO `country` VALUES ('RU','Russia',146519759);
|
||||
INSERT INTO `country` VALUES ('US','United States',322976000);
|
||||
INSERT INTO `pais` VALUES ('AU','Austrália',24016400);
|
||||
INSERT INTO `pais` VALUES ('BR','Brasil',205722000);
|
||||
INSERT INTO `pais` VALUES ('CA','Canadá',35985751);
|
||||
INSERT INTO `pais` VALUES ('CN','China',1375210000);
|
||||
INSERT INTO `pais` VALUES ('DE','Alemanha',81459000);
|
||||
INSERT INTO `pais` VALUES ('FR','França',64513242);
|
||||
INSERT INTO `pais` VALUES ('GB','Reino Unido',65097000);
|
||||
INSERT INTO `pais` VALUES ('IN','Índia',1285400000);
|
||||
INSERT INTO `pais` VALUES ('RU','Rússia',146519759);
|
||||
INSERT INTO `pais` VALUES ('US','Estados Unidos',322976000);
|
||||
```
|
||||
|
||||
Neste ponto, você tem um banco de dados chamado `yii2basic`, e dentro dele uma
|
||||
tabela `country` com três colunas, contendo dez linhas de dados.
|
||||
Neste ponto, você tem um banco de dados chamado `yii2basico` e dentro dele uma
|
||||
tabela `pais` com três colunas, contendo dez linhas de dados.
|
||||
|
||||
Configurando uma Conexão do BD <span id="configuring-db-connection"></span>
|
||||
Configurando uma Conexão de BD <span id="configuring-db-connection"></span>
|
||||
------------------------------
|
||||
|
||||
Antes de prosseguir, certifique-se de que você possui instalados tanto a
|
||||
extensão [PDO](http://www.php.net/manual/en/book.pdo.php) do PHP quanto o driver
|
||||
do PDO para a base que você está usando (por exemplo, `pdo_mysql` para o MySQL).
|
||||
PDO para o gerenciador de banco de dados que você está usando (por exemplo, `pdo_mysql` para o MySQL).
|
||||
Este é um requisito básico se a sua aplicação usa um banco de dados relacional.
|
||||
|
||||
Tendo estes instalados, abra o arquivo `config/db.php` e mude os parâmetros para
|
||||
que estejam corretos para o seu banco de dados. Por padrão, o arquivo contém
|
||||
o seguinte:
|
||||
Tendo esses instalados, abra o arquivo `config/db.php` e mude os parâmetros conforme seu banco de dados.
|
||||
Por padrão, o arquivo contém o seguinte:
|
||||
|
||||
```php
|
||||
<?php
|
||||
|
||||
return [
|
||||
'class' => 'yii\db\Connection',
|
||||
'dsn' => 'mysql:host=localhost;dbname=yii2basic',
|
||||
'dsn' => 'mysql:host=localhost;dbname=yii2basico',
|
||||
'username' => 'root',
|
||||
'password' => '',
|
||||
'charset' => 'utf8',
|
||||
];
|
||||
```
|
||||
|
||||
O arquivo `config/db.php` é uma ferramenta de [configuração](concept-configurations.md)
|
||||
típica baseada em arquivos. Este arquivo de configuração em particular especifica
|
||||
os parâmetros necessários para criar e inicializar uma instância de [[yii\db\Connection]]
|
||||
através da qual você pode fazer consultas de SQL ao banco de dados subjacente.
|
||||
O arquivo `config/db.php` é uma típica ferramenta de [configuração](concept-configurations.md) baseada em arquivo. Este arquivo de configuração em particular especifica
|
||||
os parâmetros necessários para criar e inicializar uma instância [[yii\db\Connection]]
|
||||
por meio da qual você pode fazer consultas SQL ao banco de dados subjacente.
|
||||
|
||||
A conexão de BD configurada acima pode ser acessada no código da aplicação
|
||||
através da expressão `Yii::$app->db`.
|
||||
A conexão configurada acima pode ser acessada no código da aplicação através da expressão `Yii::$app->db`.
|
||||
|
||||
> Informação: O arquivo `config/db.php` será incluso pela configuração principal da
|
||||
> Info: O arquivo `config/db.php` será absorvido (incluso) pela configuração principal da
|
||||
aplicação `config/web.php`, que especifica como a instância da [aplicação](structure-applications.md)
|
||||
deverá ser inicializada. Para mais informações, por favor consulte a seção sobre [Configurações](concept-configurations.md).
|
||||
deve ser inicializada. Para mais informações, por favor, consulte a seção [Configurações](concept-configurations.md).
|
||||
|
||||
Se você precisa trabalhar com bancos de dados para os quais não há suporte nativo no Yii, consulte as seguintes extensões:
|
||||
|
||||
- [Informix](https://github.com/edgardmessias/yii2-informix)
|
||||
- [IBM DB2](https://github.com/edgardmessias/yii2-ibm-db2)
|
||||
- [Firebird](https://github.com/edgardmessias/yii2-firebird)
|
||||
- [MariaDB](https://github.com/sam-it/yii2-mariadb)
|
||||
|
||||
Criando um Active Record <span id="creating-active-record"></span>
|
||||
------------------------
|
||||
|
||||
Para representar e buscar os dados da tabela `country`, crie uma classe que
|
||||
deriva de [Active Record](db-active-record.md) chamada `Country`, e salve-a
|
||||
no arquivo `models/Country.php`.
|
||||
Para representar e buscar os dados da tabela `pais`, crie uma classe que deriva de [Active Record](db-active-record.md) chamada `Pais` e salve-a
|
||||
no arquivo `models/Pais.php`.
|
||||
|
||||
```php
|
||||
<?php
|
||||
@ -105,55 +104,55 @@ namespace app\models;
|
||||
|
||||
use yii\db\ActiveRecord;
|
||||
|
||||
class Country extends ActiveRecord
|
||||
class Pais extends ActiveRecord
|
||||
{
|
||||
}
|
||||
```
|
||||
|
||||
A classe `Country` estende de [[yii\db\ActiveRecord]]. Você não precisa escrever
|
||||
nenhum código nela! Só com o código acima, o Yii adivinhará o nome da tabela
|
||||
A classe `Pais` estende de [[yii\db\ActiveRecord]]. Você não precisa escrever
|
||||
nenhum código nela! Só com o código acima, o Yii descobrirá o nome da tabela
|
||||
associada a partir do nome da classe.
|
||||
|
||||
> Informação: Se não houver nenhuma correspondência direta do nome da classe com o nome
|
||||
da tabela, você pode sobrescrever o método [[yii\db\ActiveRecord::tableName()]]
|
||||
> Info: Se não houver nenhuma correspondência direta do nome da classe com o nome
|
||||
da tabela, você pode sobrescrever o método [[yii\db\ActiveRecord::tableName()]]
|
||||
para especificar explicitamente o nome da tabela associada.
|
||||
|
||||
Usando a classe `Country`, você pode manipular facilmente os dados na tabela
|
||||
`country`, conforme é demonstrado nestes fragmentos:
|
||||
Usando a classe `Pais`, você pode manipular facilmente os dados na tabela
|
||||
`pais`, conforme é demonstrado nos fragmentos de código a seguir:
|
||||
|
||||
```php
|
||||
use app\models\Country;
|
||||
use app\models\Pais;
|
||||
|
||||
// obtém todas as linhas da tabela country e as ordena pela coluna "name"
|
||||
$countries = Country::find()->orderBy('name')->all();
|
||||
// obtém todas as linhas da tabela pais e as ordena pela coluna "nome"
|
||||
$paises = Pais::find()->orderBy('nome')->all();
|
||||
|
||||
// obtém a linha cuja chave primária é "US"
|
||||
$country = Country::findOne('US');
|
||||
// obtém a linha cuja chave primária é "BR"
|
||||
$pais = Pais::findOne('BR');
|
||||
|
||||
// exibe "United States"
|
||||
echo $country->name;
|
||||
// exibe "Brasil"
|
||||
echo $pais->nome;
|
||||
|
||||
// altera o nome do país para ser "U.S.A." e o salva no banco de dados
|
||||
$country->name = 'U.S.A.';
|
||||
$country->save();
|
||||
// altera o nome do país para "Brazil" e o salva no banco de dados
|
||||
$pais->nome = 'Brazil';
|
||||
$pais->save();
|
||||
```
|
||||
|
||||
> Informação: O Active Record é uma maneira poderosa de acessar e manipular os dados
|
||||
do banco de dados de uma forma orientada a objeto. Você pode encontrar informações
|
||||
mais detalhadas na seção [Active Record](db-active-record.md). Alternativamente,
|
||||
você também pode interagir com o banco de dados usando um método de acesso aos
|
||||
dados de baixo nível chamado [Data Access Objects](db-dao.md).
|
||||
> Info: O Active Record é uma maneira poderosa de acessar e manipular dados
|
||||
do banco de dados de uma forma orientada a objetos. Você pode encontrar informações
|
||||
mais detalhadas na seção [Active Record](db-active-record.md. Alternativamente,
|
||||
você também pode interagir com o banco de dados usando um método de acesso a
|
||||
dados em baixo nível chamado [Objeto de Acesso a Dados (Data Access Objects)](db-dao.md).
|
||||
|
||||
|
||||
Criando uma Action <span id="creating-action"></span>
|
||||
------------------
|
||||
|
||||
Para expor os dados de países aos usuários finais, você precisaria de uma nova
|
||||
action. Ao invés de colocar a nova action no controller (controlador) `site`,
|
||||
Para disponibiliar os dados de países aos usuários finais, você precisa criar uma nova
|
||||
action. Em vez de colocar a nova action no controller `site`
|
||||
como você fez nas seções anteriores, faz mais sentido criar um novo controller
|
||||
especificamente para todas as actions relacionadas aos dados de países. Chame
|
||||
este novo controller de `CountryController`, e crie uma action `index` nele,
|
||||
conforme o exemplo a seguir.
|
||||
este novo controller de `PaisController`, e crie uma action `index` nele,
|
||||
conforme o exemplo a seguir:
|
||||
|
||||
```php
|
||||
<?php
|
||||
@ -162,55 +161,53 @@ namespace app\controllers;
|
||||
|
||||
use yii\web\Controller;
|
||||
use yii\data\Pagination;
|
||||
use app\models\Country;
|
||||
use app\models\Pais;
|
||||
|
||||
class CountryController extends Controller
|
||||
class PaisController extends Controller
|
||||
{
|
||||
public function actionIndex()
|
||||
{
|
||||
$query = Country::find();
|
||||
$query = Pais::find();
|
||||
|
||||
$pagination = new Pagination([
|
||||
$paginacao = new Pagination([
|
||||
'defaultPageSize' => 5,
|
||||
'totalCount' => $query->count(),
|
||||
]);
|
||||
|
||||
$countries = $query->orderBy('name')
|
||||
->offset($pagination->offset)
|
||||
->limit($pagination->limit)
|
||||
$paises = $query->orderBy('nome')
|
||||
->offset($paginacao->offset)
|
||||
->limit($paginacao->limit)
|
||||
->all();
|
||||
|
||||
return $this->render('index', [
|
||||
'countries' => $countries,
|
||||
'pagination' => $pagination,
|
||||
'paises' => $paises,
|
||||
'paginacao' => $paginacao,
|
||||
]);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Salve o código acima em um arquivo `controllers/CountryController.php`.
|
||||
Salve o código acima no arquivo `controllers/PaisController.php`.
|
||||
|
||||
A action `index` chama `Country::find()`. Este método do Active Record constrói
|
||||
uma consulta do BD e retorna todos os dados da tabela `country`. Para limitar o
|
||||
número de países retornados em cada requisição, a consulta é paginada com a ajuda
|
||||
A action `index` chama `Pais::find()`. Este método do Active Record constrói
|
||||
uma consulta ao BD e retorna todos os dados da tabela `pais`. Para limitar o
|
||||
número de países retornados a cada requisição, a consulta é paginada com a ajuda
|
||||
de um objeto [[yii\data\Pagination]]. O objeto `Pagination` serve para dois propósitos:
|
||||
|
||||
* Definir as cláusulas `offset` e `limit` da declaração SQL representada pela
|
||||
consulta de modo que apenas retorne uma única página de dados por vez (no máximo
|
||||
* Define as cláusulas `offset` e `limit` da declaração SQL representada pela query
|
||||
(consulta) de modo que apenas retorne uma única página de dados por vez (no exemplo, no máximo
|
||||
5 linhas por página).
|
||||
* É usado para que a view exiba um paginador que consite de uma lista de botões
|
||||
para as páginas, conforme será explicado na próxima sub-seção.
|
||||
* É usado na view para exibir um paginador que consiste de uma lista de botões de páginas, conforme será explicado na próxima subseção.
|
||||
|
||||
No final do código, a action `index` renderiza uma view chamada `index`, e passa
|
||||
para ela os dados dos países bem como as informações de paginação.
|
||||
No final do código, a action `index` renderiza uma view chamada `index` e envia a ela os dados dos países e as informações de paginação.
|
||||
|
||||
|
||||
Criando uma View <span id="creating-view"></span>
|
||||
----------------
|
||||
|
||||
Dentro do diretório `views`, primeiro crie um sub-diretório chamado `country`.
|
||||
Dentro do diretório `views`, primeiro crie um subdiretório chamado `pais`.
|
||||
Esta pasta será usada para guardar todas as views renderizadas pelo controller
|
||||
`country`. Dentro do diretório `views/country`, crie um arquivo `index.php`
|
||||
`PaisController`. Dentro do diretório `views/pais`, crie um arquivo `index.php`
|
||||
contendo o seguinte:
|
||||
|
||||
```php
|
||||
@ -218,50 +215,48 @@ contendo o seguinte:
|
||||
use yii\helpers\Html;
|
||||
use yii\widgets\LinkPager;
|
||||
?>
|
||||
<h1>Countries</h1>
|
||||
<h1>Países</h1>
|
||||
<ul>
|
||||
<?php foreach ($countries as $country): ?>
|
||||
<?php foreach ($paises as $pais): ?>
|
||||
<li>
|
||||
<?= Html::encode("{$country->name} ({$country->code})") ?>:
|
||||
<?= $country->population ?>
|
||||
<?= Html::encode("{$pais->nome} ({$pais->codigo})") ?>:
|
||||
<?= $pais->populacao ?>
|
||||
</li>
|
||||
<?php endforeach; ?>
|
||||
</ul>
|
||||
|
||||
<?= LinkPager::widget(['pagination' => $pagination]) ?>
|
||||
<?= LinkPager::widget(['pagination' => $paginacao]) ?>
|
||||
```
|
||||
|
||||
A view tem duas seções relativas à exibição dos dados dos países. Na primeira parte,
|
||||
os dados de países fornecidos são cruzados e renderizados como uma lista do HTML.
|
||||
os dados de países fornecidos são percorridos e renderizados como uma lista HTML.
|
||||
Na segunda parte, um widget [[yii\widgets\LinkPager]] é renderizado usando as
|
||||
informações de paginação passadas pela action. O widget `LinkPager` exibe uma
|
||||
lista de botões para as páginas. Ao clicar em qualquer um deles atualizará
|
||||
os dados dos países com a página correspondente.
|
||||
lista de botões de páginas. Clicar em qualquer um deles vai atualizar os dados dos países conforme a página correspondente.
|
||||
|
||||
|
||||
Testando <span id="trying-it-out"></span>
|
||||
Conferindo <span id="trying-it-out"></span>
|
||||
--------
|
||||
|
||||
Para verificar se todo os códigos acima funcionam, use o seu navegador para
|
||||
acessar a seguinte URL:
|
||||
Para ver se todo os códigos acima funcionam, use o seu navegador para acessar a seguinte URL:
|
||||
|
||||
```
|
||||
http://hostname/index.php?r=country/index
|
||||
http://hostname/index.php?r=pais/index
|
||||
```
|
||||
|
||||
|
||||
|
||||
Primeiramente, você verá uma lista exibindo cinco países. Abaixo dos países,
|
||||
você verá um paginador com quatro botões. Se você clicar no botão "2", você
|
||||
verá a página exibindo outros cinco países no banco de dados: a segunda
|
||||
verá a página exibir outros cinco países do banco de dados: a segunda
|
||||
página de registros. Observe mais cuidadosamente e você perceberá que a URL no
|
||||
browser mudou para
|
||||
|
||||
```
|
||||
http://hostname/index.php?r=country/index&page=2
|
||||
http://hostname/index.php?r=pais/index&page=2
|
||||
```
|
||||
|
||||
Por baixo dos panos, [[yii\data\Pagination|Pagination]] está fornecendo toda
|
||||
Por trás das cortinas, [[yii\data\Pagination|Pagination]] está fornecendo toda
|
||||
a funcionalidade necessária para paginar um conjunto de dados:
|
||||
|
||||
* Inicialmente, [[yii\data\Pagination|Pagination]] representa a primeira página,
|
||||
@ -271,8 +266,8 @@ a funcionalidade necessária para paginar um conjunto de dados:
|
||||
usando as URLs criadas pelo [[yii\data\Pagination::createUrl()|Pagination]].
|
||||
As URLs conterão um parâmetro `page`, que representa os diferentes números de
|
||||
páginas.
|
||||
* Se você clicar no botão da página "2", uma nova requisição para a rota
|
||||
`country/index` será disparada e tratada. [[yii\data\Pagination|Pagination]] lê
|
||||
* Se você clicar no botão de página "2", uma nova requisição para a rota
|
||||
`pais/index` será disparada e tratada. [[yii\data\Pagination|Pagination]] lê
|
||||
o parâmetro `page` da URL e define o número da página atual como sendo 2. A nova
|
||||
consulta de países então terá a cláusula `LIMIT 5 OFFSET 5` e retornará os
|
||||
próximos cinco países para a exibição.
|
||||
@ -285,9 +280,9 @@ Nesta seção, você aprendeu como trabalhar com um banco de dados. Você també
|
||||
aprendeu como buscar e exibir dados em páginas com a ajuda do
|
||||
[[yii\data\Pagination]] e do [[yii\widgets\LinkPager]].
|
||||
|
||||
Na próxima seção, você aprenderá como usar a poderosa ferramenta geradora de códigos,
|
||||
Na próxima seção, você aprenderá como usar a poderosa ferramenta de geração de códigos,
|
||||
chamada [Gii](tool-gii.md), para ajudá-lo a implementar rapidamente algumas
|
||||
funcionalidades comumente necessárias, tais como as operações CRUD
|
||||
(Criar-Ler-Atualizar-Excluir) para trabalhar com os dados em uma tabela do
|
||||
(Criar-Ler-Atualizar-Excluir) para trabalhar com os dados de uma tabela do
|
||||
banco de dados. Na verdade, todo o código que você acabou de escrever pode ser
|
||||
gerado automaticamente no Yii usando a ferramenta Gii.
|
||||
|
||||
Reference in New Issue
Block a user