Configuración de Eclipse for PHP developers (2)

Configuración del editor

Abra la ventana de preferencias de Eclipse mediante el menú "Window > Preferences".

En la parte izquierda de la ventana de Preferencias se muestran las secciones y subsecciones en que se organizan las preferencias. Al hacer clic en alguna de las secciones, en la parte derecha de la ventana se muestran las opciones correspondientes.

Haga clic en la flecha situada a la izquierda para mostrar las subsecciones.

Navegador

Desde Eclipse se puede abrir un archivo en el servidor local y visualizarlo en el navegador interno de Eclipse PHP, en el navegador predeterminado del sistema o en un navegador determinado. Yo recomiendo elegir el navegador predeterminado del sistema (y que sea Firefox ;-).

Para ello, en la ventana de Preferencias, sección "General > Web Browser", elija la opción "Use external web browser" (navegador externo a Eclipse) y marque la casilla ", "Default system web browser".

Elegir estilo PSR-2

En estos apuntes se sigue y recomienda seguir las recomendaciones de estilo PSR-2, como se explica en la lección Guía de estilo PHP de los apuntes de PHP.

Eclipse PHP está configurado de forma predeterminada para seguir estas recomendaciones, pero, de todas formas, compruebe en la ventana de Preferencias, sección "PHP > Code Style > Formatter", que el perfil activo es "PSR-2".

Además, en la ventana de Preferencias, sección "General > Editors > Text Editors",

• Marque la opción "Insert spaces for tabs" (insertar espacios en vez de tabuladores) y comprobar que el valor "Displayed tab width" (tamaño del sangrado) sea 4. Así, cada vez que se pulse la tecla Tabulador, Eclipse escribirá 4 espacios en blanco.
• Yo aconsejo marcar la opción "Show print margin" (mostrar márgenes de impresión) y comprobar que el valor "Print margin column" (posición del margen) sea 80.
• Yo aconsejo marcar la opción "Show whitespace characters" (mostrar espacios en blanco). Así, en los espacios en blanco se mostrará un punto intermedio que ayuda a contar caracteres y facilita la comprobación de la sangría de cada línea.

Haga clic en el enlace "configure visibility" para especificar qué espacios en blanco serán visibles:

• Yo aconsejo desmarcar las casillas "Carriage Return" y "Line Feed" para no mostrar nada al final de las líneas.
• Ajuste numéricamente la transparencia de los caracteres que se muestran en los espacios en blanco (aumente el valor para reducir la transparencia).

Juego de caracteres y finales de línea

Las recomendaciones de estilo PSR-2 recomiendan utilizar el juego de caracteres UTF-8 y finales de línea Unix.

Para ello, en la ventana de Preferencias, sección "General > Workspace", cambie los valores "Text file encoding" y "New text file line delimiter" a UTF-8 y Unix, respectivamente:

En la ventana de Preferencias, sección "Web > HTML Files", cambie el valor "Encoding" a ISO 10646/Unicode(UTF-8):

En la ventana de Preferencias, sección "Web > CSS Files", cambie el valor "Encoding" a ISO 10646/Unicode(UTF-8):

Espacios en blanco al final de las líneas

Eclipse puede borrar automáticamente los espacios en blanco que se encuentran al final de cada línea.

Para ello, en la ventana de Preferencias, sección "PHP > Editor > Save Actions", marque la casilla "Remove trailing whitespace" y el botón radio "All lines":

Sangrado en archivos HTML y CSS

En la ventana de Preferencias, sección "Web > CSS Files > Editor", los cambios que aconsejo con respecto a los valores predeterminados son los siguientes:

• Seleccione el botón radio "Indent using spaces"
• Aumente a 2 el valor de "Indentation size".

En la ventana de Preferencias, sección "Web > HTML Files > Editor", los cambios que aconsejo con respecto a los valores predeterminados son los siguientes:

• Seleccione el botón radio "Indent using spaces"
• Aumente a 2 el valor de "Indentation size".

Asistentes de escritura

Al escribir comillas, llaves, paréntesis, corchetes, etc, en fragmentos de código PHP, Eclipse los cierra automáticamente. Si se quiere desactivar ese comportamiento, en la ventana de Preferencias, sección "PHP > Editor > Typing", los cambios que aconsejo con respecto a los valores predeterminados son los siguientes:

• Desmarque la casilla ""Strings""
• Desmarque la casilla "(Parenthesis) and [square] brackets"
• Desmarque la casilla "{Braces}"
• Desmarque la casilla "phpDoc and comment regions"
• Desmarque la casilla "Close PHP tag (?>)".
• Desmarque la casilla "Add 'php' after PHP start tag (<?)

Nota: No tengo claro para qué sirve la casilla "Tab key indents the current line", porque parece que Eclipse funciona igual marcada que sin marcar.

Al escribir etiquetas o comentarios en fragmentos de código HTML, Eclipse los cierra automáticamente. Si quiere desactivar ese comportamiento, en la ventana de Preferencias, sección "Web > HTML Files > Editor > Typing", los cambios que aconsejo con respecto a los valores predeterminados son los siguientes:

• Desmarque la casilla "Insert a matching end tag"
• Desmarque la casilla "Automatically close the tag"
• Desmarque la casilla "Comments"
• Desmarque la casilla "Attribute values"
• Desmarque la casilla "(Parentheses) and [square] brackets"
• Desmarque la casilla "End tags when creating empty self-closing tags"

Asistentes de código

Al escribir código PHP, Eclipse ofrece sugerencias de forma automática, lo que puede resultar engorroso.

Si quiere desactivar este comportamiento, en la ventana de Preferencias, sección "PHP > Editor > Content Assist", desmarque la casilla "Enable auto activation".

Al escribir código HTML, Eclipse ofrece sugerencias de forma automática, lo que puede resultar engorroso.

Si quiere desactivar este comportamiento, en la ventana de Preferencias, sección "Web > HTML Files > Content Assist", desmarque la casilla "Automatically make suggestions".

Tipo y tamaño de letra

En Windows, el tipo de letra determinado del editor es la fuente Consolas a 10pt.

Para modificarlo, en la ventana de Preferencias, sección "General > Appearance > Colors and Fonts", haga doble clic en "Basic > Text Font:

Se abrirá una ventana que le permitirá elegir el tipo de letra y su tamaño:

Al aplicar el cambio, el editor utilizará el tipo y tamaño elegidos: