Skip to content
This repository has been archived by the owner on Dec 30, 2023. It is now read-only.

Commit

Permalink
New translations devtools-usage.md (Spanish)
Browse files Browse the repository at this point in the history
  • Loading branch information
@niden
niden committed Jan 16, 2019
1 parent c1901bc commit 70f2b69
Showing 1 changed file with 29 additions and 27 deletions.
56 changes: 29 additions & 27 deletions es-es/devtools-usage.md
View file
Expand Up @@ -4,35 +4,37 @@ layout: article language: 'en' version: '4.0'

* * *

<h5 class="alert alert-warning">This article reflects v3.4 and has not yet been revised</h5>
##### This article reflects v3.4 and has not yet been revised

{:.alert .alert-danger}

<a name='overview'></a>

# Herramientas para desarrolladores de Phalcon

Estas herramientas son una colección de útiles secuencias de comandos para generar el código del esqueleto. Los componentes básicos de su aplicación pueden ser generados con un simple comando, lo que le permite desarrollar fácilmente aplicaciones usando Phalcon.
These tools are a collection of useful scripts to generate skeleton code. Core components of your application can be generated with a simple command, allowing you to easily develop applications using Phalcon.

<h5 class='alert alert-danger'>If you prefer to use the web version instead of the console, this <a href="https://blog.phalconphp.com/post/dont-like-command-line-and-consoles-no-problem">blog post</a> offers more information. </h5>

<a name='download'></a>

## Descargar

