The path to yii framework seems to be incorrect.
'; - echo 'You need to install Yii framework via composer or adjust the framework path in file ' . basename(__FILE__) . '.
'; - echo 'Please refer to the README on how to install Yii.
'; -} - -require_once($frameworkPath . '/requirements/YiiRequirementChecker.php'); -$requirementsChecker = new YiiRequirementChecker(); - -$gdMemo = $imagickMemo = 'Either GD PHP extension with FreeType support or ImageMagick PHP extension with PNG support is required for image CAPTCHA.'; -$gdOK = $imagickOK = false; - -if (extension_loaded('imagick')) { - $imagick = new Imagick(); - $imagickFormats = $imagick->queryFormats('PNG'); - if (in_array('PNG', $imagickFormats)) { - $imagickOK = true; - } else { - $imagickMemo = 'Imagick extension should be installed with PNG support in order to be used for image CAPTCHA.'; - } -} - -if (extension_loaded('gd')) { - $gdInfo = gd_info(); - if (!empty($gdInfo['FreeType Support'])) { - $gdOK = true; - } else { - $gdMemo = 'GD extension should be installed with FreeType support in order to be used for image CAPTCHA.'; - } -} - -/** - * Adjust requirements according to your application specifics. - */ -$requirements = array( - // Database : - array( - 'name' => 'PDO extension', - 'mandatory' => true, - 'condition' => extension_loaded('pdo'), - 'by' => 'All DB-related classes', - ), - array( - 'name' => 'PDO SQLite extension', - 'mandatory' => false, - 'condition' => extension_loaded('pdo_sqlite'), - 'by' => 'All DB-related classes', - 'memo' => 'Required for SQLite database.', - ), - array( - 'name' => 'PDO MySQL extension', - 'mandatory' => false, - 'condition' => extension_loaded('pdo_mysql'), - 'by' => 'All DB-related classes', - 'memo' => 'Required for MySQL database.', - ), - array( - 'name' => 'PDO PostgreSQL extension', - 'mandatory' => false, - 'condition' => extension_loaded('pdo_pgsql'), - 'by' => 'All DB-related classes', - 'memo' => 'Required for PostgreSQL database.', - ), - // Cache : - array( - 'name' => 'Memcache extension', - 'mandatory' => false, - 'condition' => extension_loaded('memcache') || extension_loaded('memcached'), - 'by' => 'MemCache', - 'memo' => extension_loaded('memcached') ? 'To use memcached set MemCache::useMemcached totrue.' : ''
- ),
- array(
- 'name' => 'APC extension',
- 'mandatory' => false,
- 'condition' => extension_loaded('apc'),
- 'by' => 'ApcCache',
- ),
- // CAPTCHA:
- array(
- 'name' => 'GD PHP extension with FreeType support',
- 'mandatory' => false,
- 'condition' => $gdOK,
- 'by' => 'Captcha',
- 'memo' => $gdMemo,
- ),
- array(
- 'name' => 'ImageMagick PHP extension with PNG support',
- 'mandatory' => false,
- 'condition' => $imagickOK,
- 'by' => 'Captcha',
- 'memo' => $imagickMemo,
- ),
- // PHP ini :
- 'phpSafeMode' => array(
- 'name' => 'PHP safe mode',
- 'mandatory' => false,
- 'condition' => $requirementsChecker->checkPhpIniOff("safe_mode"),
- 'by' => 'File uploading and console command execution',
- 'memo' => '"safe_mode" should be disabled at php.ini',
- ),
- 'phpExposePhp' => array(
- 'name' => 'Expose PHP',
- 'mandatory' => false,
- 'condition' => $requirementsChecker->checkPhpIniOff("expose_php"),
- 'by' => 'Security reasons',
- 'memo' => '"expose_php" should be disabled at php.ini',
- ),
- 'phpAllowUrlInclude' => array(
- 'name' => 'PHP allow url include',
- 'mandatory' => false,
- 'condition' => $requirementsChecker->checkPhpIniOff("allow_url_include"),
- 'by' => 'Security reasons',
- 'memo' => '"allow_url_include" should be disabled at php.ini',
- ),
- 'phpSmtp' => array(
- 'name' => 'PHP mail SMTP',
- 'mandatory' => false,
- 'condition' => strlen(ini_get('SMTP')) > 0,
- 'by' => 'Email sending',
- 'memo' => 'PHP mail SMTP server required',
- ),
-);
-$requirementsChecker->checkYii()->check($requirements)->render();
diff --git a/apps/advanced/tests/README.md b/apps/advanced/tests/README.md
deleted file mode 100644
index ad7f016..0000000
--- a/apps/advanced/tests/README.md
+++ /dev/null
@@ -1,58 +0,0 @@
-This directory contains various tests for the advanced applications.
-
-Tests in `codeception` directory are developed with [Codeception PHP Testing Framework](http://codeception.com/).
-
-After creating and setting up the advanced application, follow these steps to prepare for the tests:
-
-1. Install Codeception if it's not yet installed:
-
- ```
- composer global require "codeception/codeception=2.0.*" "codeception/specify=*" "codeception/verify=*"
- ```
-
- If you've never used Composer for global packages run `composer global status`. It should output:
-
- ```
- Changed current directory to The path to yii framework seems to be incorrect.
'; - echo 'You need to install Yii framework via composer or adjust the framework path in file ' . basename(__FILE__) . '.
'; - echo 'Please refer to the README on how to install Yii.
'; -} - -require_once($frameworkPath . '/requirements/YiiRequirementChecker.php'); -$requirementsChecker = new YiiRequirementChecker(); - -$gdMemo = $imagickMemo = 'Either GD PHP extension with FreeType support or ImageMagick PHP extension with PNG support is required for image CAPTCHA.'; -$gdOK = $imagickOK = false; - -if (extension_loaded('imagick')) { - $imagick = new Imagick(); - $imagickFormats = $imagick->queryFormats('PNG'); - if (in_array('PNG', $imagickFormats)) { - $imagickOK = true; - } else { - $imagickMemo = 'Imagick extension should be installed with PNG support in order to be used for image CAPTCHA.'; - } -} - -if (extension_loaded('gd')) { - $gdInfo = gd_info(); - if (!empty($gdInfo['FreeType Support'])) { - $gdOK = true; - } else { - $gdMemo = 'GD extension should be installed with FreeType support in order to be used for image CAPTCHA.'; - } -} - -/** - * Adjust requirements according to your application specifics. - */ -$requirements = array( - // Database : - array( - 'name' => 'PDO extension', - 'mandatory' => true, - 'condition' => extension_loaded('pdo'), - 'by' => 'All DB-related classes', - ), - array( - 'name' => 'PDO SQLite extension', - 'mandatory' => false, - 'condition' => extension_loaded('pdo_sqlite'), - 'by' => 'All DB-related classes', - 'memo' => 'Required for SQLite database.', - ), - array( - 'name' => 'PDO MySQL extension', - 'mandatory' => false, - 'condition' => extension_loaded('pdo_mysql'), - 'by' => 'All DB-related classes', - 'memo' => 'Required for MySQL database.', - ), - array( - 'name' => 'PDO PostgreSQL extension', - 'mandatory' => false, - 'condition' => extension_loaded('pdo_pgsql'), - 'by' => 'All DB-related classes', - 'memo' => 'Required for PostgreSQL database.', - ), - // Cache : - array( - 'name' => 'Memcache extension', - 'mandatory' => false, - 'condition' => extension_loaded('memcache') || extension_loaded('memcached'), - 'by' => 'MemCache', - 'memo' => extension_loaded('memcached') ? 'To use memcached set MemCache::useMemcached totrue.' : ''
- ),
- array(
- 'name' => 'APC extension',
- 'mandatory' => false,
- 'condition' => extension_loaded('apc'),
- 'by' => 'ApcCache',
- ),
- // CAPTCHA:
- array(
- 'name' => 'GD PHP extension with FreeType support',
- 'mandatory' => false,
- 'condition' => $gdOK,
- 'by' => 'Captcha',
- 'memo' => $gdMemo,
- ),
- array(
- 'name' => 'ImageMagick PHP extension with PNG support',
- 'mandatory' => false,
- 'condition' => $imagickOK,
- 'by' => 'Captcha',
- 'memo' => $imagickMemo,
- ),
- // PHP ini :
- 'phpSafeMode' => array(
- 'name' => 'PHP safe mode',
- 'mandatory' => false,
- 'condition' => $requirementsChecker->checkPhpIniOff("safe_mode"),
- 'by' => 'File uploading and console command execution',
- 'memo' => '"safe_mode" should be disabled at php.ini',
- ),
- 'phpExposePhp' => array(
- 'name' => 'Expose PHP',
- 'mandatory' => false,
- 'condition' => $requirementsChecker->checkPhpIniOff("expose_php"),
- 'by' => 'Security reasons',
- 'memo' => '"expose_php" should be disabled at php.ini',
- ),
- 'phpAllowUrlInclude' => array(
- 'name' => 'PHP allow url include',
- 'mandatory' => false,
- 'condition' => $requirementsChecker->checkPhpIniOff("allow_url_include"),
- 'by' => 'Security reasons',
- 'memo' => '"allow_url_include" should be disabled at php.ini',
- ),
- 'phpSmtp' => array(
- 'name' => 'PHP mail SMTP',
- 'mandatory' => false,
- 'condition' => strlen(ini_get('SMTP'))>0,
- 'by' => 'Email sending',
- 'memo' => 'PHP mail SMTP server required',
- ),
-);
-$requirementsChecker->checkYii()->check($requirements)->render();
diff --git a/apps/basic/runtime/.gitignore b/apps/basic/runtime/.gitignore
deleted file mode 100644
index c96a04f..0000000
--- a/apps/basic/runtime/.gitignore
+++ /dev/null
@@ -1,2 +0,0 @@
-*
-!.gitignore
\ No newline at end of file
diff --git a/apps/basic/tests/README.md b/apps/basic/tests/README.md
deleted file mode 100644
index f14db26..0000000
--- a/apps/basic/tests/README.md
+++ /dev/null
@@ -1,63 +0,0 @@
-This directory contains various tests for the basic application.
-
-Tests in `codeception` directory are developed with [Codeception PHP Testing Framework](http://codeception.com/).
-
-After creating the basic application, follow these steps to prepare for the tests:
-
-1. Install Codeception if it's not yet installed:
-
-```
-composer global require "codeception/codeception=2.0.*"
-composer global require "codeception/specify=*"
-composer global require "codeception/verify=*"
-```
-
-If you've never used Composer for global packages run `composer global status`. It should output:
-
-```
-Changed current directory to
- 'My Company',
- 'brandUrl' => Yii::$app->homeUrl,
- 'options' => [
- 'class' => 'navbar-inverse navbar-fixed-top',
- ],
- ]);
- echo Nav::widget([
- 'options' => ['class' => 'navbar-nav navbar-right'],
- 'items' => [
- ['label' => 'Home', 'url' => ['/site/index']],
- ['label' => 'About', 'url' => ['/site/about']],
- ['label' => 'Contact', 'url' => ['/site/contact']],
- Yii::$app->user->isGuest ?
- ['label' => 'Login', 'url' => ['/site/login']] :
- ['label' => 'Logout (' . Yii::$app->user->identity->username . ')',
- 'url' => ['/site/logout'],
- 'linkOptions' => ['data-method' => 'post']],
- ],
- ]);
- NavBar::end();
- ?>
-
-
-
-
-
-endBody() ?>
-
-
-endPage() ?>
diff --git a/apps/basic/views/site/about.php b/apps/basic/views/site/about.php
deleted file mode 100644
index 13d85a6..0000000
--- a/apps/basic/views/site/about.php
+++ /dev/null
@@ -1,16 +0,0 @@
-title = 'About';
-$this->params['breadcrumbs'][] = $this->title;
-?>
-
- isset($this->params['breadcrumbs']) ? $this->params['breadcrumbs'] : [],
- ]) ?>
-
-
-
-
diff --git a/apps/basic/views/site/contact.php b/apps/basic/views/site/contact.php
deleted file mode 100644
index e964a34..0000000
--- a/apps/basic/views/site/contact.php
+++ /dev/null
@@ -1,57 +0,0 @@
-title = 'Contact';
-$this->params['breadcrumbs'][] = $this->title;
-?>
-title) ?>
- -- This is the About page. You may modify the following file to customize its content: -
- -
-
diff --git a/apps/basic/views/site/error.php b/apps/basic/views/site/error.php
deleted file mode 100644
index b9812c4..0000000
--- a/apps/basic/views/site/error.php
+++ /dev/null
@@ -1,27 +0,0 @@
-title = $name;
-?>
-title) ?>
- - session->hasFlash('contactFormSubmitted')): ?> - -
- Thank you for contacting us. We will respond to you as soon as possible.
-
-
-
- Note that if you turn on the Yii debugger, you should be able
- to view the mail message on the mail panel of the debugger.
- mailer->useFileTransport): ?>
- Because the application is in development mode, the email is not sent but saved as
- a file under mailer->fileTransportPath) ?>.
- Please configure the useFileTransport property of the mail
- application component to be false to enable email sending.
-
-
- If you have business inquiries or other questions, please fill out the following form to contact us. Thank you. -
- -
-
-
-
-
- 'contact-form']); ?>
- field($model, 'name') ?>
- field($model, 'email') ?>
- field($model, 'subject') ?>
- field($model, 'body')->textArea(['rows' => 6]) ?>
- field($model, 'verifyCode')->widget(Captcha::className(), [
- 'template' => '',
- ]) ?>
-
- {image}
{input}
- 'btn btn-primary', 'name' => 'contact-button']) ?>
-
-
-
-
-
diff --git a/apps/basic/views/site/index.php b/apps/basic/views/site/index.php
deleted file mode 100644
index a00ee4d..0000000
--- a/apps/basic/views/site/index.php
+++ /dev/null
@@ -1,51 +0,0 @@
-title = 'My Yii Application';
-?>
-title) ?>
- -
-
-
-
- - The above error occurred while the Web server was processing your request. -
-- Please contact us if you think this is a server error. Thank you. -
- -
-
-
diff --git a/apps/basic/views/site/login.php b/apps/basic/views/site/login.php
deleted file mode 100644
index 916be98..0000000
--- a/apps/basic/views/site/login.php
+++ /dev/null
@@ -1,46 +0,0 @@
-title = 'Login';
-$this->params['breadcrumbs'][] = $this->title;
-?>
-
-
-
- Congratulations!
- -You have successfully created your Yii-powered application.
- - -
-
-
-
-
-
-
-
- Heading
- -Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et - dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip - ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu - fugiat nulla pariatur.
- - -
-
- Heading
- -Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et - dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip - ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu - fugiat nulla pariatur.
- - -
-
- Heading
- -Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et - dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip - ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu - fugiat nulla pariatur.
- - -
-
diff --git a/apps/basic/web/assets/.gitignore b/apps/basic/web/assets/.gitignore
deleted file mode 100644
index d6b7ef3..0000000
--- a/apps/basic/web/assets/.gitignore
+++ /dev/null
@@ -1,2 +0,0 @@
-*
-!.gitignore
diff --git a/apps/basic/web/css/site.css b/apps/basic/web/css/site.css
deleted file mode 100644
index 698be70..0000000
--- a/apps/basic/web/css/site.css
+++ /dev/null
@@ -1,91 +0,0 @@
-html,
-body {
- height: 100%;
-}
-
-.wrap {
- min-height: 100%;
- height: auto;
- margin: 0 auto -60px;
- padding: 0 0 60px;
-}
-
-.wrap > .container {
- padding: 70px 15px 20px;
-}
-
-.footer {
- height: 60px;
- background-color: #f5f5f5;
- border-top: 1px solid #ddd;
- padding-top: 20px;
-}
-
-.jumbotron {
- text-align: center;
- background-color: transparent;
-}
-
-.jumbotron .btn {
- font-size: 21px;
- padding: 14px 24px;
-}
-
-.not-set {
- color: #c55;
- font-style: italic;
-}
-
-/* add sorting icons to gridview sort links */
-a.asc:after, a.desc:after {
- position: relative;
- top: 1px;
- display: inline-block;
- font-family: 'Glyphicons Halflings';
- font-style: normal;
- font-weight: normal;
- line-height: 1;
- padding-left: 5px;
-}
-
-a.asc:after {
- content: /*"\e113"*/ "\e151";
-}
-
-a.desc:after {
- content: /*"\e114"*/ "\e152";
-}
-
-.sort-numerical a.asc:after {
- content: "\e153";
-}
-
-.sort-numerical a.desc:after {
- content: "\e154";
-}
-
-.sort-ordinal a.asc:after {
- content: "\e155";
-}
-
-.sort-ordinal a.desc:after {
- content: "\e156";
-}
-
-.grid-view th {
- white-space: nowrap;
-}
-
-.hint-block {
- display: block;
- margin-top: 5px;
- color: #999;
-}
-
-.error-summary {
- color: #a94442;
- background: #fdf7f7;
- border-left: 3px solid #eed3d7;
- padding: 10px 20px;
- margin: 0 0 15px 0;
-}
diff --git a/apps/basic/web/favicon.ico b/apps/basic/web/favicon.ico
deleted file mode 100644
index 580ed73..0000000
Binary files a/apps/basic/web/favicon.ico and /dev/null differ
diff --git a/apps/basic/web/index-test.php b/apps/basic/web/index-test.php
deleted file mode 100644
index 32b4ce3..0000000
--- a/apps/basic/web/index-test.php
+++ /dev/null
@@ -1,16 +0,0 @@
-run();
diff --git a/apps/basic/web/index.php b/apps/basic/web/index.php
deleted file mode 100644
index d1e070a..0000000
--- a/apps/basic/web/index.php
+++ /dev/null
@@ -1,12 +0,0 @@
-run();
diff --git a/apps/basic/web/robots.txt b/apps/basic/web/robots.txt
deleted file mode 100644
index 6f27bb6..0000000
--- a/apps/basic/web/robots.txt
+++ /dev/null
@@ -1,2 +0,0 @@
-User-agent: *
-Disallow:
\ No newline at end of file
diff --git a/apps/basic/yii b/apps/basic/yii
deleted file mode 100755
index b032ebd..0000000
--- a/apps/basic/yii
+++ /dev/null
@@ -1,24 +0,0 @@
-#!/usr/bin/env php
-run();
-exit($exitCode);
diff --git a/apps/basic/yii.bat b/apps/basic/yii.bat
deleted file mode 100644
index d516b3a..0000000
--- a/apps/basic/yii.bat
+++ /dev/null
@@ -1,20 +0,0 @@
-@echo off
-
-rem -------------------------------------------------------------
-rem Yii command line bootstrap script for Windows.
-rem
-rem @author Qiang Xue title) ?>
- -Please fill out the following fields to login:
- - 'login-form', - 'options' => ['class' => 'form-horizontal'], - 'fieldConfig' => [ - 'template' => "{label}\n{input}
\n{error}
",
- 'labelOptions' => ['class' => 'col-lg-1 control-label'],
- ],
- ]); ?>
-
- field($model, 'username') ?>
-
- field($model, 'password')->passwordInput() ?>
-
- field($model, 'rememberMe', [
- 'template' => "{input}
\n{error}
",
- ])->checkbox() ?>
-
-
-
-
-
-
-
- 'btn btn-primary', 'name' => 'login-button']) ?>
-
-
- You may login with admin/admin or demo/demo.
- To modify the username/password, please check out the code
-- To modify the username/password, please check out the code
app\models\User::$users.
- samdark
+``` + +Si se necesita solo la apertura o el cierre de una etiqueta, se pueden usar los métodos `Html::beginTag()` y +`Html::endTag()`. + +Las opciones se usan en muchos métodos de la clase auxiliar Html y en varios widgets. En todos estos casos hay cierta +gestión adicional que se debe conocer: + +- Si un valor es `null`, el correspondiente atributo no se renderizará. +- Los atributos cuyos valores son de tipo booleano serán tratados como + [atributos booleanos](http://www.w3.org/TR/html5/infrastructure.html#boolean-attributes). +- Los valores de los atributos se codificarán en HTML usando [[yii\helpers\Html::encode()|Html::encode()]]. +- El atributo "data" puede recibir un array. En este caso, se "expandirá" y se renderizará una lista de atributos + `data` ej. `'data' => ['id' => 1, 'name' => 'yii']` se convierte en `data-id="1" data-name="yii"`. +- El atributo "data" puede recibir un JSON. Se gestionará de la misma manera que un array ej. + `'data' => ['params' => ['id' => 1, 'name' => 'yii'], 'status' => 'ok']` se convierte en + `data-params='{"id":1,"name":"yii"}' data-status="ok"`. + +### Formación de clases y estilos dinámicamente + +Cuando se construyen opciones para etiquetas HTML, a menudo nos encontramos con valores predeterminados que hay que +modificar. Para añadir o eliminar clases CSS se puede usar el siguiente ejemplo: + +```php +$options = ['class' => 'btn btn-default']; + +if ($type === 'success') { + Html::removeCssClass($options, 'btn-default'); + Html::addCssClass($options, 'btn-success'); +} + +echo Html::tag('div', 'Pwede na', $options); + +// cuando $type sea 'success' se renderizará +//Pwede na
+```
+
+Para hacer lo mismo con los estilos para el atributo `style`:
+
+```php
+$options = ['style' => ['width' => '100px', 'height' => '100px']];
+
+// devuelve style="width: 100px; height: 200px; position: absolute;"
+Html::addCssStyle($options, 'height: 200px; positon: absolute;');
+
+// devuelve style="position: absolute;"
+Html::removeCssStyle($options, ['width', 'height']);
+```
+
+Cuando se usa [[yii\helpers\Html::addCssStyle()|addCssStyle()]] se puede especificar si un array de pares clave-valor
+corresponde a nombres y valores de la propiedad CSS correspondiente o a una cadena de texto como por ejemplo
+`width: 100px; height: 200px;`. Estos formatos se pueden "hacer" y "deshacer" usando
+[[yii\helpers\Html::cssStyleFromArray()|cssStyleFromArray()]] y
+[[yii\helpers\Html::cssStyleToArray()|cssStyleToArray()]]. El método
+[[yii\helpers\Html::removeCssStyle()|removeCssStyle()]] acepta un array de propiedades que se eliminarán. Si sólo se
+eliminara una propiedad, se puede especificar como una cadena de texto.
+
+## Codificación y Decodificación del contenido
+
+
+Para que el contenido se muestre correctamente y de forma segura con caracteres especiales HTML el contenido debe ser
+codificado. En PHP esto se hace con [htmlspecialchars](http://www.php.net/manual/es/function.htmlspecialchars.php) y
+[htmlspecialchars_decode](http://www.php.net/manual/es/function.htmlspecialchars-decode.php). El problema con el uso
+de estos métodos directamente es que se tiene que especificar la codificación y opciones extra cada vez. Ya que las
+opciones siempre son las mismas y la codificación debe coincidir con la de la aplicación para prevenir problemas de
+seguridad, Yii proporciona dos métodos simples y compactos:
+
+```php
+$userName = Html::encode($user->name);
+echo $userName;
+
+$decodedUserName = Html::decode($userName);
+```
+
+## Formularios
+
+
+El trato con el marcado de formularios es una tarea repetitiva y propensa a errores. Por esto hay un grupo de métodos
+para ayudar a gestionarlos.
+
+> Nota: hay que considerar la opción de usar [[yii\widgets\ActiveForm|ActiveForm]] en caso de que se gestionen
+formularios que requieran validaciones.
+
+### Creando formularios
+
+Se puede abrir un formulario con el método [[yii\helpers\Html::beginForm()|beginForm()]] como se muestra a
+continuación:
+
+```php
+ $id], 'post', ['enctype' => 'multipart/form-data']) ?>
+```
+
+El primer argumento es la URL a la que se enviarán los datos del formulario. Se puede especificar en formato de ruta
+de Yii con los parámetros aceptados por [[yii\helpers\Url::to()|Url::to()]]. El segundo es el método que se usará.
+`post` es el método predeterminado. El tercero es un array de opciones para la etiqueta `form`. En este caso cambiamos
+el método de codificación del formulario de `data` en una petición POST a `multipart/form-data`. Esto se requiere
+cuando se quieren subir archivos.
+
+El cierre de la etiqueta `form` es simple:
+
+```php
+
+```
+
+### Botones
+
+Para generar botones se puede usar el siguiente código:
+
+```php
+ 'teaser']) ?>
+ 'submit']) ?>
+ 'reset']) ?>
+```
+
+El primer argumento para los tres métodos es el título del botón y el segundo son las opciones. El título no está
+codificado pero si se usan datos recibidos por el usuario, deben codificarse mediante
+[[yii\helpers\Html::encode()|Html::encode()]].
+
+### Inputs
+
+Hay dos grupos en los métodos input. Unos empiezan con `active` y se llaman inputs activos y los otros no empiezan
+así. Los inputs activos obtienen datos del modelo y del atributo especificado y los datos de los inputs normales se
+especifica directamente.
+
+Los métodos más genéricos son:
+
+```php
+type, input name, input value, options
+name, ['class' => $username]) ?>
+
+type, model, model attribute name, options
+ $username]) ?>
+```
+
+Si se conoce el tipo de input de antemano, es conveniente usar los atajos de los métodos:
+
+- [[yii\helpers\Html::buttonInput()]]
+- [[yii\helpers\Html::submitInput()]]
+- [[yii\helpers\Html::resetInput()]]
+- [[yii\helpers\Html::textInput()]], [[yii\helpers\Html::activeTextInput()]]
+- [[yii\helpers\Html::hiddenInput()]], [[yii\helpers\Html::activeHiddenInput()]]
+- [[yii\helpers\Html::passwordInput()]] / [[yii\helpers\Html::activePasswordInput()]]
+- [[yii\helpers\Html::fileInput()]], [[yii\helpers\Html::activeFileInput()]]
+- [[yii\helpers\Html::textarea()]], [[yii\helpers\Html::activeTextarea()]]
+
+Los botones de opción (Radios) y las casillas de verificación (checkboxes) se especifican de forma un poco diferente:
+
+```php
+ 'I agree']);
+ 'agreement'])
+
+ 'I agree']);
+ 'agreement'])
+```
+
+Las listas desplegables (dropdown list) se pueden renderizar como se muestra a continuación:
+
+```php
+
+
+
+
+
+```
+
+El primer argumento es el nombre del input, el segundo es el valor seleccionado actualmente y el tercero es el array
+de pares clave-valor donde la clave es la lista de valores y el valor del array es la lista a mostrar.
+
+Si se quiere habilitar la selección múltiple, se puede usar la lista seleccionable (checkbox list):
+
+```php
+
+
+```
+
+Si no, se puede usar la lista de opciones (radio list):
+
+```php
+
+
+```
+
+### Etiquetas y Errores
+
+De forma parecida que en los inputs hay dos métodos para generar etiquetas. El activo que obtiene los datos del modelo y
+el no-activo que acepta los datos directamente:
+
+```php
+ 'label username']) ?>
+ 'label username'])
+```
+
+Para mostrar los errores del formulario de un modelo o modelos a modo de resumen puedes usar:
+
+```php
+ 'errors']) ?>
+```
+
+Para mostrar un error individual:
+
+```php
+ 'error']) ?>
+```
+
+### Input Names y Values
+
+Existen métodos para obtener names, IDs y values para los campos de entrada (inputs) basados en el modelo. Estos se
+usan principalmente internamente pero a veces pueden resultar prácticos:
+
+```php
+// Post[title]
+echo Html::getInputName($post, 'title');
+
+// post-title
+echo Html::getInputId($post, 'title');
+
+// mi primer post
+echo Html::getAttributeValue($post, 'title');
+
+// $post->authors[0]
+echo Html::getAttributeValue($post, '[0]authors[0]');
+```
+
+En el ejemplo anterior, el primer argumento es el modelo y el segundo es un atributo de expresión. En su forma más
+simple es su nombre de atributo pero podría ser un nombre de atributo prefijado y/o añadido como sufijo con los
+indices de un array, esto se usa principalmente para mostrar inputs en formatos de tablas:
+
+- `[0]content` se usa en campos de entrada de datos en formato de tablas para representar el atributo "content" para
+ el primer modelo del input en formato de tabla;
+- `dates[0]` representa el primer elemento del array del atributo "dates";
+- `[0]dates[0]` representa el primer elemento del array del atributo "dates" para el primer modelo en formato de tabla.
+
+Para obtener el nombre de atributo sin sufijos o prefijos se puede usar el siguiente código:
+
+```php
+// dates
+echo Html::getAttributeName('dates[0]');
+```
+
+## Estilos y scripts
+
+
+Existen dos métodos para generar etiquetas que envuelvan estilos y scripts incrustados (embebbed):
+
+```php
+
+
+Genera
+
+
+
+ true]);
+
+Genera
+
+
+```
+
+Si se quiere enlazar un estilo externo desde un archivo CSS:
+
+```php
+ 'IE 5']) ?>
+
+genera
+
+
+```
+
+El primer argumento es la URL. El segundo es un array de opciones. Adicionalmente, para regular las opciones se puede
+especificar:
+
+- `condition` para envolver `
+```
+
+Aparte de los [alias](concept-aliases.md) el primer argumento puede aceptar rutas, parámetros y URLs. Del mismo modo
+que [Url::to()](helper-url.md).
+
+## Listas
+
+
+Las listas desordenadas se puede generar como se muestra a continuación:
+
+```php
+ function($item, $index) {
+ return Html::tag(
+ 'li',
+ $this->render('post', ['item' => $item]),
+ ['class' => 'post']
+ );
+}]) ?>
+```
+
+Para generar listas ordenadas se puede usar `Html::ol()` en su lugar.
diff --git a/docs/guide-es/helper-overview.md b/docs/guide-es/helper-overview.md
new file mode 100644
index 0000000..3bf4354
--- /dev/null
+++ b/docs/guide-es/helper-overview.md
@@ -0,0 +1,79 @@
+Helpers
+=======
+
+> Nota: Esta sección está en desarrollo.
+
+Yii ofrece muchas clases que ayudan a simplificar las tareas comunes de codificación, como manipulación de string o array,
+generación de código HTML, y más. Estas clases helper están organizadas bajo el namespace `yii\helpers` y
+son todo clases estáticas (lo que significa que sólo contienen propiedades y métodos estáticos y no deben ser instanciadas).
+
+Puedes usar una clase helper directamente llamando a uno de sus métodos estáticos, como a continuación:
+
+```php
+use yii\helpers\Html;
+
+echo Html::encode('Test > test');
+```
+
+> Nota: Para soportar la [personalización de clases helper](#customizing-helper-classes), Yii separa cada clase helper del núcleo
+ en dos clases: una clase base (ej. `BaseArrayHelper`) y una clase concreta (ej. `ArrayHelper`).
+ Cuando uses un helper, deberías sólo usar la versión concreta y nunca usar la clase base.
+
+
+Clases Helper del núcleo
+------------------------
+
+Las siguientes clases helper del núcleo son proporcionadas en los releases de Yii:
+
+- [ArrayHelper](helper-array.md)
+- Console
+- FileHelper
+- [Html](helper-html.md)
+- HtmlPurifier
+- Image
+- Inflector
+- Json
+- Markdown
+- Security
+- StringHelper
+- [Url](helper-url.md)
+- VarDumper
+
+
+Personalizando Las Clases Helper
+--------------------------------
+
+Para personalizar una clase helper del núcleo (ej. [[yii\helpers\ArrayHelper]]), deberías crear una nueva clase extendiendo
+de los helpers correspondientes a la clase base (ej. [[yii\helpers\BaseArrayHelper]]), incluyendo su namespace. Esta clase
+será creada para remplazar la implementación original del framework.
+
+El siguiente ejemplo muestra como personalizar el método [[yii\helpers\ArrayHelper::merge()|merge()]] de la clase
+[[yii\helpers\ArrayHelper]]:
+
+```php
+ 42]);
```
-Se puede especificar la ruta como una cadena de texto, p. ej. `site/index`. También se puede usar un array si se
+Se puede especificar la ruta como una cadena de texto, ej. `site/index`. También se puede usar un array si se
quieren especificar parámetros para la URL que se esta generando. El formato del array debe ser:
```php
@@ -53,14 +53,14 @@ Si se quiere crear una URL con un enlace, se puede usar el formato de array con
['site/index', 'param1' => 'value1', '#' => 'name']
```
-Una ruta puede ser absoluta o relativa. Una ruta absoluta tiene una barra al principio (p. ej. `/site/index`),
-mientras que una ruta relativa no la tiene (p. ej. `site/index` o `index`). Una ruta relativa se convertirá en una
+Una ruta puede ser absoluta o relativa. Una ruta absoluta tiene una barra al principio (ej. `/site/index`),
+mientras que una ruta relativa no la tiene (ej. `site/index` o `index`). Una ruta relativa se convertirá en una
ruta absoluta siguiendo las siguientes normas:
- Si la ruta es una cadena vacía, se usará la [[\yii\web\Controller::route|route]] actual;
-- Si la ruta no contiene barras (p. ej. `index`), se considerará que es el ID de una acción del controlador actual y
+- Si la ruta no contiene barras (ej. `index`), se considerará que es el ID de una acción del controlador actual y
se antepondrá con [[\yii\web\Controller::uniqueId]];
-- Si la ruta no tiene barra inicial (p. ej. `site/index`), se considerará que es una ruta relativa del modulo actual y
+- Si la ruta no tiene barra inicial (ej. `site/index`), se considerará que es una ruta relativa del modulo actual y
se le antepondrá el [[\yii\base\Module::uniqueId|uniqueId]] del modulo.
A continuación se muestran varios ejemplos del uso de este método:
@@ -79,21 +79,21 @@ echo Url::toRoute('site/index', true);
echo Url::toRoute('site/index', 'https');
```
-El otro método `Url::to()` es muy similar a [[toRoute()]]. La única diferencia es que este método requiere que la ruta
+El otro método `Url::to()` es muy similar a [[toRoute()]]. La única diferencia es que este método requiere que la ruta
especificada sea un array. Si se pasa una cadena de texto, se tratara como una URL.
El primer argumento puede ser:
-- un array: se llamará a [[toRoute()]] para generar la URL. Por ejemplo: `['site/index']`,
- `['post/index', 'page' => 2]`. Se puede revisar [[toRoute()]] para obtener más detalles acerca de como especificar
+- un array: se llamará a [[toRoute()]] para generar la URL. Por ejemplo: `['site/index']`,
+ `['post/index', 'page' => 2]`. Se puede revisar [[toRoute()]] para obtener más detalles acerca de como especificar
una ruta.
-- una cadena que empiece por `@`: se tratará como un alias, y se devolverá la cadena correspondiente asociada a este
+- una cadena que empiece por `@`: se tratará como un alias, y se devolverá la cadena correspondiente asociada a este
alias.
- una cadena vacía: se devolverá la URL de la petición actual;
- una cadena de texto: se devolverá sin alteraciones.
-Cuando se especifique `$schema` (tanto una cadena de text como `true`), se devolverá una URL con información del host
-(obtenida mediante [[\yii\web\UrlManager::hostInfo]]). Si `$url` ya es una URL absoluta, su esquema se reemplazará con
+Cuando se especifique `$schema` (tanto una cadena de text como `true`), se devolverá una URL con información del host
+(obtenida mediante [[\yii\web\UrlManager::hostInfo]]). Si `$url` ya es una URL absoluta, su esquema se reemplazará con
el especificado.
A continuación se muestran algunos ejemplos de uso:
@@ -124,7 +124,7 @@ echo Url::to('@web/images/logo.gif', 'https');
Recordar la URL para utilizarla más adelante
--------------------------------------------
-Hay casos en que se necesita recordar la URL y después usarla durante el procesamiento de una de las peticiones
+Hay casos en que se necesita recordar la URL y después usarla durante el procesamiento de una de las peticiones
secuenciales. Se puede logar de la siguiente manera:
```php
@@ -148,7 +148,7 @@ $productUrl = Url::previous('product');
Reconocer la relatividad de URLs
--------------------------------
-Para descubrir si una URL es relativa, es decir, que no contenga información del host, se puede utilizar el siguiente
+Para descubrir si una URL es relativa, es decir, que no contenga información del host, se puede utilizar el siguiente
código:
```php
diff --git a/docs/guide-es/images/start-gii-crud-preview.png b/docs/guide-es/images/start-gii-crud-preview.png
new file mode 100644
index 0000000..85c2355
Binary files /dev/null and b/docs/guide-es/images/start-gii-crud-preview.png differ
diff --git a/docs/guide-es/images/start-gii-crud.png b/docs/guide-es/images/start-gii-crud.png
index a3aa21b..77c1ada 100644
Binary files a/docs/guide-es/images/start-gii-crud.png and b/docs/guide-es/images/start-gii-crud.png differ
diff --git a/docs/guide-es/intro-upgrade-from-v1.md b/docs/guide-es/intro-upgrade-from-v1.md
index 8d9bb8b..bcb4df3 100644
--- a/docs/guide-es/intro-upgrade-from-v1.md
+++ b/docs/guide-es/intro-upgrade-from-v1.md
@@ -6,7 +6,7 @@ en su segunda versión.
Como resultado, actualizar desde la versión 1.1 no es tan trivial como actualizar entre versiones menores. En esta
guía encontrarás las diferencias más grandes entre estas dos versiones.
-Si no has utilizado Yii 1.1 antes, puedes saltar con seguridad esta sección e ir directamente a "[Comenzando con Yii](start-installation.md)".
+Si no has utilizado Yii 1.1 antes, puedes saltarte con seguridad esta sección e ir directamente a "[Comenzando con Yii](start-installation.md)".
Es importante anotar que Yii 2.0 introduce más características de las que van a ser cubiertas en este resumen. Es altamente recomendado
que leas a través de toda la guía definitiva para aprender acerca de todas ellas. Hay muchas posibilidades de que algo que hayas desarrollado anteriormente para extender Yii, sea ahora parte del núcleo de la librería.
@@ -18,7 +18,7 @@ Instalación
Yii 2.0 adopta íntegramente [Composer](https://getcomposer.org/), el administrador de paquetes de facto de PHP.
Tanto la instalación del núcleo del framework como las extensiones se manejan a través de Composer. Por favor consulta
la sección [Comenzando con la Aplicación Básica](start-installation.md) para aprender a instalar Yii 2.0. Si quieres crear extensiones
-o transformar extensiones de Yii 1.1 para que sean compatibles con Yii 2.0, consulta la sección [Creando Extensiones](extend-creating-extensions.md) de la guía.
+o transformar extensiones de Yii 1.1 para que sean compatibles con Yii 2.0, consulta la sección [Creando Extensiones](structure-extensions.md#creating-extensions) de la guía.
Requerimientos de PHP
@@ -30,13 +30,13 @@ Abajo hay un resumen de los mayores cambios en relación a PHP:
- [Namespaces](http://php.net/manual/es/language.namespaces.php).
- [Funciones anónimas](http://php.net/manual/es/functions.anonymous.php).
-- Sintáxis cortas de Arrays `[...elementos...]` es utilizado en vez de `array(...elementos...)`.
+- La sintaxis corta de Arrays `[...elementos...]` es utilizada en vez de `array(...elementos...)`.
- Etiquetas cortas de `echo`. Ahora en las vistas se usa `on($eventName, $handler);
Hay muchas mejoras en lo que respecta a eventos. Para más detalles, consulta la sección [Eventos](concept-events.md).
-Path Alias
-----------
+Alias
+-----
-Yii 2.0 extiende el uso de path alias tanto para archivos/directorios como URLs. Yii 2.0 ahora requiere que cada
+Yii 2.0 extiende el uso de alias tanto para archivos/directorios como URLs. Yii 2.0 ahora requiere que cada
alias comience con el carácter `@`, para diferenciarlos de rutas o URLs normales.
-Por ejemplo, el alias `@yii` corresponde al directorio donde Yii se encuentra instalado. Los path alias
+Por ejemplo, el alias `@yii` corresponde al directorio donde Yii se encuentra instalado. Los alias
están soportados en la mayor parte del núcleo. Por ejemplo, [[yii\caching\FileCache::cachePath]] puede tomar tanto
una ruta de directorios normal como un alias.
-Un path alias está relacionado de cerca con un namespace. Se recomienda definir un path alias
+Un alias está estrechamente relacionado con un namespace de la clase. Se recomienda definir un alias
por cada namespace raíz, y así poder utilizar el autolader de Yii sin otra configuración.
Por ejemplo, debido a que `@yii` se refiere al directorio de instalación, una clase
como `yii\web\Request` puede ser auto-cargada. Si estás utilizando una librería de terceros,
-como Zend Framework, puedes definir un path alias `@Zend` que se refiera al directorio de instalación
+como Zend Framework, puedes definir un alias `@Zend` que se refiera al directorio de instalación
de ese framework. Una vez realizado esto, Yii será capaz de auto-cargar cualquier clase de Zend Framework también.
-Se puede encontrar más detalles del tema en la sección [Path Alias](concept-aliases.md).
+Se puede encontrar más detalles del tema en la sección [Alias](concept-aliases.md).
Vistas
------
-El cambio más significativo con respecto a las vistas en Yii 2 es que la variable especial `$this` (dentro de una vista)
+El cambio más significativo con respecto a las vistas en Yii 2 es que la variable especial `$this` dentro de una vista
ya no se refiere al controlador o widget actual.
En vez de eso, `$this` ahora se refiere al objeto de la *vista*, un concepto nuevo introducido en Yii 2.0.
-El objeto *vista* es del tipo [[yii\web\View]], que representa la parte de las vistas en el patrón MVC.
-of the MVC pattern. Si quieres acceder al controlador o al widget correspondiente desde la propia vista,
+El objeto *vista* es del tipo [[yii\web\View]], que representa la parte de las vistas en el patrón MVC. Si
+quieres acceder al controlador o al widget correspondiente desde la propia vista,
puedes utilizar `$this->context`.
Para renderizar una vista parcial (partial) dentro de otra vista, se utiliza `$this->render()`, no `$this->renderPartial()`.
@@ -179,10 +179,10 @@ Modelos
-------
Yii 2.0 utiliza [[yii\base\Model]] como modelo base, algo similar a `CModel` en 1.1.
-La clase `CFormModel` ha sido descartada por completo. Ahora, en Yii 2 debes extender [[yii\base\Model]] para crear clases de modelos.
+La clase `CFormModel` ha sido descartada por completo. Ahora, en Yii 2 debes extender de [[yii\base\Model]] para crear clases de modelos basados en formularios.
Yii 2.0 introduce un nuevo método llamado [[yii\base\Model::scenarios()|scenarios()]] para declarar escenarios soportados,
-y para indicar bajo qué escenario un atributo necesita ser validado, puede ser considerado seguro o no, etc. Por ejemplo:
+y para indicar bajo que escenario un atributo necesita ser validado, puede ser considerado seguro o no, etc. Por ejemplo:
```php
public function scenarios()
@@ -204,7 +204,7 @@ Ten en cuenta que dada la introducción de [[yii\base\Model::scenarios()|scenari
En la mayoría de los casos, no necesitas sobrescribir [[yii\base\Model::scenarios()|scenarios()]] si el método [[yii\base\Model::rules()|rules()]]
especifica completamente los escenarios que existirán, y si no hay necesidad de declarar atributos inseguros (`unsafe`).
-Para aprender más detalles de modelos, consulta la sección [Modelos](basic-models.md).
+Para aprender más detalles de modelos, consulta la sección [Modelos](structure-models.md).
Controladores
@@ -228,7 +228,7 @@ public function actionView($id)
}
```
-Por favor, consulta la sección [Controllers](structure-controllers.md) para más detalles acerca de los controladores.
+Por favor, consulta la sección [Controladores](structure-controllers.md) para más detalles acerca de los controladores.
Widgets
@@ -236,7 +236,7 @@ Widgets
Yii 2.0 utiliza [[yii\base\Widget]] como clase base de los widgets, similar a `CWidget` en Yii 1.1.
-Para obtener mejor soporte del framework en IDEs, Yii 2.0 introduce una nueva sintáxis para utilizar widgets.
+Para obtener mejor soporte del framework en IDEs, Yii 2.0 introduce una nueva sintaxis para utilizar widgets.
Los métodos estáticos [[yii\base\Widget::begin()|begin()]], [[yii\base\Widget::end()|end()]], y [[yii\base\Widget::widget()|widget()]]
fueron incorporados, y deben utilizarse así:
@@ -259,19 +259,19 @@ ActiveForm::end();
Consulta la sección [Widgets](structure-widgets.md) para más detalles.
-Themes
+Temas
------
-Los themes funcionan completamente diferente en Yii 2.0. Ahora están basados en un mecanismo de mapeo de rutas,
-que mapea la ruta de un archivo vista de origen a uno con un theme aplicado. Por ejemplo, si el path map de un theme es
-`['/web/views' => '/web/themes/basic']`, entonces la versión con el theme aplicado del archivo
-`/web/views/site/index.php` será `/web/themes/basic/site/index.php`. Por esta razón, ahora los themes pueden ser
-aplicados a cualquier archivo de vista, incluso una vista renderizada fuera del contexto de un controlador o widget.
+Los temas funcionan completamente diferente en Yii 2.0. Ahora están basados en un mecanismo de mapeo de rutas,
+que mapea la ruta de un archivo de la vista de origen a uno con un tema aplicado. Por ejemplo, si el mapeo de ruta de un tema es
+`['/web/views' => '/web/themes/basic']`, entonces la versión con el tema aplicado del archivo
+`/web/views/site/index.php` será `/web/themes/basic/site/index.php`. Por esta razón, ahora los temas pueden ser
+aplicados a cualquier archivo de la vista, incluso una vista renderizada fuera del contexto de un controlador o widget.
Además, el componente `CThemeManager` ya no existe. En cambio, `theme` es una propiedad configurable del componente `view`
de la aplicación.
-Consulta la sección [Utilizando Themes](tutorial-theming.md) para más detalles.
+Consulta la sección [Temas](output-theming.md) para más detalles.
Aplicaciones de Consola
@@ -304,7 +304,7 @@ Por favor, consulta la sección [Internacionalización](tutorial-i18n.md) para m
Filtros de Acciones
-------------------
-En Yii 2.0, los filtros de acciones son implementados a través de comportamientos (behaviors). Para definir un
+Los filtros de acciones son implementados a través de comportamientos. Para definir un
nuevo filtro personalizado, se debe extender de [[yii\base\ActionFilter]]. Para utilizar el filtro, conecta la clase del filtro
al controlador como un comportamiento. Por ejemplo, para utilizar el filtro [[yii\filters\AccessControl]], deberías tener
el siguiente código en el controlador:
@@ -331,13 +331,13 @@ Assets
Yii 2.0 introduce un nuevo concepto llamado *asset bundle* que reemplaza el concepto de script package encontrado en Yii 1.1.
-Un asset bundle es una colección de assets (ej. archivos JavaScript, archivos CSS, imágenes, etc.) dentro de un directorio.
-Cada asset bundle está representada por una clase que extiende de [[yii\web\AssetBundle]].
+Un asset bundle es una colección de archivos assets (ej. archivos JavaScript, archivos CSS, imágenes, etc.) dentro de un directorio.
+Cada asset bundle está representado por una clase que extiende de [[yii\web\AssetBundle]].
Al registrar un asset bundle a través de [[yii\web\AssetBundle::register()]], haces que los assets de dicho bundle sean accesibles
vía Web. A diferencia de Yii 1, la página que registra el bundle contendrá automáticamente las referencias a los archivos
JavaScript y CSS especificados en el bundle.
-Por favor, consulta la sección [Manejando Assets](output-assets.md) para más detalles.
+Por favor, consulta la sección [Manejando Assets](structure-assets.md) para más detalles.
Helpers
@@ -356,10 +356,10 @@ Por favor, consulta la sección [Información General de Helpers](helper-overvie
Formularios
-----------
-Yii 2.0 introduce el concepto de *campo* (field) para construir formularios utilizando [[yii\widgets\ActiveForm]]. Un campo (field)
+Yii 2.0 introduce el concepto de *campo* (field) para construir formularios utilizando [[yii\widgets\ActiveForm]]. Un campo
es un contenedor que consiste en una etiqueta, un input, un mensaje de error y/o texto de ayuda.
Un campo es representado como un objeto [[yii\widgets\ActiveField|ActiveField]].
-Utilizando estos campos, puedes crear formularios más claramente que antes:
+Utilizando estos campos, puedes crear formularios más legibles que antes:
```php
@@ -374,12 +374,12 @@ Utilizando estos campos, puedes crear formularios más claramente que antes:
Por favor, consulta la sección [Creando Formularios](input-forms.md) para más detalles.
-Query Builder
--------------
+Constructor de Consultas
+------------------------
En Yii 1.1, la generación de consultas a la base de datos estaba dividida en varias clases, incluyendo `CDbCommand`,
`CDbCriteria`, y `CDbCommandBuilder`. Yii 2.0 representa una consulta a la base de datos en términos de un objeto [[yii\db\Query|Query]]
-que puede ser convertido en una declaración SQL con la ayuda de [[yii\db\QueryBuilder|QueryBuilder]] detrás de escena.
+que puede ser convertido en una declaración SQL con la ayuda de [[yii\db\QueryBuilder|QueryBuilder]] detrás de la escena.
Por ejemplo:
```php
@@ -395,7 +395,7 @@ $rows = $command->queryAll();
Lo mejor de todo, dichos métodos de generación de consultas pueden ser también utilizados mientras se trabaja con [Active Record](db-active-record.md).
-Consulta la sección [Query Builder](db-query-builder.md) para más detalles.
+Consulta la sección [Constructor de Consultas](db-query-builder.md) para más detalles.
Active Record
@@ -409,7 +409,7 @@ y por lo tanto hereda todos los métodos de generación de consultas.
Para comenzar a generar una consulta, llamas al método [[yii\db\ActiveRecord::find()]]:
```php
-// Para traer todos los clientes *activos* y ordenarlos por su ID:
+// Recibe todos los clientes *activos* y ordenados por su ID:
$customers = Customer::find()
->where(['status' => $active])
->orderBy('id')
@@ -431,27 +431,27 @@ class Customer extends \yii\db\ActiveRecord
```
Ahora puedes utilizar `$customer->orders` para acceder a las órdenes de la tabla relacionada. También puedes utilizar el siguiente
-código para realizar una consulta 'al-vuelo' relacionada con una condición personalizada:
+código para realizar una consulta relacional 'al-vuelo' con una condición personalizada:
```php
$orders = $customer->getOrders()->andWhere('status=1')->all();
```
-Cuando se utiliza la carga temprana de la relación, Yii 2.0 lo hace diferente de 1.1. En particular, en 1.1 una declaración JOIN
+Cuando se utiliza la carga temprana (eager loading) de la relación, Yii 2.0 lo hace diferente de 1.1. En particular, en 1.1 una declaración JOIN
sería creada para seleccionar tanto los registros de la tabla primaria como los relacionados. En Yii 2.0, dos declaraciones SQL son ejecutadas
-sin utilizar un JOIN: la primera traer todos los modelos primarios, mientras que la segunda trae los registros relacionados
+sin utilizar un JOIN: la primera trae todos los modelos primarios, mientras que la segunda trae los registros relacionados
utilizando como condición la clave primaria de los primarios.
En vez de devolver objetos [[yii\db\ActiveRecord|ActiveRecord]], puedes conectar el método [[yii\db\ActiveQuery::asArray()|asArray()]]
mientras generas una consulta que devuelve un gran número de registros. Esto causará que el resultado de la consulta sea devuelto como
-matrices (arrays), lo que puede reducir significativamente la necesidad de tiempo de CPU y memoria si el número de registros es grande.
+arrays, lo que puede reducir significativamente la necesidad de tiempo de CPU y memoria si el número de registros es grande.
Por ejemplo:
```php
$customers = Customer::find()->asArray()->all();
```
-Otro cambio es que ya no puedes definir valores por defecto a los atributos a través de propiedades publicas.
+Otro cambio es que ya no puedes definir valores por defecto a los atributos a través de propiedades públicas.
Si lo necesitaras, debes definirlo en el método `init` de la clase del registro en cuestión.
```php
@@ -469,21 +469,51 @@ Hay muchos otros cambios y mejoras con respecto a ActiveRecord. Por favor, consu
la sección [Active Record](db-active-record.md) para más detalles.
+Active Record Behaviors
+-----------------------
+
+En 2.0, hemos eliminado la clase del comportamiento base `CActiveRecordBehavior`. Si desea crear un comportamiento Active Record, usted tendrá que extender directamente de `yii\base\Behavior`. Si la clase de comportamiento debe responder a algunos eventos propios, usted tiene que sobrescribir los métodos `events()` como se muestra a continuación,
+
+```php
+namespace app\components;
+
+use yii\db\ActiveRecord;
+use yii\base\Behavior;
+
+class MyBehavior extends Behavior
+{
+ // ...
+
+ public function events()
+ {
+ return [
+ ActiveRecord::EVENT_BEFORE_VALIDATE => 'beforeValidate',
+ ];
+ }
+
+ public function beforeValidate($event)
+ {
+ // ...
+ }
+}
+```
+
+
User e IdentityInterface
------------------------
La clase `CWebUser` de 1.1 es reemplazada por [[yii\web\User]], y la clase `CUserIdentity` ha dejado de existir.
-En cambio, ahora debes implementar [[yii\web\IdentityInterface]] lo que es mucho más directo para usar.
-El template de Aplicación Avanzada provee un ejemplo así.
+En cambio, ahora debes implementar [[yii\web\IdentityInterface]] el cual es mucho más directo de usar.
+La plantilla de Aplicación Avanzada provee un ejemplo así.
-Consulta las secciones [Autenticación](security-authentication.md), [Autorización](security-authorization.md), y [Template de Aplicación Avanzanda](tutorial-advanced-app.md) para más detalles.
+Consulta las secciones [Autenticación](security-authentication.md), [Autorización](security-authorization.md), y [Plantilla de Aplicación Avanzada](tutorial-advanced-app.md) para más detalles.
Manejo de URLs
--------------
El manejo de URLs en Yii 2 es similar al de 1.1. Una mejora mayor es que el manejador actual ahora soporta parámetros opcionales.
-Por ejemplo, si tienes una regla declarada como a continuación, entonces coincidirá tanto con `post/popular` como `post/1/popular`.
+Por ejemplo, si tienes una regla declarada como a continuación, entonces coincidirá tanto con `post/popular` como con `post/1/popular`.
En 1.1, tendrías que haber creado dos reglas diferentes para obtener el mismo resultado
```php
@@ -494,11 +524,11 @@ En 1.1, tendrías que haber creado dos reglas diferentes para obtener el mismo r
]
```
-Por favor, consulta la sección [Documentación del Manejo de URLs](url.md) para más detalles.
+Por favor, consulta la sección [Documentación del Manejo de URLs](runtime-routing.md) para más detalles.
Utilizando Yii 1.1 y 2.x juntos
-------------------------------
Si tienes código en Yii 1.1 que quisieras utilizar junto con Yii 2.0, por favor consulta
-la sección [Using Yii 1.1 and 2.0 Together](extend-using-v1-v2.md).
+la sección [Utilizando Yii 1.1 y 2.0 juntos](tutorial-yii-integration.md).
diff --git a/docs/guide-es/intro-yii.md b/docs/guide-es/intro-yii.md
index 453eb4b..495aba0 100644
--- a/docs/guide-es/intro-yii.md
+++ b/docs/guide-es/intro-yii.md
@@ -1,50 +1,52 @@
¿Qué es Yii?
============
-Yii es un marco de programación del lenguaje PHP de alto rendimiento, basado en componentes para desarrollar aplicaciones web
-modernas en poco tiempo. El nombre Yii significa "simple y evolutivo" en chino; también se puede considerar como un acrónimo
+Yii es un framework de PHP de alto rendimiento, basado en componentes para desarrollar aplicaciones web
+modernas en poco tiempo. El nombre Yii significa "simple y evolutivo" en chino. También se puede considerar como un acrónimo
de _**Yes It Is**_ (que en inglés significa _**Sí, eso es**_)!
¿En qué es mejor Yii?
-----------------------
-Yii es un marco genérico de programación web, lo que significa que se puede utilizar para desarrollar todo tipo de aplicaciones web en PHP.
-Debido a su arquitectura basada en componentes y a su sofisticada compatibilidad de caché, es especialmente apropiado para el desarrollo
-de aplicaciones de gran envergadura, como portales, foros, sistemas de gestión de contenidos (CMS), proyectos de comercio electrónico,
+Yii es un framework genérico de programación web, lo que significa que se puede utilizar para desarrollar todo tipo de aplicaciones web en PHP.
+Debido a su arquitectura basada en componentes y a su sofisticada compatibilidad de caché, es especialmente apropiado para el desarrollo
+de aplicaciones de gran envergadura, como portales, foros, sistemas de gestión de contenidos (CMS), proyectos de comercio electrónico,
servicios web compatibles con la arquitectura REST y muchas más.
-¿Cómo se compara Yii con otros marcos?
+¿Cómo se compara Yii con otros frameworks?
--------------------------------------
-- Como la mayoría de los marcos de PHP, Yii implementa el patrón de diseño MVC (Modelo-Vista-Controlador) y promueve la organización de código basada en este patrón.
+Si estás familiarizado con otros framework, puedes apreciar como se compara Yii con ellos:
+
+- Como la mayoría de los framework de PHP, Yii implementa el patrón de diseño MVC (Modelo-Vista-Controlador) y promueve la organización de código basada en este patrón.
- La filosofía de Yii consiste en escribir el código de manera simple y elegante, sin sobrediseñar nunca por el mero hecho de seguir un patrón de diseño determinado.
-- Yii es un marco completo que provee muchas características probadas y listas para usar, como los constructores de consultas y la clase ActiveRecord para las bases de datos relacionales y NoSQL, la compatibilidad con la arquitectura REST para desarrollar API, la compatibilidad de caché en varios niveles y muchas más.
-- Yii es extremadamente extensible; se puede personalizar o reemplazar prácticamente cualquier pieza de código de base, como se puede también aprovechar su sólida arquitectura de extensiones para utilizar o desarrollar extensiones distribuibles.
+- Yii es un framework completo que provee muchas características probadas y listas para usar, como los constructores de consultas y la clase ActiveRecord para las bases de datos relacionales y NoSQL, la compatibilidad con la arquitectura REST para desarrollar API, la compatibilidad de caché en varios niveles y muchas más.
+- Yii es extremadamente extensible. Puedes personalizar o reemplazar prácticamente cualquier pieza de código de base, como se puede también aprovechar su sólida arquitectura de extensiones para utilizar o desarrollar extensiones distribuibles.
- El alto rendimiento es siempre la meta principal de Yii.
-Detrás de Yii hay un [sólido equipo de desarrollo][], así como una gran comunidad en la que numerosos profesionales contribuyen constantemente a su desarrollo.
-El equipo de desarrollo de Yii se mantiene atento a las últimas tendencias de desarrollo web, así como a las mejores prácticas y características de otros marcos y proyectos.
-Las buenas prácticas más relevantes de otros proyectos se incorporan regularmente a la base del marco y se exponen a través de interfaces simples y elegantes.
+Yii no es un proyecto de un sola persona, detrás de Yii hay un [sólido equipo de desarrollo][about_yii], así como una gran comunidad en la que numerosos profesionales contribuyen constantemente a su desarrollo.
+El equipo de desarrollo de Yii se mantiene atento a las últimas tendencias de desarrollo web, así como a las mejores prácticas y características de otros frameworks y proyectos.
+Las buenas prácticas y características más relevantes de otros proyectos se incorporan regularmente a la base del framework y se exponen a través de interfaces simples y elegantes.
-[sólido equipo de desarrollo]: http://www.yiiframework.com/about/
+[about_yii]: http://www.yiiframework.com/about/
Versiones de Yii
----------------
-Actualmente existen dos versiones principales de Yii: la versión 1.1 y la versión 2.0. Para la versión 1.1, que es de la generación anterior, actualmente solo se ofrece mantenimiento.
-La versión 2.0 está completamente reescrita y adopta las últimas tecnologías y protocolos, incluidos Composer, PSR, espacio de nombres, rasgos, etc.
-Esta versión representa la última generación del marco y su desarrollo recibirá nuestro principal esfuerzo en los próximos años.
-Esta guía está basada principalmente en la versión 2.0 del marco.
+Actualmente existen dos versiones principales de Yii: la versión 1.1 y la versión 2.0. Para la versión 1.1, que es de la generación anterior, actualmente solo se ofrece mantenimiento.
+La versión 2.0 está completamente reescrita y adopta las últimas tecnologías y protocolos, incluidos Composer, PSR, namespaces, traits, etc.
+La versión 2.0 representa la actual generación del framework y su desarrollo recibirá el principal esfuerzo en los próximos años.
+Esta guía está basada principalmente en la versión 2.0. del framework.
Requisitos
-----------
-Yii 2.0 requiere PHP 5.4.0 o una versión posterior. Se pueden encontrar requisitos más detallados de características individuales
-ejecutando el programa de comprobación incluido en cada lanzamiento de Yii.
+Yii 2.0 requiere PHP 5.4.0 o una versión posterior. Se pueden encontrar requisitos más detallados de características individuales
+ejecutando el script de comprobación incluido en cada release de Yii.
-Para utilizar Yii se requieren conocimientos básicos de programación orientada a objetos (POO), porque el marco Yii se basa íntegramente en esta tecnología.
-Yii 2.0 hace uso también de las últimas características de PHP, como [espacios de nombres](http://www.php.net/manual/en/language.namespaces.php)
-y [rasgos](http://www.php.net/manual/en/language.oop5.traits.php). Comprender estos conceptos ayuda a entender Yii 2.0.
+Para utilizar Yii se requieren conocimientos básicos de programación orientada a objetos (POO), porque el framework Yii se basa íntegramente en esta tecnología.
+Yii 2.0 hace uso también de las últimas características de PHP, como [namespaces](http://www.php.net/manual/es/language.namespaces.php)
+y [traits](http://www.php.net/manual/es/language.oop5.traits.php). Comprender estos conceptos te ayudará a entender mejor Yii 2.0.
diff --git a/docs/guide-es/output-theming.md b/docs/guide-es/output-theming.md
new file mode 100644
index 0000000..18a7d45
--- /dev/null
+++ b/docs/guide-es/output-theming.md
@@ -0,0 +1,99 @@
+Temas
+=====
+
+> Nota: Esta sección está en desarrollo.
+
+Un tema (theme) es un directorio de archivos y de vistas (views) y layouts. Cada archivo de este directorio
+sobrescribe el archivo correspondiente de una aplicación cuando se renderiza. Una única aplicación puede usar
+múltiples temas para que pueden proporcionar experiencias totalmente diferentes. Solo se puede haber un único tema
+activo.
+
+> Nota: Los temas no están destinados a ser redistribuidos ya que están demasiado ligados a la aplicación. Si se
+ quiere redistribuir una apariencia personalizada, se puede considerar la opción de
+ [asset bundles](structure-assets.md) de archivos CSS y Javascript.
+
+Configuración de un Tema
+------------------------
+
+La configuración de un tema se especifica a través del componente `view` de la aplicación. Para establecer que un tema
+trabaje con vistas de aplicación básicas, la configuración de la aplicación debe contener lo siguiente:
+
+```php
+'components' => [
+ 'view' => [
+ 'theme' => [
+ 'pathMap' => ['@app/views' => '@app/themes/basic'],
+ 'baseUrl' => '@web/themes/basic',
+ ],
+ ],
+],
+```
+
+En el ejemplo anterior, el `pathMap` define un mapa (map) de las rutas a las que se aplicará el tema mientras que
+`baseUrl` define la URL base para los recursos a los que hacen referencia los archivos del tema.
+
+En nuestro caso `pathMap` es `['@app/views' => '@app/themes/basic']`. Esto significa que cada vista de `@app/views`
+primero se buscará en `@app/themes/basic` y si existe, se usará la vista del directorio del tema en lugar de la vista
+original.
+
+Por ejemplo, con la configuración anterior, la versión del tema para la vista `@app/views/site/index.php` será
+`@app/themes/basic/site/index.php`. Básicamente se reemplaza `@app/views` en `@app/views/site/index.php` por
+`@app/themes/basic`.
+
+### Temas para Módulos
+
+Para utilizar temas en los módulos, el `pathMap` debe ser similar al siguiente:
+
+```php
+'components' => [
+ 'view' => [
+ 'theme' => [
+ 'pathMap' => [
+ '@app/views' => '@app/themes/basic',
+ '@app/modules' => '@app/themes/basic/modules', // <-- !!!
+ ],
+ ],
+ ],
+],
+```
+
+Esto permite aplicar el tema a `@app/modules/blog/views/comment/index.php` con la vista
+`@app/themes/basic/modules/blog/views/comment/index.php`.
+
+### Temas para Widgets
+
+Para utilizar un tema en una vista que se encuentre en `@app/widgets/currency/views/index.php`, se debe aplicar la
+siguiente configuración para el componente vista, tema:
+
+```php
+'components' => [
+ 'view' => [
+ 'theme' => [
+ 'pathMap' => ['@app/widgets' => '@app/themes/basic/widgets'],
+ ],
+ ],
+],
+```
+
+Con la configuración anterior, se puede crear una versión de la vista `@app/widgets/currency/index.php` para que se
+aplique el tema en `@app/themes/basic/widgets/currency/index.php`.
+
+Uso de Multiples Rutas
+----------------------
+
+Es posible mapear una única ruta a múltiples rutas de temas. Por ejemplo:
+
+```php
+'pathMap' => [
+ '@app/views' => [
+ '@app/themes/christmas',
+ '@app/themes/basic',
+ ],
+]
+```
+
+En este caso, primero se buscara la vista en `@app/themes/christmas/site/index.php`, si no se encuentra, se intentará
+en `@app/themes/basic/site/index.php`. Si la vista no se encuentra en ninguna de rutas especificadas, se usará la
+vista de aplicación.
+
+Esta capacidad es especialmente útil si se quieren sobrescribir algunas rutas temporal o condicionalmente.
\ No newline at end of file
diff --git a/docs/guide-es/rest-authentication.md b/docs/guide-es/rest-authentication.md
index ce046ff..d97036e 100644
--- a/docs/guide-es/rest-authentication.md
+++ b/docs/guide-es/rest-authentication.md
@@ -111,7 +111,7 @@ y entonces ejecutar la acción. La identidad del usuario autenticado puede ser r
Si la autenticación falla, una respuesta con estado HTTP 401 será devuelta junto con otras cabeceras apropiadas (tal como la cabecera para autenticación básica HTTP `WWW-Authenticate`).
-## Autorización
+## Autorización
Después de que un usuario se ha autenticado, probablementer querrás comprobar si él o ella tiene los permisos para realizar
la acción solicitada. Este proceso es llamado *autorización (authorization)* y está cubierto en detalle en la [Sección de Autorización](security-authorization.md).
diff --git a/docs/guide-es/rest-controllers.md b/docs/guide-es/rest-controllers.md
index b16c9f8..1177cda 100644
--- a/docs/guide-es/rest-controllers.md
+++ b/docs/guide-es/rest-controllers.md
@@ -25,7 +25,7 @@ algunas de las cuales se describen en detalle en las siguientes secciones:
* La autorización del usuario de acuerdo a la acción y recurso solicitado.
-## Creando Clases de Controlador
+## Creando Clases de Controlador
Al crear una nueva clase de controlador, una convención para nombrar la clase del controlador es utilizar
el nombre del tipo de recurso en singular. Por ejemplo, para servir información de usuario,
@@ -45,7 +45,7 @@ public function actionView($id)
```
-## Filtros
+## Filtros
La mayoría de las características API REST son proporcionadas por [[yii\rest\Controller]] son implementadas en los términos de [filtros](structure-filters.md).
En particular, los siguientes filtros se ejecutarán en el orden en que aparecen:
@@ -76,14 +76,14 @@ public function behaviors()
```
-## Extendiendo `ActiveController`
+## Extendiendo `ActiveController`
Si tu clase controlador extiende de [[yii\rest\ActiveController]], debe establecer
su propiedad [[yii\rest\ActiveController::modelClass||modelClass]] con el nombre de la clase del recurso
que planeas servir a través de este controlador. La clase debe extender de [[yii\db\ActiveRecord]].
-### Personalizando Acciones
+### Personalizando Acciones
Por defecto, [[yii\rest\ActiveController]] provee de las siguientes acciones:
@@ -120,7 +120,7 @@ public function prepareDataProvider()
Por favor, consulta las referencias de clases de acciones individuales para aprender las opciones de configuración disponibles para cada una.
-### Realizando Comprobación de Acceso
+### Realizando Comprobación de Acceso
Al exponer los recursos a través de RESTful APIs, a menudo es necesario comprobar si el usuario actual tiene permiso
para acceder y manipular el/los recurso solicitado/s. Con [[yii\rest\ActiveController]], esto puede lograrse
diff --git a/docs/guide-es/rest-error-handling.md b/docs/guide-es/rest-error-handling.md
index a8b1dda..092a6ab 100644
--- a/docs/guide-es/rest-error-handling.md
+++ b/docs/guide-es/rest-error-handling.md
@@ -40,7 +40,7 @@ La siguiente lista sumariza los códigos de estado HTTP que son usados por el fr
* `500`: Error interno del servidor. Esto puede estar causado por errores internos del programa.
-## Personalizando la Respuesta al Error
+## Personalizando la Respuesta al Error
A veces puedes querer personalizar el formato de la respuesta del error por defecto . Por ejemplo, en lugar de depender
del uso de diferentes estados HTTP para indicar los diferentes errores, puedes querer usar siempre el estado HTTP 200
diff --git a/docs/guide-es/rest-quick-start.md b/docs/guide-es/rest-quick-start.md
index c4f385c..836292f 100644
--- a/docs/guide-es/rest-quick-start.md
+++ b/docs/guide-es/rest-quick-start.md
@@ -23,7 +23,7 @@ Supongamos que deseas exponer los datos de los usuarios vía APIs RESTful. Los d
y ya tienes creado la clase [[yii\db\ActiveRecord|ActiveRecord]] `app\models\User` para acceder a los datos del usuario.
-## Creando un controlador
+## Creando un controlador
Primero, crea una clase controladora `app\controllers\UserController` como la siguiente,
@@ -42,7 +42,7 @@ La clase controladora extiende de [[yii\rest\ActiveController]]. Especificado po
como `app\models\User`, el controlador sabe que modelo puede ser usado para recoger y manipular sus datos.
-## Configurando las reglas de las URL
+## Configurando las reglas de las URL
A continuación, modifica la configuración del componente `urlManager` en la configuración de tu aplicación:
@@ -61,7 +61,7 @@ La configuración anterior principalmente añade una regla URL para el controlad
que los datos de user pueden ser accedidos y manipulados con URLs amigables y verbos HTTP significativos.
-## Habilitando entradas JSON
+## Habilitando entradas JSON
Para permitir que la API acepte datos de entrada con formato JSON, configura la propiedad [[yii\web\Request::$parsers|parsers]]
del componente de aplicación `request` para usar [[yii\web\JsonParser]] para entradas JSON:
@@ -78,7 +78,7 @@ del componente de aplicación `request` para usar [[yii\web\JsonParser]] para en
`application/x-www-form-urlencoded` y `multipart/form-data` como formatos de entrada.
-## Probándolo
+## Probándolo
Con la mínima cantidad de esfuerzo, tienes ya finalizado tu tarea de crear las APIs RESTful
para acceder a los datos de user. Las APIs que tienes creado incluyen:
@@ -188,7 +188,7 @@ Por ejemplo, la URL `http://localhost/users?fields=id,email` sólo devolverá lo
> Puedes y deberías filtrar estos campos como se describe en la sección [Response Formatting](rest-response-formatting.md).
-## Resumen
+## Resumen
Utilizando el framework Yii API RESTful, implementa un punto final API en términos de una acción de un controlador, y utiliza
un controlador para organizar las acciones que implementan los puntos finales para un sólo tipo de recurso.
diff --git a/docs/guide-es/rest-resources.md b/docs/guide-es/rest-resources.md
index a0785ce..3d8979e 100644
--- a/docs/guide-es/rest-resources.md
+++ b/docs/guide-es/rest-resources.md
@@ -12,7 +12,7 @@ Mientras que no hay restricción a cómo representar un recurso, en YII usualmen
En esta sección, vamos principalmente a describir como la clase con recursos que extiende de [[yii\base\Model]] (o sus clases hijas) puede especificar qué datos puede ser devueltos vía las APIs RESTful. Si la clase de los recursos no extiende de [[yii\base\Model]], entonces todas las variables públicas miembro serán devueltas.
-## Campos (fields)
+## Campos (fields)
Cuando incluimos un recurso en una respuesta de la API RESTful, el recurso necesita ser serializado en una cadena.
Yii divide este proceso en dos pasos. Primero, el recurso es convertido en un array por [[yii\rest\Serializer]].
@@ -37,7 +37,7 @@ http://localhost/users?fields=id,email&expand=profile
```
-### Sobreescribiendo `fields()`
+### Sobreescribiendo `fields()`
Por defecto, [[yii\base\Model::fields()]] devuelve todos los atributos de los modelos como si fueran campos, mientras [[yii\db\ActiveRecord::fields()]] sólo devuelve los atributos que tengan datos en la base de datos.
@@ -79,7 +79,7 @@ public function fields()
> quitar `auth_key`, `password_hash` y `password_reset_token`.
-### Sobreescribiendo `extraFields()`
+### Sobreescribiendo `extraFields()`
Por defecto, [[yii\base\Model::extraFields()]] no devuelve nada, mientras que [[yii\db\ActiveRecord::extraFields()]] devuelve los nombres de las relaciones que tienen datos (populated) obtenidos de la base de datos.
@@ -114,7 +114,7 @@ la petición `http://localhost/users?fields=id,email&expand=profile` puede devol
```
-## Enlaces (Links)
+## Enlaces (Links)
[HATEOAS](http://en.wikipedia.org/wiki/HATEOAS), es una abreviación de Hipermedia es el Motor del Estado de la Aplicación (Hypermedia as the Engine of Application State), promueve que las APIs RESTfull devuelvan información que permita a los clientes descubrir las acciones que soportan los recursos devueltos. El sentido de HATEOAS es devolver un conjunto de hiperenlaces con relación a la información, cuando los datos de los recursos son servidos por las APIs.
@@ -145,14 +145,16 @@ Cuando un objeto `User` es devuelto en una respuesta, puede contener un elemento
"id": 100,
"email": "user@example.com",
// ...
- "_links" => [
- "self": "https://example.com/users/100"
- ]
+ "_links" => {
+ "self": {
+ "href": "https://example.com/users/100"
+ }
+ }
}
```
-## Colecciones
+## Colecciones
Los objetos de los recursos pueden ser agrupados en *collections*. Cada colección contiene una lista de recursos objeto del mismo tipo.
diff --git a/docs/guide-es/rest-response-formatting.md b/docs/guide-es/rest-response-formatting.md
index f60db36..2b8826a 100644
--- a/docs/guide-es/rest-response-formatting.md
+++ b/docs/guide-es/rest-response-formatting.md
@@ -13,7 +13,7 @@ con el formato de la respuesta:
componente de la aplicación [[yii\web\Response::formatters|response]].
-## Negociación de contenido (Content Negotiation)
+## Negociación de contenido (Content Negotiation)
Yii soporta la negociación de contenido a través del filtro [[yii\filters\ContentNegotiator]]. La clase de controlador base
del API RESTful [[yii\rest\Controller]] está equipada con este filtro bajo el nombre `contentNegotiator`.
@@ -81,7 +81,7 @@ Las claves de la propiedad `formats` son los tipos MIME soportados, mientras que
los cuales deben ser soportados en [[yii\web\Response::formatters]].
-## Serialización de Datos
+## Serialización de Datos
Como hemos descrito antes, [[yii\rest\Serializer]] es la pieza central responsable de convertir
objetos recurso o colecciones en arrays. Reconoce objetos tanto implementando [[yii\base\ArrayableInterface]]
@@ -136,9 +136,15 @@ Content-Type: application/json; charset=UTF-8
...
],
"_links": {
- "self": "http://localhost/users?page=1",
- "next": "http://localhost/users?page=2",
- "last": "http://localhost/users?page=50"
+ "self": {
+ "href": "http://localhost/users?page=1"
+ },
+ "next": {
+ "href": "http://localhost/users?page=2"
+ },
+ "last": {
+ "href": "http://localhost/users?page=50"
+ }
},
"_meta": {
"totalCount": 1000,
diff --git a/docs/guide-es/runtime-handling-errors.md b/docs/guide-es/runtime-handling-errors.md
index c07f137..e7cfb15 100644
--- a/docs/guide-es/runtime-handling-errors.md
+++ b/docs/guide-es/runtime-handling-errors.md
@@ -1,24 +1,24 @@
Gestión de Errores
==================
-Yii incluye un [[yii\web\ErrorHandler|error handler]] que permite una gestión de errores mucho más práctica que
+Yii incluye un [[yii\web\ErrorHandler|error handler]] que permite una gestión de errores mucho más práctica que
anteriormente. En particular, el gestor de errores de Yii hace lo siguiente para mejorar la gestión de errores:
-* Todos los errores no fatales (p. ej. advertencias (warning), avisos (notices)) se convierten en excepciones
+* Todos los errores no fatales (ej. advertencias (warning), avisos (notices)) se convierten en excepciones
capturables.
-* Las excepciones y los errores fatales de PHP se muestran con una pila de llamadas (call stack) de información
+* Las excepciones y los errores fatales de PHP se muestran con una pila de llamadas (call stack) de información
detallada y lineas de código fuente.
* Soporta el uso de [acciones de controlador](structure-controllers.md#actions) dedicadas para mostrar errores.
* Soporta diferentes formatos de respuesta (response) de errores.
-El [[yii\web\ErrorHandler|error handler]] esta habilitado de forma predeterminada. Se puede deshabilitar definiendo la
-constante `YII_ENABLE_ERROR_HANDLER` con valor false en el
+El [[yii\web\ErrorHandler|error handler]] esta habilitado de forma predeterminada. Se puede deshabilitar definiendo la
+constante `YII_ENABLE_ERROR_HANDLER` con valor false en el
[script de entrada (entry script)](structure-entry-scripts.md) de la aplicación.
-## Uso del Gestor de Errores
+## Uso del Gestor de Errores
-El [[yii\web\ErrorHandler|error handler]] se registra como un
-[componente de aplicación](structure-application-components.md) llamado `errorHandler`. Se puede configurar en la
+El [[yii\web\ErrorHandler|error handler]] se registra como un
+[componente de aplicación](structure-application-components.md) llamado `errorHandler`. Se puede configurar en la
configuración de la aplicación como en el siguiente ejemplo:
```php
@@ -31,10 +31,10 @@ return [
];
```
-Con la anterior configuración, el numero del lineas de código fuente que se mostrará en las páginas de excepciones
+Con la anterior configuración, el numero del lineas de código fuente que se mostrará en las páginas de excepciones
será como máximo de 20.
-Como se ha mencionado, el gestor de errores convierte todos los errores de PHP no fatales en excepciones capturables.
+Como se ha mencionado, el gestor de errores convierte todos los errores de PHP no fatales en excepciones capturables.
Esto significa que se puede usar el siguiente código para tratar los errores PHP:
```php
@@ -50,9 +50,9 @@ try {
// la ejecución continua ...
```
-Si se quiere mostrar una página de error que muestra al usuario que su petición no es válida o no es la esperada, se
-puede simplemente lanzar una excepción de tipo [[yii\web\HttpException|HTTP exception]], como podría ser
-[[yii\web\NotFoundHttpException]]. El gestor de errores establecerá correctamente el código de estado HTTP de la
+Si se quiere mostrar una página de error que muestra al usuario que su petición no es válida o no es la esperada, se
+puede simplemente lanzar una excepción de tipo [[yii\web\HttpException|HTTP exception]], como podría ser
+[[yii\web\NotFoundHttpException]]. El gestor de errores establecerá correctamente el código de estado HTTP de la
respuesta y usará la vista de error apropiada para mostrar el mensaje.
```php
@@ -61,34 +61,34 @@ use yii\web\NotFoundHttpException;
throw new NotFoundHttpException();
```
-## Personalizar la Visualización de Errores
+## Personalizar la Visualización de Errores
-El [[yii\web\ErrorHandler|error handler]] ajusta la visualización del error conforme al valor de la constante
-`YII_DEBUG`. Cuando `YII_DEBUG` es `true` (es decir, en modo depuración (debug)), el gestor de errores mostrara las
-excepciones con una pila detallada de información y con lineas de código fuente para ayudar a depurar. Y cuando la
-variable `YII_DEBUG` es `false`, solo se mostrará el mensaje de error para prevenir la revelación de información
+El [[yii\web\ErrorHandler|error handler]] ajusta la visualización del error conforme al valor de la constante
+`YII_DEBUG`. Cuando `YII_DEBUG` es `true` (es decir, en modo depuración (debug)), el gestor de errores mostrara las
+excepciones con una pila detallada de información y con lineas de código fuente para ayudar a depurar. Y cuando la
+variable `YII_DEBUG` es `false`, solo se mostrará el mensaje de error para prevenir la revelación de información
sensible de la aplicación.
-> Información: Si una excepción es descendiente de [[yii\base\UserException]], no se mostrará la pila de llamadas
- independientemente del valor de `YII_DEBUG`. Esto es debido a que se considera que estas excepciones se deben a
+> Información: Si una excepción es descendiente de [[yii\base\UserException]], no se mostrará la pila de llamadas
+ independientemente del valor de `YII_DEBUG`. Esto es debido a que se considera que estas excepciones se deben a
errores cometidos por los usuarios y los desarrolladores no necesitan corregirlas.
-De forma predeterminada, el [[yii\web\ErrorHandler|error handler]] muestra los errores usando dos
+De forma predeterminada, el [[yii\web\ErrorHandler|error handler]] muestra los errores usando dos
[vistas](structure-views.md):
-* `@yii/views/errorHandler/error.php`: se usa cuando deben mostrarse los errores SIN la información de la pila de
+* `@yii/views/errorHandler/error.php`: se usa cuando deben mostrarse los errores SIN la información de la pila de
llamadas. Cuando `YII_DEBUG` es falos, este es el único error que se mostrara.
-* `@yii/views/errorHandler/exception.php`: se usa cuando los errores deben mostrarse CON la información de la pila de
+* `@yii/views/errorHandler/exception.php`: se usa cuando los errores deben mostrarse CON la información de la pila de
llamadas.
-Se pueden configurar las propiedades [[yii\web\ErrorHandler::errorView|errorView]] y
-[[yii\web\ErrorHandler::exceptionView|exceptionView]] el gestor de errores para usar nuestros propias vistas para
+Se pueden configurar las propiedades [[yii\web\ErrorHandler::errorView|errorView]] y
+[[yii\web\ErrorHandler::exceptionView|exceptionView]] el gestor de errores para usar nuestros propias vistas para
personalizar la visualización de los errores.
-### Uso de Acciones de Error
+### Uso de Acciones de Error
-Una mejor manera de personalizar la visualización de errores es usar un [acción](structure-controllers.md) de error
-dedicada. Para hacerlo, primero se debe configurar la propiedad [[yii\web\ErrorHandler::errorAction|errorAction]] del
+Una mejor manera de personalizar la visualización de errores es usar un [acción](structure-controllers.md) de error
+dedicada. Para hacerlo, primero se debe configurar la propiedad [[yii\web\ErrorHandler::errorAction|errorAction]] del
componente `errorHandler` como en el siguiente ejemplo:
```php
@@ -101,8 +101,8 @@ return [
];
```
-La propiedad [[yii\web\ErrorHandler::errorAction|errorAction]] vincula una [ruta](structure-controllers.md#routes) a
-una acción. La configuración anterior declara que cuando un error tiene que mostrarse sin la pila de información de
+La propiedad [[yii\web\ErrorHandler::errorAction|errorAction]] vincula una [ruta](structure-controllers.md#routes) a
+una acción. La configuración anterior declara que cuando un error tiene que mostrarse sin la pila de información de
llamadas, se debe ejecutar la acción `site/error`.
Se puede crear una acción `site/error` como se hace a continuación,
@@ -126,10 +126,10 @@ class SiteController extends Controller
}
```
-El código anterior define la acción `error` usando la clase [[yii\web\ErrorAction]] que renderiza un error usando la
+El código anterior define la acción `error` usando la clase [[yii\web\ErrorAction]] que renderiza un error usando la
vista llamada `error`.
-Además, usando [[yii\web\ErrorAction]], también se puede definir la acción `error` usando un método de acción como en
+Además, usando [[yii\web\ErrorAction]], también se puede definir la acción `error` usando un método de acción como en
el siguiente ejemplo,
```php
@@ -142,24 +142,24 @@ public function actionError()
}
```
-Ahora se debe crear un archivo de vista ubicado en `views/sites/error.php`. En este archivo de vista, se puede acceder
+Ahora se debe crear un archivo de vista ubicado en `views/sites/error.php`. En este archivo de vista, se puede acceder
a las siguientes variables si se define el error como un [[yii\web\ErrorAction]]:
* `name`: el nombre del error;
* `message`: el mensaje del error;
-* `exception`: el objeto de excepción a través del cual se puede obtener más información útil, tal como el código de
+* `exception`: el objeto de excepción a través del cual se puede obtener más información útil, tal como el código de
estado HTTP, el código de error, la pila de llamadas del error, etc.
-> Información: Tanto la [plantilla de aplicación básica](start-installation.md) como la
+> Información: Tanto la [plantilla de aplicación básica](start-installation.md) como la
[plantilla de aplicación avanzada](tutorial-advanced-app.md), ya incorporan la acción de error y la vista de error.
-### Personalizar el Formato de Respuesta de Error
+### Personalizar el Formato de Respuesta de Error
-El gestor de errores muestra los errores de siguiente la configuración del formato de las
-[respuestas](runtime-responses.md). Si el [[yii\web\Response::format response format]] es `html`, se usará la vista de
-error o excepción para mostrar los errores tal y como se ha descrito en la anterior subsección. Para otros tipos de
-formatos de respuesta, el gestor de errores asignara la representación del array de la excepción a la propiedad
-[[yii\web\Response::data]] que posteriormente podrá convertirse al formato deseado. Por ejemplo, si el formato de
+El gestor de errores muestra los errores de siguiente la configuración del formato de las
+[respuestas](runtime-responses.md). Si el [[yii\web\Response::format response format]] es `html`, se usará la vista de
+error o excepción para mostrar los errores tal y como se ha descrito en la anterior subsección. Para otros tipos de
+formatos de respuesta, el gestor de errores asignara la representación del array de la excepción a la propiedad
+[[yii\web\Response::data]] que posteriormente podrá convertirse al formato deseado. Por ejemplo, si el formato de
respuesta es `json`, obtendremos la siguiente respuesta:
```
@@ -177,7 +177,7 @@ Content-Type: application/json; charset=UTF-8
}
```
-Se puede personalizar el formato de respuestas de error respondiendo al evento `beforeSend` del componente `response`
+Se puede personalizar el formato de respuestas de error respondiendo al evento `beforeSend` del componente `response`
en la configuración de la aplicación:
```php
diff --git a/docs/guide-es/runtime-logging.md b/docs/guide-es/runtime-logging.md
index a644fef..505caf0 100644
--- a/docs/guide-es/runtime-logging.md
+++ b/docs/guide-es/runtime-logging.md
@@ -1,75 +1,75 @@
Registro de anotaciones
=======================
-Yii proporciona un poderoso framework dedicado al registro de anotaciones (logging) que es altamente personalizable y
-extensible. Usando este framework se pueden guardar fácilmente anotaciones (logs) de varios tipos de mensajes,
+Yii proporciona un poderoso framework dedicado al registro de anotaciones (logging) que es altamente personalizable y
+extensible. Usando este framework se pueden guardar fácilmente anotaciones (logs) de varios tipos de mensajes,
filtrarlos, y unificarlos en diferentes destinos que pueden ser archivos, bases de datos o emails.
Usar el framework de registro de anotaciones de Yii involucra los siguientes pasos:
* Registrar [mensajes de las anotaciones](#log-messages) en distintos lugares del código;
-* Configurar los [destinos de las anotaciones](#log-targets) en la configuración de la aplicación para filtrar y
+* Configurar los [destinos de las anotaciones](#log-targets) en la configuración de la aplicación para filtrar y
exportar los mensajes de las anotaciones;
-* Examinar los mensajes filtrados de los las anotaciones exportadas para diferentes destinos
- (p. ej. [Yii debugger](tool-debugger.md)).
+* Examinar los mensajes filtrados de los las anotaciones exportadas para diferentes destinos
+ (ej. [Yii debugger](tool-debugger.md)).
En esta sección, se describirán principalmente los dos primeros pasos.
-## Anotación de Messages
+## Anotación de Messages
Registrar mensajes de anotación es tan simple como llamar a uno de los siguientes métodos de registro de anotaciones.
-* [[Yii::trace()]]: registra un mensaje para trazar el funcionamiento de una sección de código. Se usa principalmente
+* [[Yii::trace()]]: registra un mensaje para trazar el funcionamiento de una sección de código. Se usa principalmente
para tareas de desarrollo.
* [[Yii::info()]]: registra un mensaje que transmite información útil.
* [[Yii::warning()]]: registra un mensaje de advertencia que indica que ha sucedido algo inesperado.
* [[Yii::error()]]: registra un error fatal que debe ser investigado tan pronto como sea posible.
-Estos métodos registran mensajes de varios *niveles de severidad* y *categorías*. Comparten el mismo registro de
-función `function ($message, $category = 'application')`, donde `$message` representa el mensaje del registro que
-tiene que ser registrado, mientras que `$category` es la categoría del registro de mensaje. El código del siguiente
+Estos métodos registran mensajes de varios *niveles de severidad* y *categorías*. Comparten el mismo registro de
+función `function ($message, $category = 'application')`, donde `$message` representa el mensaje del registro que
+tiene que ser registrado, mientras que `$category` es la categoría del registro de mensaje. El código del siguiente
ejemplo registra la huella del mensaje para la categoría `application`:
```php
Yii::trace('start calculating average revenue');
```
-> Información: Los mensajes de registro pueden ser tanto cadenas de texto como datos complejos, como arrays u objetos.
- Es responsabilidad de los [destinos de registros](#log-targets) tratar los mensajes de registro de manera apropiada.
- De forma predeterminada, si un mensaje de registro no es una cadena de texto, se exporta como si fuera un string
+> Información: Los mensajes de registro pueden ser tanto cadenas de texto como datos complejos, como arrays u objetos.
+ Es responsabilidad de los [destinos de registros](#log-targets) tratar los mensajes de registro de manera apropiada.
+ De forma predeterminada, si un mensaje de registro no es una cadena de texto, se exporta como si fuera un string
llamando a [[yii\helpers\VarDumper::export()]].
-Para organizar mejor y filtrar los mensajes de registro, se recomienda especificar una categoría apropiada para cada
-mensaje de registro. Se puede elegir un sistema de nombres jerárquicos por categorías que facilite a los
-[destino de registros](#log-targets) el filtrado de mensajes basándose en categorías. Una manera simple pero
-efectiva de organizarlos es usar la constante predefinida (magic constant) de PHP `__METHOD__` como nombre de
+Para organizar mejor y filtrar los mensajes de registro, se recomienda especificar una categoría apropiada para cada
+mensaje de registro. Se puede elegir un sistema de nombres jerárquicos por categorías que facilite a los
+[destino de registros](#log-targets) el filtrado de mensajes basándose en categorías. Una manera simple pero
+efectiva de organizarlos es usar la constante predefinida (magic constant) de PHP `__METHOD__` como nombre de
categoría. Además este es el enfoque que se usa en el código del núcleo (core) del framework Yii. Por ejemplo,
```php
Yii::trace('start calculating average revenue', __METHOD__);
```
-La constante `__METHOD__` equivale al nombre del método (con el prefijo del nombre completo del nombre de clase) donde
-se encuentra la constante. Por ejemplo, es igual a la cadena `'app\controllers\RevenueController::calculate'` si la
+La constante `__METHOD__` equivale al nombre del método (con el prefijo del nombre completo del nombre de clase) donde
+se encuentra la constante. Por ejemplo, es igual a la cadena `'app\controllers\RevenueController::calculate'` si la
linea anterior de código se llamara dentro de este método.
-> Información: Los métodos de registro de anotaciones descritos anteriormente en realidad son accesos directos al
- método [[yii\log\Logger::log()|log()]] del [[yii\log\Logger|logger object]] que es un singleton accesible a través
- de la expresión `Yii::getLogger()`. Cuando se hayan registrado suficientes mensajes o cuando la aplicación haya
- finalizado, el objeto de registro llamará [[yii\log\Dispatcher|message dispatcher]] para enviar los mensajes de
+> Información: Los métodos de registro de anotaciones descritos anteriormente en realidad son accesos directos al
+ método [[yii\log\Logger::log()|log()]] del [[yii\log\Logger|logger object]] que es un singleton accesible a través
+ de la expresión `Yii::getLogger()`. Cuando se hayan registrado suficientes mensajes o cuando la aplicación haya
+ finalizado, el objeto de registro llamará [[yii\log\Dispatcher|message dispatcher]] para enviar los mensajes de
registro registrados a los [destiinos de registros](#log-targets).
-## Destino de Registros
+## Destino de Registros
-Un destino de registro es una instancia de la clase [[yii\log\Target]] o de una clase hija. Este filtra los
-mensajes de registro por sus niveles de severidad y sus categorías y después los exporta a algún medio. Por ejemplo,
-un [[yii\log\DbTarget|database target]] exporta los mensajes de registro filtrados a una tabla de base de datos,
-mientras que un [[yii\log\EmailTarget|email target]] exporta los mensajes de registro a una dirección de correo
+Un destino de registro es una instancia de la clase [[yii\log\Target]] o de una clase hija. Este filtra los
+mensajes de registro por sus niveles de severidad y sus categorías y después los exporta a algún medio. Por ejemplo,
+un [[yii\log\DbTarget|database target]] exporta los mensajes de registro filtrados a una tabla de base de datos,
+mientras que un [[yii\log\EmailTarget|email target]] exporta los mensajes de registro a una dirección de correo
electrónico específica.
-Se pueden registrar múltiples destinos de registros en una aplicación configurándolos en la
-[aplicación de componente](structure-application-components.md) `log` dentro de la configuración de aplicación, como
+Se pueden registrar múltiples destinos de registros en una aplicación configurándolos en la
+[aplicación de componente](structure-application-components.md) `log` dentro de la configuración de aplicación, como
en el siguiente ejemplo:
```php
@@ -100,17 +100,17 @@ return [
];
```
-> Nota: El componente `log` debe cargarse durante el proceso de [bootstrapping](runtime-bootstrapping.md) para que
-pueda enviar los mensajes de registro a los destinos inmediatamente. Este es el motivo por el que se lista en el
+> Nota: El componente `log` debe cargarse durante el proceso de [bootstrapping](runtime-bootstrapping.md) para que
+pueda enviar los mensajes de registro a los destinos inmediatamente. Este es el motivo por el que se lista en el
array `bootstrap` como se muestra más arriba.
En el anterior código, se registran dos destinos de registros en la propiedad [[yii\log\Dispatcher::targets]]
* el primer destino gestiona los errores y las advertencias y las guarda en una tabla de la base de datos;
-* el segundo destino gestiona mensajes los mensajes de error de las categorías cuyos nombres empiecen por
+* el segundo destino gestiona mensajes los mensajes de error de las categorías cuyos nombres empiecen por
`yii\db\` y los envía por email a las direcciones `admin@example.com` y `developer@example.com`.
-Yii incluye los siguientes destinos. En la API de documentación se pueden referencias a estas clases e
+Yii incluye los siguientes destinos. En la API de documentación se pueden referencias a estas clases e
información de configuración y uso.
* [[yii\log\DbTarget]]: almacena los mensajes de registro en una tabla de la base de datos.
@@ -120,10 +120,10 @@ información de configuración y uso.
A continuación, se describirá las características más comunes de todos los destinos de registros.
-### Filtrado de Mensajes
+### Filtrado de Mensajes
-Se pueden configurar las propiedades [[yii\log\Target::levels|levels]] y [[yii\log\Target::categories|categories]]
-para cada destino de registros, con estas se especifican los niveles de severidad y las categorías de mensajes que
+Se pueden configurar las propiedades [[yii\log\Target::levels|levels]] y [[yii\log\Target::categories|categories]]
+para cada destino de registros, con estas se especifican los niveles de severidad y las categorías de mensajes que
deberán procesar sus destinos.
La propiedad [[yii\log\Target::levels|levels]] es un array que consta de uno o varios de los siguientes valores:
@@ -132,29 +132,29 @@ La propiedad [[yii\log\Target::levels|levels]] es un array que consta de uno o v
* `warning`: correspondiente a los mensajes registrados por [[Yii::warning()]].
* `info`: correspondiente a los mensajes registrados por [[Yii::info()]].
* `trace`: correspondiente a los mensajes registrados por [[Yii::trace()]].
-* `profile`: correspondiente a los mensajes registrados por [[Yii::beginProfile()]] y [[Yii::endProfile()]], que se
- explicará más detalladamente en la subsección [Perfiles](#performance-profiling).
+* `profile`: correspondiente a los mensajes registrados por [[Yii::beginProfile()]] y [[Yii::endProfile()]], que se
+ explicará más detalladamente en la subsección [Perfiles](#performance-profiling).
-Si no se especifica la propiedad [[yii\log\Target::levels|levels]], significa que el destino procesará los
+Si no se especifica la propiedad [[yii\log\Target::levels|levels]], significa que el destino procesará los
mensajes de *cualquier* nivel de severidad.
-La propiedad [[yii\log\Target::categories|categories]] es un array que consta de categorías de mensaje o patrones. El
-destino sólo procesará mensajes de las categorías que se puedan encontrar o si coinciden con algún patrón listado
-en el array. Un patrón de categoría es un nombre de categoría al que se le añade un asterisco `*` al final. Un nombre
-de categoría coincide con un patrón si empieza por el mismo prefijo que el patrón. Por ejemplo,
-`yii\db\Command::execute` y `yii\db\Command::query` que se usan como nombres de categoría para los mensajes
+La propiedad [[yii\log\Target::categories|categories]] es un array que consta de categorías de mensaje o patrones. El
+destino sólo procesará mensajes de las categorías que se puedan encontrar o si coinciden con algún patrón listado
+en el array. Un patrón de categoría es un nombre de categoría al que se le añade un asterisco `*` al final. Un nombre
+de categoría coincide con un patrón si empieza por el mismo prefijo que el patrón. Por ejemplo,
+`yii\db\Command::execute` y `yii\db\Command::query` que se usan como nombres de categoría para los mensajes
registrados en la clase [[yii\db\Command]], coinciden con el patrón `yii\db\*`.
-Si no se especifica la propiedad [[yii\log\Target::categories|categories]], significa que el destino procesará
+Si no se especifica la propiedad [[yii\log\Target::categories|categories]], significa que el destino procesará
los mensajes de *todas* las categorías.
-Además añadiendo las categorías en listas blancas (whitelisting) mediante la propiedad
-[[yii\log\Target::categories|categories]], también se pueden añadir ciertas categorías en listas negras (blacklist)
-configurando la propiedad [[yii\log\Target::except|except]]. Si se encuentra la categoría de un mensaje o coincide
+Además añadiendo las categorías en listas blancas (whitelisting) mediante la propiedad
+[[yii\log\Target::categories|categories]], también se pueden añadir ciertas categorías en listas negras (blacklist)
+configurando la propiedad [[yii\log\Target::except|except]]. Si se encuentra la categoría de un mensaje o coincide
algún patrón con esta propiedad, NO será procesada por el destino.
-La siguiente configuración de destinos especifica que el destino solo debe procesar los mensajes de error y
-de advertencia de las categorías que coincidan con alguno de los siguientes patrones `yii\db\*` o
+La siguiente configuración de destinos especifica que el destino solo debe procesar los mensajes de error y
+de advertencia de las categorías que coincidan con alguno de los siguientes patrones `yii\db\*` o
`yii\web\HttpException:*`, pero no con `yii\web\HttpException:404`.
```php
@@ -171,31 +171,31 @@ de advertencia de las categorías que coincidan con alguno de los siguientes pat
]
```
-> Información: Cuando se captura una excepción de tipo HTTP por el [gestor de errores](runtime-handling-errors.md), se
- registrará un mensaje de error con el nombre de categoría con formato `yii\web\HttpException:ErrorCode`. Por
- ejemplo, la excepción [[yii\web\NotFoundHttpException]] causará un mensaje de error del tipo
+> Información: Cuando se captura una excepción de tipo HTTP por el [gestor de errores](runtime-handling-errors.md), se
+ registrará un mensaje de error con el nombre de categoría con formato `yii\web\HttpException:ErrorCode`. Por
+ ejemplo, la excepción [[yii\web\NotFoundHttpException]] causará un mensaje de error del tipo
`yii\web\HttpException:404`.
-### Formato de los Mensajes
+### Formato de los Mensajes
-Los destinos exportan los mensajes de registro filtrados en cierto formato. Por ejemplo, is se instala un
-destino de registros de la calse [[yii\log\FileTarget]], encontraremos un registro similar en el archivo de
+Los destinos exportan los mensajes de registro filtrados en cierto formato. Por ejemplo, is se instala un
+destino de registros de la calse [[yii\log\FileTarget]], encontraremos un registro similar en el archivo de
registro `runtime/log/app.log`:
```
2014-10-04 18:10:15 [::1][][-][trace][yii\base\Module::getModule] Loading module: debug
```
-De forma predeterminada los mensajes de registro se formatearan por [[yii\log\Target::formatMessage()]] como en el
+De forma predeterminada los mensajes de registro se formatearan por [[yii\log\Target::formatMessage()]] como en el
siguiente ejemplo:
```
Timestamp [IP address][User ID][Session ID][Severity Level][Category] Message Text
```
-Se puede personalizar el formato configurando la propiedad [[yii\log\Target::prefix]] que es un PHP ejecutable y
-devuelve un prefijo de mensaje personalizado. Por ejemplo, el siguiente código configura un destino de registro
-anteponiendo a cada mensaje de registro el ID de usuario (se eliminan la dirección IP y el ID por razones de
+Se puede personalizar el formato configurando la propiedad [[yii\log\Target::prefix]] que es un PHP ejecutable y
+devuelve un prefijo de mensaje personalizado. Por ejemplo, el siguiente código configura un destino de registro
+anteponiendo a cada mensaje de registro el ID de usuario (se eliminan la dirección IP y el ID por razones de
privacidad).
```php
@@ -209,11 +209,11 @@ privacidad).
]
```
-Además de prefijos de mensaje, destinos de registros también añaden alguna información de contexto en cada lote
-de mensajes de registro. De forma predeterminada, se incluyen los valores de las siguientes variables globales de
-PHP: `$_GET`, `$_POST`, `$_FILES`, `$_COOKIE`, `$_SESSION` y `$_SERVER`. Se puede ajustar el comportamiento
-configurando la propiedad [[yii\log\Target::logVars]] con los nombres de las variables globales que se quieran incluir
-con el destino del registro. Por ejemplo, la siguiente configuración de destino de registros especifica que
+Además de prefijos de mensaje, destinos de registros también añaden alguna información de contexto en cada lote
+de mensajes de registro. De forma predeterminada, se incluyen los valores de las siguientes variables globales de
+PHP: `$_GET`, `$_POST`, `$_FILES`, `$_COOKIE`, `$_SESSION` y `$_SERVER`. Se puede ajustar el comportamiento
+configurando la propiedad [[yii\log\Target::logVars]] con los nombres de las variables globales que se quieran incluir
+con el destino del registro. Por ejemplo, la siguiente configuración de destino de registros especifica que
sólo se añadirá al mensaje de registro el valor de la variable `$_SERVER`.
```php
@@ -223,14 +223,14 @@ sólo se añadirá al mensaje de registro el valor de la variable `$_SERVER`.
]
```
-Se puede configurar `logVars` para que sea un array vacío para deshabilitar totalmente la inclusión de información de
-contexto. O si se desea implementar un método propio de proporcionar información de contexto se puede sobrescribir el
+Se puede configurar `logVars` para que sea un array vacío para deshabilitar totalmente la inclusión de información de
+contexto. O si se desea implementar un método propio de proporcionar información de contexto se puede sobrescribir el
método [[yii\log\Target::getContextMessage()]].
-### Nivel de Seguimiento de Mensajes
+### Nivel de Seguimiento de Mensajes
-Durante el desarrollo, a veces se quiere visualizar de donde proviene cada mensaje de registro. Se puede lograr
-configurando la propiedad [[yii\log\Dispatcher::traceLevel|traceLevel]] del componente `log` como en el siguiente
+Durante el desarrollo, a veces se quiere visualizar de donde proviene cada mensaje de registro. Se puede lograr
+configurando la propiedad [[yii\log\Dispatcher::traceLevel|traceLevel]] del componente `log` como en el siguiente
ejemplo:
```php
@@ -245,20 +245,20 @@ return [
];
```
-La configuración de aplicación anterior establece el [[yii\log\Dispatcher::traceLevel|traceLevel]] para que sea 3 si
-`YII_DEBUG` esta habilitado y 0 si esta deshabilitado. Esto significa que si `YII_DEBUG` esta habilitado, a cada
-mensaje de registro se le añadirán como mucho 3 niveles de la pila de llamadas del mensaje que se este registrando; y
+La configuración de aplicación anterior establece el [[yii\log\Dispatcher::traceLevel|traceLevel]] para que sea 3 si
+`YII_DEBUG` esta habilitado y 0 si esta deshabilitado. Esto significa que si `YII_DEBUG` esta habilitado, a cada
+mensaje de registro se le añadirán como mucho 3 niveles de la pila de llamadas del mensaje que se este registrando; y
si `YII_DEBUG` está deshabilitado, no se incluirá información de la pila de llamadas.
-> Información: Obtener información de la pila de llamadas no es trivial. Por lo tanto, sólo se debe usar esta
+> Información: Obtener información de la pila de llamadas no es trivial. Por lo tanto, sólo se debe usar esta
característica durante el desarrollo o cuando se depura la aplicación.
-### Liberación (Flushing) y Exportación de Mensajes
+### Liberación (Flushing) y Exportación de Mensajes
-Como se ha comentado anteriormente, los mensajes de registro se mantienen en un array por el
-[[yii\log\Logger|logger object]]. Para limitar el consumo de memoria de este array, el componente encargado del
-registro de mensajes enviará los mensajes registrados a los [destinos de registros](#log-targets) cada vez que el
-array acumule un cierto número de mensajes de registro. Se puede personalizar el número configurando la propiedad
+Como se ha comentado anteriormente, los mensajes de registro se mantienen en un array por el
+[[yii\log\Logger|logger object]]. Para limitar el consumo de memoria de este array, el componente encargado del
+registro de mensajes enviará los mensajes registrados a los [destinos de registros](#log-targets) cada vez que el
+array acumule un cierto número de mensajes de registro. Se puede personalizar el número configurando la propiedad
[[yii\log\Dispatcher::flushInterval|flushInterval]] del componente `log`:
```php
@@ -273,13 +273,13 @@ return [
];
```
-> Información: También se produce la liberación de mensajes cuando la aplicación finaliza, esto asegura que los
+> Información: También se produce la liberación de mensajes cuando la aplicación finaliza, esto asegura que los
destinos de los registros reciban los mensajes de registro.
-Cuando el [[yii\log\Logger|logger object]] libera los mensajes de registro enviándolos a los
-[destinos de registros](#log-targets), estos no se exportan inmediatamente. La exportación de mensajes solo se
-produce cuando un destino de registros acumula un cierto número de mensajes filtrados. Se puede personalizar este
-número configurando la propiedad [[yii\log\Target::exportInterval|exportInterval]] de un
+Cuando el [[yii\log\Logger|logger object]] libera los mensajes de registro enviándolos a los
+[destinos de registros](#log-targets), estos no se exportan inmediatamente. La exportación de mensajes solo se
+produce cuando un destino de registros acumula un cierto número de mensajes filtrados. Se puede personalizar este
+número configurando la propiedad [[yii\log\Target::exportInterval|exportInterval]] de un
[destinos de registros](#log-targets) individual, como se muestra a continuación,
```php
@@ -289,11 +289,11 @@ número configurando la propiedad [[yii\log\Target::exportInterval|exportInterva
]
```
-Debido al nivel de configuración de la liberación y exportación de mensajes, de forma predeterminada cuando se llama a
-`Yii::trace()` o cualquier otro método de registro de mensajes, NO veremos el registro de mensaje inmediatamente en
-los destinos de registros. Esto podría ser un problema para algunas aplicaciones de consola de ejecución
-prolongada (long-running). Para hacer que los mensajes de registro aparezcan inmediatamente en los destinos de
-registro se deben establecer [[yii\log\Dispatcher::flushInterval|flushInterval]] y
+Debido al nivel de configuración de la liberación y exportación de mensajes, de forma predeterminada cuando se llama a
+`Yii::trace()` o cualquier otro método de registro de mensajes, NO veremos el registro de mensaje inmediatamente en
+los destinos de registros. Esto podría ser un problema para algunas aplicaciones de consola de ejecución
+prolongada (long-running). Para hacer que los mensajes de registro aparezcan inmediatamente en los destinos de
+registro se deben establecer [[yii\log\Dispatcher::flushInterval|flushInterval]] y
[[yii\log\Target::exportInterval|exportInterval]] para que tengan valor 1 como se muestra a continuación:
```php
@@ -315,17 +315,17 @@ return [
> Nota: El uso frecuente de liberación y exportación puede degradar el rendimiento de la aplicación.
-### Conmutación de Destinos de Registros
+### Conmutación de Destinos de Registros
-Se puede habilitar o deshabilitar un destino de registro configuración su propiedad
-[[yii\log\Target::enabled|enabled]]. Esto se puede llevar a cabo a mediante la configuración del destino de
+Se puede habilitar o deshabilitar un destino de registro configuración su propiedad
+[[yii\log\Target::enabled|enabled]]. Esto se puede llevar a cabo a mediante la configuración del destino de
registros o con la siguiente declaración PHP de código:
```php
Yii::$app->log->targets['file']->enabled = false;
```
-El código anterior requiere que se asocie un destino como `file`, como se muestra a continuación usando las
+El código anterior requiere que se asocie un destino como `file`, como se muestra a continuación usando las
claves de texto en el array `targets`:
```php
@@ -346,21 +346,21 @@ return [
];
```
-### Creación de Nuevos Destinos
+### Creación de Nuevos Destinos
-La creación de nuevas clases de destinos de registro es muy simple. Se necesita implementar el método
-[[yii\log\Target::export()]] enviando el contenido del array [[yii\log\Target::messages]] al medio designado. Se puede
-llamar al método [[yii\log\Target::formatMessage()]] para formatear los mensajes. Se pueden encontrar más detalles de
+La creación de nuevas clases de destinos de registro es muy simple. Se necesita implementar el método
+[[yii\log\Target::export()]] enviando el contenido del array [[yii\log\Target::messages]] al medio designado. Se puede
+llamar al método [[yii\log\Target::formatMessage()]] para formatear los mensajes. Se pueden encontrar más detalles de
destinos de registros en las clases incluidas en la distribución de Yii.
-## Perfilado de Rendimiento
+## Perfilado de Rendimiento
-El Perfilado de rendimiento es un tipo especial de registro de mensajes que se usa para medir el tiempo que tardan en
-ejecutarse ciertos bloques de código y encontrar donde están los cuellos de botella de rendimiento. Por ejemplo, la
-clase [[yii\db\Command]] utiliza el perfilado de rendimiento para encontrar conocer el tiempo que tarda cada consulta
+El Perfilado de rendimiento es un tipo especial de registro de mensajes que se usa para medir el tiempo que tardan en
+ejecutarse ciertos bloques de código y encontrar donde están los cuellos de botella de rendimiento. Por ejemplo, la
+clase [[yii\db\Command]] utiliza el perfilado de rendimiento para encontrar conocer el tiempo que tarda cada consulta
a la base de datos.
-Para usar el perfilado de rendimiento, primero debemos identificar los bloques de código que tienen que ser
+Para usar el perfilado de rendimiento, primero debemos identificar los bloques de código que tienen que ser
perfilados, para poder enmarcar su contenido como en el siguiente ejemplo:
```php
@@ -371,8 +371,8 @@ perfilados, para poder enmarcar su contenido como en el siguiente ejemplo:
\Yii::endProfile('myBenchmark');
```
-Donde `myBenchmark` representa un token único para identificar el bloque de código. Después cuando se examine el
-resulte del perfilado, se podrá usar este token para encontrar el tiempo que ha necesitado el correspondiente bloque
+Donde `myBenchmark` representa un token único para identificar el bloque de código. Después cuando se examine el
+resulte del perfilado, se podrá usar este token para encontrar el tiempo que ha necesitado el correspondiente bloque
de código.
Es importante asegurarse de que los pares de `beginProfile` y `endProfile` estén bien anidados. Por ejemplo,
@@ -389,10 +389,10 @@ Es importante asegurarse de que los pares de `beginProfile` y `endProfile` esté
\Yii::endProfile('block1');
```
-Si nos dejamos el `\Yii::endProfile('block1')` o lo intercambiamos `\Yii::endProfile('block1')` con
+Si nos dejamos el `\Yii::endProfile('block1')` o lo intercambiamos `\Yii::endProfile('block1')` con
`\Yii::endProfile('block2')`, el perfilado de rendimiento no funcionará.
-Se registra un mensaje de registro con el nivel de severidad `profile` para cada bloque de código que se haya
-perfilado. Se puede configurar el [destino del registro](#log-targets) para reunir todos los mensajes y exportarlos.
-El [depurador de Yii](tool-debugger.md) incluye un panel de perfilado de rendimiento que muestra los resultados de
+Se registra un mensaje de registro con el nivel de severidad `profile` para cada bloque de código que se haya
+perfilado. Se puede configurar el [destino del registro](#log-targets) para reunir todos los mensajes y exportarlos.
+El [depurador de Yii](tool-debugger.md) incluye un panel de perfilado de rendimiento que muestra los resultados de
perfilado.
\ No newline at end of file
diff --git a/docs/guide-es/runtime-requests.md b/docs/guide-es/runtime-requests.md
index a1617f8..3179577 100644
--- a/docs/guide-es/runtime-requests.md
+++ b/docs/guide-es/runtime-requests.md
@@ -7,7 +7,7 @@ objeto request correspondiente a través del [componente de aplicación](structu
que, por defecto, es una instancia de [[yii\web\Request]]. En esta sección se describirá como hacer uso de este
componente en las aplicaciones.
-## Parámetros de Request
+## Parámetros de Request
Para obtener los parámetros de la petición, se puede llamar a los métodos [[yii\web\Request::get()|get()]] y
[[yii\web\Request::post()|post()]] del componente `request`. Estos devuelven los valores de `$_GET` y `$_POST`,
@@ -58,7 +58,7 @@ $param = $request->getBodyParam('id');
se acceda a él a través de los métodos descritos anteriormente. Se puede personalizar la manera en como los
parámetros se convierten configurando la propiedad [[yii\web\Request::parsers]].
-## Métodos de Request
+## Métodos de Request
Se puede obtener el método HTTP usado por la petición actual a través de la expresión `Yii::$app->request->method`. Se
proporcionan un conjunto de propiedades booleanas para comprobar si el método actual es de un cierto tipo. Por ejemplo:
@@ -72,7 +72,7 @@ if ($request->isPost) { // el método de la request es POST }
if ($request->isPut) { // el método de la request es PUT }
```
-## URLs de Request
+## URLs de Request
El componente `request` proporciona muchas maneras de inspeccionar la URL solicitada actualmente.
@@ -95,7 +95,7 @@ varias partes de la URL explicadas en los siguientes puntos:
* [[yii\web\Request::serverName|serverName]]: devuelve `example.com`, que es el nombre del host dentro de la URL.
* [[yii\web\Request::serverPort|serverPort]]: devuelve 80, que es el puerto que usa el servidor web.
-## Cabeceras HTTP
+## Cabeceras HTTP
Se pueden obtener la información de las cabeceras HTTP a través de [[yii\web\HeaderCollection|header collection]]
devueltas por la propiedad [[yii\web\Request::headers]]. Por ejemplo:
@@ -130,7 +130,7 @@ lista de idiomas soportados por la aplicación, comparados con
diatónicamente el content type y el idioma que debe usarse en la respuesta. El filtro implementa la negociación de
contenido en la parte superior de las propiedades y métodos descritos anteriormente.
-## Información del cliente
+## Información del cliente
Se puede obtener el nombre del host y la dirección IP de la máquina cliente a través de
[[yii\web\Request::userHost|userHost]] y [[yii\web\Request::userIP|userIP]], respectivamente. Por ejemplo:
diff --git a/docs/guide-es/runtime-responses.md b/docs/guide-es/runtime-responses.md
index c765d09..8b16966 100644
--- a/docs/guide-es/runtime-responses.md
+++ b/docs/guide-es/runtime-responses.md
@@ -13,7 +13,7 @@ usuario final tal y como se explica a continuación.
En esta sección, se describirá como generar y enviar respuestas a usuarios finales.
-## Códigos de Estado
+## Códigos de Estado
Una de las primeras cosas que debería hacerse cuando se genera una respuesta es indicar si la petición se ha
gestionado correctamente. Esto se indica asignando la propiedad [[yii\web\Response::statusCode]] a la que se le puede
@@ -56,7 +56,7 @@ Si la excepción que se quiere lanzar no se encuentra en la lista anterior, se p
throw new \yii\web\HttpException(402);
```
-## Cabeceras HTTP
+## Cabeceras HTTP
Se puede enviar cabeceras HTTP modificando el [[yii\web\Response::headers|header collection]] en el componente
`response`. Por ejemplo:
@@ -78,7 +78,7 @@ $values = $headers->remove('Pragma');
Además, las nuevas cabeceras registradas no se enviarán al usuario hasta que se llame al método
[[yii\web\Response::send()]].
-## Cuerpo de la Respuesta
+## Cuerpo de la Respuesta
La mayoría de las respuestas deben tener un cuerpo que contenga el contenido que se quiere mostrar a los usuarios
finales.
@@ -160,7 +160,7 @@ public function actionInfo()
`response` en la configuración de la aplicación. Sin embargo, se puede usar la
[inyección de dependencias](concept-di-container.md) para aplicar la configuración común al nuevo objeto response.
-## Redirección del Navegador
+## Redirección del Navegador
La redirección del navegador se basa en el envío de la cabecera HTTP `Location`. Debido a que esta característica se
usa comúnmente, Yii proporciona soporte especial para ello.
@@ -202,7 +202,7 @@ JavaScript, incluyendo la redirección de navegador basada en la cabecera `X-Red
fichero JavaScript (registrándolo *asset bundle* [[yii\web\YiiAsset]]), no se necesitará escribir nada más para tener
soporte en redirecciones AJAX.
-## Enviar Archivos
+## Enviar Archivos
Igual que con la redirección, el envío de archivos es otra característica que se basa en cabeceras HTTP especificas.
Yii proporciona un conjunto de métodos para dar soporte a varias necesidades del envío de ficheros. Todos ellos
@@ -242,7 +242,7 @@ algunos servidores Web populares.
- Nginx: [X-Accel-Redirect](http://wiki.nginx.org/XSendfile)
- Cherokee: [X-Sendfile and X-Accel-Redirect](http://www.cherokee-project.com/doc/other_goodies.html#x-sendfile)
-## Enviar la Respuesta
+## Enviar la Respuesta
El contenido en una respuesta no se envía al usuario hasta que se llama al método [[yii\web\Response::send()]]. De
forma predeterminada, se llama a este método automáticamente al final de [[yii\base\Application::run()]]. Sin embargo,
diff --git a/docs/guide-es/runtime-routing.md b/docs/guide-es/runtime-routing.md
index cd1d040..45c61ab 100644
--- a/docs/guide-es/runtime-routing.md
+++ b/docs/guide-es/runtime-routing.md
@@ -6,8 +6,7 @@ Cuando una aplicación Yii empieza a procesar una URL solicitada, lo primero que
[acción de controlador](structure-controllers.md) correspondiente para gestionar la petición. A este proceso se
le llama *enrutamiento*.
-El proceso inverso se llama *creación de URLs*, y crea una URL a partir de una ruta dada y unos parámetros de consulta
-(query) asociados. Cuando posteriormente se solicita la URL creada, el proceso de enrutamiento puede resolverla y
+El proceso inverso se llama *creación de URLs*, y crea una URL a partir de una ruta dada y unos parámetros de consulta (query) asociados. Cuando posteriormente se solicita la URL creada, el proceso de enrutamiento puede resolverla y
convertirla en la ruta original con los parámetros asociados.
La principal pieza encargada del enrutamiento y de la creación de URLs es [[yii\web\UrlManager|URL manager]], que se
@@ -20,7 +19,8 @@ Configurando el componente `urlManager` en la configuración de la aplicación,
reconocimiento arbitrario de formatos de URL sin modificar el código de la aplicación existente. Por ejemplo, se
puede usar el siguiente código para crear una URL para la acción `post/view`:
-``` php use yii\helpers\Url;
+``` php
+use yii\helpers\Url;
// Url::to() llama a UrlManager::createUrl() para crear una URL
$url = Url::to(['post/view', 'id' => 100]);
@@ -36,7 +36,8 @@ los parámetros.
/posts/100
```
-## Formatos de URL
+
+## Formatos de URL
El [[yii\web\UrlManager|URL manager]] soporta dos formatos de URL: el formato predeterminado de URL y el formato URL
amigable (pretty URL).
@@ -58,7 +59,7 @@ Se puede cambiar entre los dos formatos de URL conmutando la propiedad
[[yii\web\UrlManager::enablePrettyUrl|enablePrettyUrl]] del [[yii\web\UrlManager|URL manager]] sin cambiar ningún
otro código de aplicación.
-## Enrutamiento
+## Enrutamiento
El Enrutamiento involucra dos pasos. El primero, la petición (request) entrante se convierte en una ruta y sus
parámetros de consulta asociados. En el segundo paso, se crea la correspondiente
@@ -85,16 +86,13 @@ acción. Empezando por la primera parte de la ruta, la aplicación, sigue los si
módulo actual. Si está listado, se crea un modulo de acuerdo con la configuración encontrada en el listado de
módulos, y se seguirá el Paso 2 para gestionar la siguiente parte de la ruta bajo el contexto de la creación de un
nuevo módulo.
-4. Trata el ID como si se tratara de un ID de controlador y crea un objeto controlador. Sigue el siguiente paso con la
- parte restante de la ruta.
-5. El controlador busca el ID en su [[yii\base\Controller::actions()|action map]]. Si lo encuentra, crea una acción de
- acuerdo con la configuración encontrada en el mapa. De otra forma, el controlador intenta crear una acción en linea
- definida por un método de acción correspondiente al ID actual.
+4. Trata el ID como si se tratara de un ID de controlador y crea un objeto controlador. Sigue el siguiente paso con la parte restante de la ruta.
+5. El controlador busca el ID en su [[yii\base\Controller::actions()|action map]]. Si lo encuentra, crea una acción de acuerdo con la configuración encontrada en el mapa. De otra forma, el controlador intenta crear una acción en linea definida por un método de acción correspondiente al ID actual.
Si ocurre algún error entre alguno de los pasos anteriores, se lanzará una excepción de tipo
[[yii\web\NotFoundHttpException]], indicando el fallo de proceso de enrutamiento.
-### Ruta Predeterminada
+### Ruta Predeterminada
Cuando una petición se convierte en una ruta vacía, se usa la llamada *ruta predeterminada*. Por defecto, la ruta
predeterminada es `site/index`, que hace referencia a la acción `index` del controlador `site`. Se puede personalizar
@@ -108,7 +106,8 @@ aplicación como en el siguiente ejemplo:
];
```
-### Ruta `catchAll`
+
+### Ruta `catchAll`
A veces, se puede querer poner la aplicación Web en modo de mantenimiento temporalmente y mostrar la misma pagina de
información para todas las peticiones. Hay varias maneras de lograr este objetivo. Pero una de las maneras más simples
@@ -127,7 +126,7 @@ Con la anterior configuración, se usar la acción `site/offline` para gestionar
La propiedad `catchAll` debe tener un array cuyo primer elemento especifique una ruta, y el resto de elementos
(pares nombre-valor) especifiquen los parámetros [ligados a la acción](structure-controllers.md#action-parameters).
-## Creación de URLs
+## Creación de URLs
Yii proporciona un método auxiliar (helper method) [[yii\helpers\Url::to()]] para crear varios tipos de URLs a partir
de las rutas dadas y sus parámetros de consulta asociados. Por ejemplo,
@@ -201,6 +200,7 @@ echo Url::to('@example');
// una URL absoluta: http://example.com/images/logo.gif
echo Url::to('/images/logo.gif', true);```
+```
Además del método `to()`, la clase auxiliar [[yii\helpers\Url]] también proporciona algunos otros métodos de creación
de URLs. Por ejemplo,
@@ -221,7 +221,8 @@ echo Url::canonical();
echo Url::previous();
```
-## Uso de URLs Amigables
+
+## Uso de URLs Amigables
Para utilizar URLs amigables, hay que configurar el componente `ulrManager` en la configuración de la aplicación como
en el siguiente ejemplo:
@@ -263,7 +264,8 @@ amigable. El resto de propiedades son opcionales. Sin embargo, la anterior confi
Si se usa el servidor Web Apache, se puede utilizar la configuración recomendada descrita en la sección de
[Instalación](start-installation.md#recommended-apache-configuration).
-### Regalas de URL
+
+### Reglas de URL
Una regla de URL es una instancia de [[yii\web\UrlRule]] o de una clase hija. Cada URL consiste en un patrón utilizado
para cotejar la parte de información de ruta de las URLs, una ruta, y algunos parámetros de consulta. Una URL puede
@@ -314,11 +316,12 @@ se necesita a menudo cuando se quieren configurar otras propiedades de la regla
De forma predeterminada si no se especifica la opción `class` en la configuración de una regla, se utilizará la clase
predeterminada [[yii\web\UrlRule]].
-### Parameters Asociativos
+
+### Parameters Asociativos
Una regla de URL puede asociarse a una determinado grupo de parámetros de consulta que se hayan sido especificados en
el patrón con el formato `
+```
+
+最初の引数は、[エイリアス](concept-aliases.md) 以外にも、ルートとパラメータ、または URL を受け入れることが出来ます。
+[Url::to()](helper-url.md) と同様です。
+
+
+## リスト
+
+順序なしリストは、次のようにして生成することが出来ます。
+
+```php
+ function($item, $index) {
+ return Html::tag(
+ 'li',
+ $this->render('post', ['item' => $item]),
+ ['class' => 'post']
+ );
+}]) ?>
+```
+
+順序付きリストを生成するためには、代りに `Html:ol()` を使ってください。
diff --git a/docs/guide-ja/helper-overview.md b/docs/guide-ja/helper-overview.md
new file mode 100644
index 0000000..8f1722e
--- /dev/null
+++ b/docs/guide-ja/helper-overview.md
@@ -0,0 +1,75 @@
+ヘルパ
+======
+
+> Note|注意: この節はまだ執筆中です。
+
+Yii は、一般的なコーディングのタスク、例えば、文字列や配列の操作、HTML コードの生成などを手助けする多くのクラスを提供しています。
+これらのヘルパクラスは `yii\helpers` 名前空間の下に編成されており、すべてスタティックなクラス (すなわち、スタティックなプロパティとメソッドのみを含み、インスタンス化すべきでないクラス) です。
+
+ヘルパクラスは、そのスタティックなメソッドの一つを直接に呼び出すことによって使用します。
+例えば、
+
+```php
+use yii\helpers\Html;
+
+echo Html::encode('Test > test');
+```
+
+> Note|注意: [ヘルパクラスをカスタマイズする](#customizing-helper-classes) ことをサポートするために、Yii はコアヘルパクラスのすべてを二つのクラスに分割しています。
+> すなわち、基底クラス (例えば `BaseArrayHelper`) と具象クラス (例えば `ArrayHelper`) です。
+> ヘルパを使うときは、具象クラスのみを使うべきであり、基底クラスは決して使ってはいけません。
+
+
+コアヘルパクラス
+----------------
+
+以下のコアヘルパクラスが Yii のリリースにおいて提供されています。
+
+- [ArrayHelper](helper-array.md)
+- Console
+- FileHelper
+- [Html](helper-html.md)
+- HtmlPurifier
+- Image
+- Inflector
+- Json
+- Markdown
+- Security
+- StringHelper
+- [Url](helper-url.md)
+- VarDumper
+
+
+ヘルパクラスをカスタマイズする
+------------------------------
+
+コアヘルパクラス (例えば [[yii\helpers\ArrayHelper]]) をカスタマイズするためには、そのヘルパに対応する基底クラス (例えば [[yii\helpers\BaseArrayHelper]]) を拡張するクラスを作成して、名前空間も含めて、対応する具象クラス (例えば [[yii\helpers\ArrayHelper]]) と同じ名前を付けます。
+このクラスが、フレームワークのオリジナルの実装を置き換えるものとしてセットアップされます。
+
+次の例は、[[yii\helpers\ArrayHelper]] クラスの [[yii\helpers\ArrayHelper::merge()|merge()]] メソッドをカスタマイズする方法を示すものです。
+
+```php
+
+
+よく使う URL を取得するために使うことが出来るメソッドが二つあります。
+すなわち、ホーム URL と、現在のリクエストのベース URL を取得するメソッドです。
+ホーム URL を取得するためには、次のようにします。
+
+```php
+$relativeHomeUrl = Url::home();
+$absoluteHomeUrl = Url::home(true);
+$httpsAbsoluteHomeUrl = Url::home('https');
+```
+
+パラメータが渡されない場合は、相対 URL が生成されます。
+`true` を渡すと、現在のスキーマの絶対 URL を取得することが出来ます。
+または、スキーマを明示的に指定して (`http`, `https`) 絶対 URL を取得することも出来ます。
+
+現在のリクエストのベース URL を取得するためには、次のようにします。
+
+```php
+$relativeBaseUrl = Url::base();
+$absoluteBaseUrl = Url::base(true);
+$httpsAbsoluteBaseUrl = Url::base('https');
+```
+
+このメソッドの唯一のパラメータは、`Url::home()` の場合と全く同じ動作をします。
+
+
+## URL を生成する
+
+与えられたルートへの URL を生成するためには、`Url::toRoute()` メソッドを使います。
+このメソッドは、[[\yii\web\UrlManager]] を使って URL を生成します。
+
+```php
+$url = Url::toRoute(['product/view', 'id' => 42]);
+```
+
+ルートは、文字列として指定することが出来ます (例えば、`site/index`)。
+または、生成される URL に追加のクエリパラメータを指定したい場合は、配列を使うことも出来ます。
+配列の形式は、以下のようにしなければなりません。
+
+```php
+// /index.php?r=site/index¶m1=value1¶m2=value2 を生成
+['site/index', 'param1' => 'value1', 'param2' => 'value2']
+```
+
+アンカーの付いた URL を生成したい場合は、`#` パラメータを持つ配列を使うことが出来ます。例えば、
+
+```php
+// /index.php?r=site/index¶m1=value1#name を生成
+['site/index', 'param1' => 'value1', '#' => 'name']
+```
+
+ルートは、絶対ルートか相対ルートかのどちらかです。
+絶対ルートは先頭にスラッシュを持ち (例えば `/site/index`)、相対ルートは持ちません (例えば `site/index` または `index`)。
+相対ルートは次の規則に従って絶対ルートに変換されます。
+
+- ルートが空文字列である場合は、現在の [[yii\web\Controller::route|ルート]] が使用されます。
+- ルートがスラッシュを全く含まない場合は (例えば `index`)、カレントコントローラのアクション ID であると見なされて、カレントコントローラの [[\yii\web\Controller::uniqueId|uniqueId]] が前置されます。
+- ルートが先頭にスラッシュを含まない場合は (例えば `site/index`)、カレントモジュールに対する相対ルートと見なされて、カレントモジュールの [[\yii\base\Module::uniqueId|uniqueId]] が前置されます。
+
+バージョン 2.0.2 以降では、[エイリアス](concept-aliases.md) の形式でルートを指定することが出来ます。
+その場合は、エイリアスが最初に実際のルートに変換され、そのルートが上記の規則に従って絶対ルートに変換されます。
+
+以下に、このメソッドの使用例をいくつか挙げます。
+
+```php
+// /index.php?r=site/index
+echo Url::toRoute('site/index');
+
+// /index.php?r=site/index&src=ref1#name
+echo Url::toRoute(['site/index', 'src' => 'ref1', '#' => 'name']);
+
+// /index.php?r=post/edit&id=100 エイリアス "@postEdit" は "post/edit" と定義されていると仮定
+echo Url::toRoute(['@postEdit', 'id' => 100]);
+
+// http://www.example.com/index.php?r=site/index
+echo Url::toRoute('site/index', true);
+
+// https://www.example.com/index.php?r=site/index
+echo Url::toRoute('site/index', 'https');
+```
+
+もうひとつ、[[toRoute()]] と非常によく似た `Url::to()` というメソッドがあります。
+唯一の違いは、このメソッドはルートを配列として指定することを要求する、という点です。
+文字列が与えられた場合は、URL として扱われます。
+
+最初の引数は、次のいずれかを取り得ます。
+
+- 配列: URL を生成するために [[toRoute()]] が呼び出されます。例えば、`['site/index']`、`['post/index', 'page' => 2]`。
+ ルートの指定方法の詳細については [[toRoute()]] を参照してください。
+- `@` で始まる文字列: これはエイリアスとして扱われ、エイリアスに対応する文字列が返されます。
+- 空文字列: 現在リクエストされている URL が返されます。
+- 通常の文字列: その通りのものとして扱われます。
+
+`$scheme` (文字列または `true`) が指定された場合は、ホスト情報 ([[\yii\web\UrlManager::hostInfo]] から取得されます) を伴う絶対 URL が返されます。
+`$url` が既に絶対 URL であった場合には、そのスキームが指定されたものに置き換えられます。
+
+下記にいくつかの用例を挙げます。
+
+```php
+// /index.php?r=site/index
+echo Url::to(['site/index']);
+
+// /index.php?r=site/index&src=ref1#name
+echo Url::to(['site/index', 'src' => 'ref1', '#' => 'name']);
+
+// /index.php?r=post/edit&id=100 エイリアス "@postEdit" が "post/edit" と定義されていると仮定
+echo Url::to(['@postEdit', 'id' => 100]);
+
+// 現在リクエストされている URL
+echo Url::to();
+
+// /images/logo.gif
+echo Url::to('@web/images/logo.gif');
+
+// images/logo.gif
+echo Url::to('images/logo.gif');
+
+// http://www.example.com/images/logo.gif
+echo Url::to('@web/images/logo.gif', true);
+
+// https://www.example.com/images/logo.gif
+echo Url::to('@web/images/logo.gif', 'https');
+```
+
+バージョン 2.0.3 以降では、[[yii\helpers\Url::current()]] を使って、現在リクエストされているルートと GET パラメータに基づいて URL を生成することが出来ます。
+`$params` パラメータを渡して、GET パラメータの中のいくつかを修正したり削除したり、または新しい GET パラメータを追加したりすることが出来ます。
+例えば、
+
+```php
+// $_GET が ['id' => 123, 'src' => 'google'] であり、現在のルートが "post/view" であると仮定
+
+// /index.php?r=post/view&id=123&src=google
+echo Url::current();
+
+// /index.php?r=post/view&id=123
+echo Url::current(['src' => null]);
+// /index.php?r=post/view&id=100&src=google
+echo Url::current(['id' => 100]);
+```
+
+
+## URL を記憶する
+
+URL を記憶して、後に続く一連のリクエストの一つを処理するときに、記憶した URL を使わなければならないという場合があります。
+これは、次のようにして達成することが出来ます。
+
+```php
+// 現在の URL を記憶する
+Url::remember();
+
+// 指定された URL を記憶する。引数の形式は Url::to() を参照。
+Url::remember(['product/view', 'id' => 42]);
+
+// 指定された名前で URL を記憶する。
+Url::remember(['product/view', 'id' => 42], 'product');
+```
+
+次のリクエストで、記憶された URL を次のようにして取得することが出来ます。
+
+```php
+$url = Url::previous();
+$productUrl = Url::previous('product');
+```
+
+## 相対 URL かどうかチェックする
+
+URL が相対 URL であること、すなわち、URL がホスト情報の部分を持っていないことを確かめるために、次のコードを使うことが出来ます。
+
+```php
+$isRelative = Url::isRelative('test/it');
+```
diff --git a/docs/guide-ja/images/start-gii-crud-preview.png b/docs/guide-ja/images/start-gii-crud-preview.png
index d7becdd..85c2355 100644
Binary files a/docs/guide-ja/images/start-gii-crud-preview.png and b/docs/guide-ja/images/start-gii-crud-preview.png differ
diff --git a/docs/guide-ja/images/start-gii-crud.png b/docs/guide-ja/images/start-gii-crud.png
index a3aa21b..77c1ada 100644
Binary files a/docs/guide-ja/images/start-gii-crud.png and b/docs/guide-ja/images/start-gii-crud.png differ
diff --git a/docs/guide-ja/images/tutorial-console-help.png b/docs/guide-ja/images/tutorial-console-help.png
new file mode 100644
index 0000000..34812a6
Binary files /dev/null and b/docs/guide-ja/images/tutorial-console-help.png differ
diff --git a/docs/guide-ja/input-file-upload.md b/docs/guide-ja/input-file-upload.md
new file mode 100644
index 0000000..03679d3
--- /dev/null
+++ b/docs/guide-ja/input-file-upload.md
@@ -0,0 +1,258 @@
+ファイルをアップロードする
+==========================
+
+Yii におけるファイルのアップロードは、フォームモデル、その検証規則、そして、いくらかのコントローラコードによって行われます。
+アップロードを適切に処理するために何が必要とされるのか、見ていきましよう。
+
+
+一つのファイルをアップロードする
+--------------------------------
+
+まず最初に、ファイルのアップロードを処理するモデルを作成する必要があります。
+次の内容を持つ `models/UploadForm.php` を作成してください。
+
+```php
+namespace app\models;
+
+use yii\base\Model;
+use yii\web\UploadedFile;
+
+/**
+ * UploadForm : アップロードのフォームの背後にあるモデル
+ */
+class UploadForm extends Model
+{
+ /**
+ * @var UploadedFile file 属性
+ */
+ public $file;
+
+ /**
+ * @return array 検証規則
+ */
+ public function rules()
+ {
+ return [
+ [['file'], 'file'],
+ ];
+ }
+}
+```
+
+上記のコードにおいて作成した `UploadForm` というモデルは、HTML フォームで `` となる `$file` という属性を持ちます。
+この属性は [[yii\validators\FileValidator|FileValidator]] を使用する `file` という検証規則を持ちます。
+
+### フォームのビュー
+
+次に、フォームを表示するビューを作成します。
+
+```php
+
+
+ ['enctype' => 'multipart/form-data']]) ?>
+
+field($model, 'file')->fileInput() ?>
+
+
+
+
+```
+
+ファイルのアップロードを可能にする `'enctype' => 'multipart/form-data'` は不可欠です。
+`fileInput()` がフォームの入力フィールドを表します。
+
+### コントローラ
+
+そして、フォームとモデルを結び付けるコントローラを作成します。
+
+```php
+namespace app\controllers;
+
+use Yii;
+use yii\web\Controller;
+use app\models\UploadForm;
+use yii\web\UploadedFile;
+
+class SiteController extends Controller
+{
+ public function actionUpload()
+ {
+ $model = new UploadForm();
+
+ if (Yii::$app->request->isPost) {
+ $model->file = UploadedFile::getInstance($model, 'file');
+
+ if ($model->file && $model->validate()) {
+ $model->file->saveAs('uploads/' . $model->file->baseName . '.' . $model->file->extension);
+ }
+ }
+
+ return $this->render('upload', ['model' => $model]);
+ }
+}
+```
+
+`model->load(...)` の代りに `UploadedFile::getInstance(...)` を使っています。
+[[\yii\web\UploadedFile|UploadedFile]] はモデルの検証を実行せず、アップロードされたファイルに関する情報を提供するだけです。
+そのため、`$model->validate()` を手作業で実行して、[[yii\validators\FileValidator|FileValidator]] を起動する必要があります。
+[[yii\validators\FileValidator|FileValidator]] は、下記のコアコードが示しているように、属性がファイルであることを要求します。
+
+```php
+if (!$file instanceof UploadedFile || $file->error == UPLOAD_ERR_NO_FILE) {
+ return [$this->uploadRequired, []]; // "ファイルをアップロードしてください。" というエラーメッセージ
+}
+```
+
+検証が成功したら、ファイルを保存します。
+
+```php
+$model->file->saveAs('uploads/' . $model->file->baseName . '.' . $model->file->extension);
+```
+
+「ベーシック」プロジェクトテンプレートを使っている場合は、`uploads` フォルダを `web` の下に作成しなければなりません。
+
+以上です。ページをロードして、アップロードを試して見てください。ファイルは `basic/web/uploads` にアップロードされます。
+
+検証
+----
+
+たいていの場合、検証規則を調整して、特定のファイルだけを受け取るようにしたり、アップロードを必須としたりする必要があります。
+下記で、よく使われる規則の構成を見てみましよう。
+
+### Required
+
+ファイルのアップロードを必須とする必要がある場合は、次のように `skipOnEmpty` を `false` に設定します。
+
+```php
+public function rules()
+{
+ return [
+ [['file'], 'file', 'skipOnEmpty' => false],
+ ];
+}
+```
+
+### MIME タイプ
+
+アップロードされるファイルのタイプを検証することは賢明なことです。
+`FileValidator` はこの目的のための `extensions` プロパティを持っています。
+
+```php
+public function rules()
+{
+ return [
+ [['file'], 'file', 'extensions' => 'gif, jpg'],
+ ];
+}
+```
+
+デフォルトでは、ファイルのコンテントの MIME タイプが指定された拡張子に対応するものであるかどうかが検証されます。
+例えば、`gif` に対しては `image/gif`、`jpg` に対しては `image/jpeg` であるかどうかが検証されます。
+
+MIME タイプの中には、`file` バリデータによって使われている PHP fileinfo 拡張では適切に検知することが出来ないものがあることに注意してください。
+例えば、`csv` ファイルは `text/csv` ではなく `text/plain` として検知されます。
+このような振る舞いを避けるために、`checkExtensionByMimeType` を `false` に設定して、MIME タイプを手動で指定することが出来ます。
+
+```php
+public function rules()
+{
+ return [
+ [['file'], 'file', 'checkExtensionByMimeType' => false, 'extensions' => 'csv', 'mimeTypes' => 'text/plain'],
+ ];
+}
+```
+
+[一般的なメディアタイプの一覧表](http://en.wikipedia.org/wiki/Internet_media_type#List_of_common_media_types)
+
+### 画像のプロパティ
+
+画像をアップロードするときは、[[yii\validators\ImageValidator|ImageValidator]] が重宝するでしょう。
+このバリデータは、属性が有効な画像を受け取ったか否かを検証します。
+画像は、保存するか、または、[Imagine エクステンション](https://github.com/yiisoft/yii2-imagine) によって処理することが出来ます。
+
+複数のファイルをアップロードする
+--------------------------------
+
+複数のファイルを一度にアップロードする必要がある場合は、少し修正が必要になります。
+
+モデル:
+
+```php
+class UploadForm extends Model
+{
+ /**
+ * @var UploadedFile|Null ファイル属性
+ */
+ public $file;
+
+ /**
+ * @return array 検証規則
+ */
+ public function rules()
+ {
+ return [
+ [['file'], 'file', 'maxFiles' => 10], // <--- ここ !
+ ];
+ }
+}
+```
+
+ビュー:
+
+```php
+ ['enctype' => 'multipart/form-data']]);
+?>
+
+field($model, 'file[]')->fileInput(['multiple' => true]) ?>
+
+
+
+
+```
+
+違いがあるのは、次の行です。
+
+```php
+field($model, 'file[]')->fileInput(['multiple' => true]) ?>
+```
+
+コントローラ:
+
+```php
+namespace app\controllers;
+
+use Yii;
+use yii\web\Controller;
+use app\models\UploadForm;
+use yii\web\UploadedFile;
+
+class SiteController extends Controller
+{
+ public function actionUpload()
+ {
+ $model = new UploadForm();
+
+ if (Yii::$app->request->isPost) {
+ $model->file = UploadedFile::getInstances($model, 'file');
+
+ if ($model->file && $model->validate()) {
+ foreach ($model->file as $file) {
+ $file->saveAs('uploads/' . $file->baseName . '.' . $file->extension);
+ }
+ }
+ }
+
+ return $this->render('upload', ['model' => $model]);
+ }
+}
+```
+
+単一のファイルのアップロードとは、二つの点で異なります。
+最初の違いは、`UploadedFile::getInstance($model, 'file');` の代りに `UploadedFile::getInstances($model, 'file');` が使用されることです。
+前者が一つのインスタンスを返すだけなのに対して、後者はアップロードされた **全ての** ファイルのインスタンスを返します。
+第二の違いは、`foreach` によって、全てのファイルをそれぞれ保存している点です。
diff --git a/docs/guide-ja/input-forms.md b/docs/guide-ja/input-forms.md
new file mode 100644
index 0000000..8173b2c
--- /dev/null
+++ b/docs/guide-ja/input-forms.md
@@ -0,0 +1,110 @@
+フォームを作成する
+==================
+
+Yii においてフォームを使用するときは、主として [[yii\widgets\ActiveForm]] による方法を使います。
+フォームがモデルに基づくものである場合はこの方法を選ぶべきです。
+これに加えて、[[yii\helpers\Html]] にはいくつかの有用なメソッドがあり、どんなフォームでも、ボタンやヘルプテキストを追加するのには、通常、それらのメソッドを使います。
+
+フォームは、クライアント側で表示されるものですが、たいていの場合、対応する [モデル](structure-models.md) を持ち、それを使ってサーバ側でフォームの入力を検証します
+(入力の検証の詳細については、[入力を検証する](input-validation.md) の節を参照してください)。
+モデルに基づくフォームを作成する場合、最初のステップは、モデルそのものを定義することです。
+モデルは、データベースの何らかのデータを表現するために [アクティブレコード](db-active-record.md) から派生させたクラスか、あるいは、任意の入力、例えばログインフォームの入力を保持するための ([[yii\base\Model]] から派生させた) 汎用的な Model クラスか、どちらかにすることが出来ます。
+以下の例においては、ログインフォームのために汎用的なモデルを使う方法を示します。
+
+```php
+ 'login-form',
+ 'options' => ['class' => 'form-horizontal'],
+]) ?>
+ field($model, 'username') ?>
+ field($model, 'password')->passwordInput() ?>
+
+
+
+
+```
+
+上記のコードでは、[[yii\widgets\ActiveForm::begin()|ActiveForm::begin()]] がフォームのインスタンスを作成するだけでなく、フォームの開始をマークしています。
+[[yii\widgets\ActiveForm::begin()|ActiveForm::begin()]] と [[yii\widgets\ActiveForm::end()|ActiveForm::end()]] の間に置かれた全てのコンテントが HTML の `
+ 'btn btn-primary']) ?>
+
+