Usted puede descargar o clonar el paquete multi plataforma que contiene las Herramientas del Desarrollador desde [Github](https://github.com/phalcon/phalcon-devtools).
You can download or clone a cross platform package containing the developer tools from [Github](https://github.com/phalcon/phalcon-devtools).

<a name='installation'></a>

## Instalación

Estas son las instrucciones detalladas sobre cómo instalar las herramientas de Desarrollador en diferentes plataformas:
These are detailed instructions on how to install the developer tools on different platforms:

[Linux](/[/4.0/en/devtools-installation#installation-linux) : [MacOS](/4.0/en/devtools-installation#installation-macos) : [Windows](/4.0/en/devtools-installation#installation-windows)

<a name='available-commands'></a>

## Comandos disponibles

Puede obtener una lista de comandos disponibles en herramientas de Phalcon escribiendo: `phalcon commands`
You can get a list of available commands in Phalcon tools by typing: :code:`phalcon commands`

```bash
$ phalcon commands
Expand All @@ -55,7 +57,7 @@ Comandos disponibles:

## Generar un esqueleto de proyecto

Puede utilizar herramientas de Phalcon para generar los esqueletos de proyecto previamente definidos para las aplicaciones con framework Phalcon. Por defecto el generador de esqueleto de proyecto utiliza mod_rewrite para Apache. Escriba el siguiente comando en la raíz del documento web server:
You can use Phalcon tools to generate pre-defined project skeletons for your applications with Phalcon framework. By default the project skeleton generator will use mod_rewrite for Apache. Type the following command on your web server document root:

```bash
$ pwd
Expand All @@ -65,11 +67,11 @@ $ pwd
$ phalcon create-project store
```

La estructura de proyecto recomendada anteriormente fue generada:
The above recommended project structure was generated:

![](/assets/images/content/devtools-usage-01.png)

Puede añadir el parámetro `--help` para obtener ayuda sobre el uso de un determinado script:
You could add the parameter `--help` to get help on the usage of a certain script:

```bash
$ phalcon project --help
Expand Down Expand Up @@ -99,21 +101,21 @@ Opciones:
--help Muestra esta ayuda[optional]
```

Accediendo al proyecto desde el servidor web le mostrará lo siguiente:
Accessing the project from the web server will show you:

![](/assets/images/content/devtools-usage-02.png)

<a name='generating-controllers'></a>

## Generando controladores

El comando `create-controller` genera estructuras de esqueleto de controlador. Es importante invocar este comando dentro de un directorio que cuenta ya con un proyecto Phalcon.
The command `create-controller` generates controller skeleton structures. It's important to invoke this command inside a directory that already has a Phalcon project.

```bash
$ phalcon create-controller --name prueba
```

El siguiente código es generado por la secuencia de comandos:
The following code is generated by the script:

```php
<?php
Expand All @@ -133,9 +135,9 @@ class PruebaController extends Controller

## Preparando la configuración de la base de datos

Cuando se genera un proyecto utilizando herramientas de desarrollador. Un archivo de configuración puede encontrarse en `app/config/config.php`. Para generar modelos o andamios, usted necesitará cambiar la configuración utilizada para conectarse a la base de datos.
When a project is generated using developer tools. A configuration file can be found in `app/config/config.php`. To generate models or scaffold, you will need to change the settings used to connect to your database.

Cambiar la sección de base de datos en el archivo config.php:
Change the database section in your config.php file:

```php
<?php
Expand Down Expand Up @@ -173,7 +175,7 @@ return new \Phalcon\Config([

## Generando modelos

Hay varias formas de crear modelos. Puede crear todos los modelos de la conexión de base de datos predeterminada o algunos selectivamente. Los modelos pueden tener atributos públicos para las representaciones de los campos o puede ser utilizados setters y getters.
There are several ways to create models. You can create all models from the default database connection or some selectively. Models can have public attributes for the field representations or setters/getters can be used.

```bash
Opciones:
Expand All @@ -191,7 +193,7 @@ Opciones:
--abstract Modelo abstracto [opcional]
```

La forma más sencilla de generar un modelo es:
The simplest way to generate a model is:

```bash
$ phalcon model products
Expand All @@ -201,7 +203,7 @@ $ phalcon model products
$ phalcon model --name nombreDeLaTabla
```

Todos los campos de tabla se declaran públicos para acceso directo.
All table fields are declared public for direct access.

```php
<?php
Expand Down Expand Up @@ -242,7 +244,7 @@ class Products extends Model
}
```

Mediante la adición del argumento `--get-set` puede generar los campos como variables protegidas y métodos setter/getter públicos. Estos métodos pueden ayudar en la implementación de lógica de negocio dentro de los métodos setter/getter.
By adding the `--get-set` you can generate the fields with protected variables and public setter/getter methods. Those methods can help in business logic implementation within the setter/getter methods.

```php
<?php
Expand Down Expand Up @@ -316,7 +318,7 @@ class Products extends Model
}
```

Una buena característica del generador de modelos es que mantiene los cambios realizados por el desarrollador entre las generaciones de código. Esto permite agregar o quitar campos y propiedades, sin el temor de perder los cambios hechos en el modelo. El siguiente video tutorial muestra cómo funciona:
A nice feature of the model generator is that it keeps changes made by the developer between code generations. This allows the addition or removal of fields and properties, without worrying about losing changes made to the model itself. The following screencast shows you how it works:

<div align="center">
<iframe src="https://player.vimeo.com/video/39213020" width="500" height="266" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>
Expand All @@ -326,15 +328,15 @@ Una buena característica del generador de modelos es que mantiene los cambios r

## Andamiaje CRUD

El scaffolding o andamiaje es una manera simple de generar algunas de las grandes piezas de una aplicación. Si desea crear los modelos, visas y controladores para un nuevo recurso en una simple operación, el andamiaje es la herramienta para este trabajo.
Scaffolding is a quick way to generate some of the major pieces of an application. If you want to create the models, views, and controllers for a new resource in a single operation, scaffolding is the tool for the job.

Una vez que el código está generado, debe modificarse para cumplir con sus necesidades. Muchos desarrolladores evitan el andamiaje por completo, optando por escribir todo o la mayor parte del código fuente desde cero. El código generado puede servir como guía para un mejor entendimiento de como trabaja el framework o los prototipos de desarrollo. El siguiente código muestra el andamiaje basado en la tabla `products`:
Once the code is generated, it will have to be customized to meet your needs. Many developers avoid scaffolding entirely, opting to write all or most of their source code from scratch. The generated code can serve as a guide to better understand of how the framework works or develop prototypes. The code below shows a scaffold based on the table `products`:

```bash
$ phalcon scaffold --table-name products
```

El generador de andamios produce varias archivos en su aplicación, junto con algunas carpetas. Aquí un resumen rápido de lo que se generará:
The scaffold generator will build several files in your application, along with some folders. Here's a quick overview of what will be generated:

| Archivo | Propósito |
| ---------------------------------------- | ----------------------------------------- |
Expand All @@ -345,23 +347,23 @@ El generador de andamios produce varias archivos en su aplicación, junto con al
| `app/views/products/edit.phtml` | La vista de la acción `edit` |
| `app/views/products/search.phtml` | La vista de la acción `search` |

Cuando navegamos al controlador recién generado, verá un formulario de búsqueda y un enlace a crear un nuevo producto:
When browsing the recently generated controller, you will see a search form and a link to create a new Product:

![](/assets/images/content/devtools-usage-03.png)

La `página crear` permite crear productos aplicando los validadores en el modelo Products. Phalcon automáticamente validará los campos no nulos produciendo advertencias si alguno de ellos es obligatorio.
The `create page` allows you to create products applying validations on the Products model. Phalcon will automatically validate not null fields producing warnings if any of them is required.

![](/assets/images/content/devtools-usage-04.png)

Después de realizar una búsqueda, el componente de paginado esta disponible para mostrar los resultados en páginas. Utilice los enlaces "Editar" o "Borrar" de cada resultado para realizar dichas acciones.
After performing a search, a pager component is available to show paged results. Use the "Edit" or "Delete" links in front of each result to perform such actions.

![](/assets/images/content/devtools-usage-05.png)

<a name='web-interface'></a>

## Interfaz web para herramientas

Además, si Ud. prefiere, es posible usar las Herramientas de Desarrollador de Phalcon desde una interfaz web. Revise el siguiente video tutorial para ver como funciona:
Also, if you prefer, it's possible to use Phalcon Developer Tools from a web interface. Check out the following screencast to figure out how it works:

<div align="center">
<iframe src="https://player.vimeo.com/video/42367665" width="500" height="266" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen mark="crwd-mark"></iframe>
Expand All @@ -371,7 +373,7 @@ Además, si Ud. prefiere, es posible usar las Herramientas de Desarrollador de P

## Integrando las herramientas en PhpStorm IDE

The screencast below shows how to integrate developer tools with the [PhpStorm IDE](https://www.jetbrains.com/phpstorm/). Los pasos para la configuración pueden ser fácilmente adaptados para cualquier otro IDE para PHP.
The screencast below shows how to integrate developer tools with the [PhpStorm IDE](https://www.jetbrains.com/phpstorm/). The configuration steps could be easily adapted to other IDEs for PHP.

<div align="center">
<iframe width="560" height="315" src="https://www.youtube.com/embed/UbUx_6Cs6r4" frameborder="0" allowfullscreen mark="crwd-mark"></iframe>
Expand All @@ -381,4 +383,4 @@ The screencast below shows how to integrate developer tools with the [PhpStorm I

## Conclusión

Las Herramientas del Desarrollador de Phalcon proveen una forma sencilla de generar código para su aplicación, reduciendo tiempo de desarrollo y potenciales errores de codificación.
Phalcon Developer Tools provides an easy way to generate code for your application, reducing development time and potential coding errors.

0 comments on commit 70f2b69

Please sign in to comment.