Volver al índice Configuración de Eclipse PDT (1)

En esta lección se explica cómo configurar Eclipse PDT para crear y ejecutar archivos PHP o HTML y organizarlos en carpetas:


Elección del modo de trabajo

En Eclipse PDT los archivos PHP se agrupan en proyectos (projects) que a su vez se agrupan en espacios de trabajo (workspaces). Un espacio de trabajo es la carpeta donde Eclipse PDT guarda todos los proyectos de ese espacio de trabajo. En un mismo ordenador pueden guardarse varios espacios de trabajo, cada uno en una carpeta distinta.

La elección de la ruta del espacio de trabajo es importante. Hay que elegirla en función de cómo queramos trabajar. Como mínimo, el espacio de trabajo incluye los archivos de configuración de Eclipse PDT y de los proyectos que vayamos creando, pero hay que decidir si vamos a incluir en el espacio de trabajo los archivos PHP que vayamos creando y si eso puede dar problemas con el servidor local que utilicemos.

Una solución es tener todo junto, es decir, crear el espacio de trabajo en la carpeta DocumentRoot del servidor web y guardar los archivos PHP en el espacio de trabajo.

Otra solución es separarlo todo, es decir, crear el espacio de trabajo en un sitio, la carpeta DocumentRoot en otro sitio y los archivos PHP en un tercer sitio. Se explica aquí esta segunda solución, que requiere algo más de trabajo, pero que facilita la portabilidad.

En esta lección se explica los pasos a realizar para conseguir que:

Volver al principio


Espacio de trabajo (Workspace)

Al iniciar Eclipse PDT mientras se carga el programa se muestra una imagen que indica la versión de Eclipse. Eclipse PDT 2.0.0 está basado en Eclipse 3.4 (Ganímedes).

Eclipse PDT - Inicio


Al iniciar Eclipse PDT por primera vez se solicita la ruta del espacio de trabajo (workspace) y Eclipse PDT propone una ruta predefinida en la carpeta del usuario, aunque se puede crear en cualquier otro lugar. Se pueden tener incluso varios espacios de trabajo (en carpetas diferentes). Cada vez que se inicia Eclipse PDT se muestran los espacios de trabajo ya definidos y se solicita al usuario que elija uno de ellos, salvo si se marca la casilla de verificación para que utilice el espacio de trabajo actual como espacio predefinido y ya no lo pregunte más. Una vez iniciado Eclipse PDT, se puede cambiar de espacio de trabajo mediante el menú "File > Switch Workspace".

Eclipse PDT - Selección de espacio de trabajo

Volver al principio


Banco de trabajo (Workbench) y perspectivas (Perspectives)

La primera vez que se abre Eclipse PDT se muestra la ventana inicial de la ayuda de Eclipse PDT, con enlaces a una presentación general de Eclipse PDT, novedades de la versión, ejemplos, tutoriales, etc.. Se puede acceder en cuaquier momento a esta ventana mediante el menú Help > Welcome.

Eclipse PDT - Ventana inicial (Haz clic para ver la imagen completa)


Para acceder al banco de trabajo (Workbench), se puede hacer clic en el icono del extremo derecho de la ventana:

Eclipse PDT - Ventana inicial (Haz clic para ver la imagen completa)


Al abrir el banco de trabajo, este muestra una perspectiva, es decir, un conjunto de vistas (subventanas) y menús. Existen varias perspectivas predefinidas para distintos tipos de desarrollos (Java, PHP, CVS, etc). Al abrir Eclipse PDT por primera vez se muestra la perspectiva Recursos (Resource).

Eclipse PDT - Perspectiva Recursos (Haz clic para ver la imagen completa)


Para abrir la perspectiva PHP, se puede hacer clic en el menú Window > Open Perspective > PHP o mediante el icono situado en el extremo superior derecho de la perspectiva.

Eclipse PDT - Abrir perspectiva PHP

Eclipse PDT - Abrir perspectiva PHP


Inmediatamente se abre la perspectiva PHP, mostrando las vistas (subventanas) específicas para el desarrollo en PHP.

Eclipse PDT - Perspectiva PHP (Haz clic para ver la imagen completa)

Volver al principio


Crear proyectos (Project)

Una vez abierta la perspectiva PHP, debe crearse un proyecto en la vista Explorador PHP (PHP Explorer), haciendo clic derecho y eligiendo la opción New > PHP Project.

Eclipse PDT - Creación de nuevo proyecto


Se abrirá una ventana de creación del proyecto en el que basta con escribir el nombre (es mejor que este nombre no debe contenga espacios ni acentos, ya que Eclipse PDT lo utiliza para construir las URL) y hacer clic en Finish. Los proyectos se guardan de forma predeterminada en el espacio de trabajo. En el ejemplo, se ha escrito el nombre "miproyecto". La ventana de creación de proyectos tiene dos pantallas más con opciones de configuración que no se tratan aquí.

Eclipse PDT - Creación de nuevo proyecto


Una vez creado el proyecto, este aparece en la vista Explorador PHP.

Eclipse PDT - Creación de nuevo proyecto

Volver al principio


Crear carpetas enlazadas (Linked folder)

Una vez creado el proyecto, debe crearse una carpeta enlazada (para que los archivos no tengan que estar en el espacio de trabajo, sino en cualquier otro sitio del disco duro). La carpeta se crea en la vista Explorador PHP (PHP Explorer), seleccionando el proyecto y haciendo clic derecho y eligiendo la opción New > Folder.

Eclipse PDT - Creación de carpeta enlazada


Se abrirá una ventana de creación de la carpeta en el que se debe escribir el nombre (es mejor que este nombre no contenga espacios ni acentos, ya que Eclipse PDT lo utiliza para construir las URL) y hacer clic en Advanced. En el ejemplo, se ha escrito el nombre "micarpeta".

Eclipse PDT - Creación de carpeta enlazada


A continuación, se debe marcar la casilla "Link to folder in the file system" y hacer clic en Browse para elegir la carpeta donde se van a guardar los archivos PHP. En el ejemplo, se ha elegido la carpeta "C:\Documents and Settings\Barto\Mis documentos\PHP". Finalmente, se hace clic en Finish.

Eclipse PDT - Creación de carpeta enlazada


Una vez creada la carpeta, esta aparece en la vista Explorador PHP (el icono de una carpeta enlazada muestra una flecha en la esquina inferior derecha).

Eclipse PDT - Creación de carpeta enlazada

Volver al principio


Crear carpetas no enlazadas (Folder)

Una vez creada la carpeta enlazada, en ella se pueden crear todos los archivos y carpetas que se deseen. Estas carpetas ya no necesitan ser carpetas enlazadas.

Para crear una carpeta en la carpeta enlazada, hay que seleccionar la carpeta enlazada en la vista Explorador PHP (PHP Explorer), hacer clic derecho y elegir la opción New > Folder.

Eclipse PDT - Creación de carpeta no enlazada


Se abrirá una ventana de creación de la carpeta en el que se debe escribir el nombre (es mejor que este nombre no contenga espacios ni acentos, ya que Eclipse PDT lo utiliza para construir las URL) y hacer clic en Finish. En el ejemplo, se ha escrito el nombre "pruebas".

Eclipse PDT - Creación de carpeta no enlazada


Una vez creada la carpeta, esta aparece en la vista Explorador PHP (el icono de una carpeta no enlazada es distinto del de la carpeta enlazada).

Eclipse PDT - Creación de carpeta no enlazada

Volver al principio


Crear archivos PHP (PHP File)

Para crear un archivo PHP, hay que seleccionar la carpeta en la que se quiera crear el archivo en la vista Explorador PHP (PHP Explorer), hacer clic derecho y elegir la opción New > PHP File.

Eclipse PDT - Creación de archivo PHP


Se abrirá una ventana de creación de archivo en el que se debe escribir el nombre (es mejor que este nombre no contenga espacios ni acentos, ya que Eclipse PDT lo utiliza para construir las URL) y hacer clic en Finish. En el ejemplo, se ha escrito el nombre "prueba_001.php".

Eclipse PDT - Creación de archivo PHP


Una vez creado el archivo, este aparece en la vista Explorador PHP y su contenido aparece en la vista Editor PHP.

Eclipse PDT - Creación de archivo PHP

En Mi PC puede comprobarse que se ha creado el archivo.

Eclipse PDT - Creación de archivo PHP

Volver al principio


Configurar Apache

Para que los archivos PHP se puedan abrir en el servidor local en una vista de Eclipse PDT o en el navegador del sistema, se debe añadir un alias en el archivo de configuración de Apache httpd.conf.

En el alias se debe utilizar como nombre y ruta los que se hayan indicado al crear el proyecto y la carpeta enlazada en Eclipse PDT. En los ejemplos, el nombre del proyecto era "miproyecto", el nombre de la carpeta enlazada era "micarpeta" y la ruta era "C:/Documents and Settings/Barto/Mis documentos/PHP".

Si ya existe la directiva IfModule (como suele ser habitual), sólo habría que añadir las líneas en negrita del ejemplo siguiente.

<IfModule alias_module>

   Alias "/miproyecto/micarpeta" "C:/Documents and Settings/Barto/Mis documentos/PHP"
   <Directory "C:/Documents and Settings/Barto/Mis documentos/PHP">
     Options Indexes FollowSymLinks Includes ExecCGI
     AllowOverride All
     Order allow,deny
     Allow from all
   </Directory>
ScriptAlias /cgi-bin/ "C:/xampp/cgi-bin/" </IfModule>

En la directiva Alias es necesario escribir entre comillas las rutas que contengan espacios en blanco. En el ejemplo anterior se han escrito las rutas entre comillas aunque no eran necesarias.

Volver al principio


Ejecutar archivos PHP

Los archivos PHP que se estén editando se pueden ejecutar en el servidor local y visualizar en el navegador interno de Eclipse PDT o en el navegador predeterminado del sistema. Este comportamiento se selecciona mediante el menú "Window > Web Browser", eligiendo la opción "Internal Web Browser" (navegador interno) o "Default system Web Browser" (navegador predeterminado del sistema).

Eclipse PDT - Menú Window > Web Browser

Para ejecutar un archivo PHP, el archivo debe estar incluido en alguna carpeta.

Eclipse PDT - Ejecutar un archivo HTML


Hay que seleccionar el archivo PHP en la vista Explorador PHP (PHP Explorer), hacer clic derecho y elegir la opción Run As > PHP Web Page.

Eclipse PDT - Ejecutar un archivo HTML


La primera vez que se ejecuta un archivo PHP, el cortafuegos de Windows puede mostrar un aviso. Es necesario hacer clic en "Desbloquear" para poder ejecutar archivos desde Eclipse PDT.

Eclipse PDT - Ejecutar un archivo HTML

La primera vez que se ejecuta un archivo PHP, Eclipse PDT muestra la URL con la que se ejecutará el archivo. Esta URL se puede modificar, aunque si las carpetas se han creado correctamente y el servidor está configurado correctamente, no es necesario modificarla.

Eclipse PDT - Ejecutar un archivo HTML


Al hacer clic en OK se abrirá una vista de navegador con el archivo seleccionado (en el caso de utilizar el navegador interno) o el navegador del sistema con el archivo seleccionado (en caso de utilizar el navegador del sistema).

Eclipse PDT - Ejecutar un archivo HTML

Volver al principio


Crear archivos HTML

Para crear un archivo HTML, hay que seleccionar la carpeta en la que se quiera crear el archivo en la vista Explorador PHP (PHP Explorer), hacer clic derecho y elegir la opción New > HTML.

Eclipse PDT - Creación de archivo HTML


Se abrirá una ventana de creación de archivo en el que se debe escribir el nombre (es mejor que este nombre no contenga espacios ni acentos, ya que Eclipse PDT lo utiliza para construir las URL) y hacer clic en Next. En el ejemplo, se ha escrito el nombre "prueba_001.html".

Eclipse PDT - Creación de archivo HTML


En la segunda pantalla se debe elegir el tipo de documento HTML y hacer clic en Finish. En el ejemplo se ha elegido la plantilla XHTML 1.0 Strict.

Eclipse PDT - Creación de archivo HTML


Una vez creado el archivo, este aparece en la vista Explorador PHP y su contenido aparece en la vista Editor HTML.

Eclipse PDT - Creación de archivo HTML


En Mi PC puede comprobarse que se ha creado el archivo.

Eclipse PDT - Creación de archivo HTML

Volver al principio


Ejecutar archivos HTML

Eclipse PDT no es capaz de ejecutar directamente en el servidor archivos HTML, pero se puede conseguir creando primero una herramienta externa (External Tool).

Creación de la herramienta externa

Para ello, hay que elegir el menú Run > External Tools > External Tools Configurations ....

Eclipse PDT - Ejecutar un archivo HTML


Se abrirá la ventana de administración de las configuraciones de herramientas externas. En ella hay que hacer clic en "Program".

Eclipse PDT - Ejecutar un archivo HTML


A continuación hay que hacer clic en el icono de "New launch configuration".

Eclipse PDT - Ejecutar un archivo HTML


Se mostrarán las opciones de configuración de las herramientas externas.

Eclipse PDT - Ejecutar un archivo HTML


Hay que escribir el nombre de herramienta (en el ejemplo, "HTML en localhost"), la ruta de la herramienta (en el ejemplo se ha seleccionado el ejecutable firefox.exe del navegador Firefox haciendo clic en "Browse File System...") y los argumentos (en el ejemplo, "localhost${container_path}/${resource_name}"). Para finalizar hay que hacer clic en Apply.

Eclipse PDT - Ejecutar un archivo HTML


Se mostrará la nueva configuración de herramienta externa recién creada. Finalmente, hay que hacer clic en Run para ejecutar en el servidor el archivo HTML elegido al principio y que Eclipse recuerde que se ha utilizado la herramienta externa.

Eclipse PDT - Ejecutar un archivo HTML


Al hacer clic en Run, se abrirá Firefox mostrando el archivo en el servidor local:

Eclipse PDT - Ejecutar un archivo HTML

Igualmente, se pueden crear otras herramientas externas para ejecutar los archivos en otros navegadores (Internet Explorer, etc.)


Utilización de la herramienta externa

Una vez creada la herramienta externa, para ejecutar un archivo HTML, hay que seleccionarlo, abrir elegir el menú Run > External Tools y elegir la herramienta externa creada anteriormente (en el ejemplo, la herramienta se llama "HTML en localhost")

Eclipse PDT - Ejecutar un archivo HTML


Al elegirla, se abrirá Firefox mostrando el archivo en el servidor local:

Eclipse PDT - Ejecutar un archivo HTML


También se puede ejecutar un archivo HTML seleccionando el archivo y haciendo clic en el botón de herramientas externas:

Eclipse PDT - Ejecutar un archivo HTML


El botón de herramientas externas aplica la última herramienta aplicada, pero haciendo clic en el desplegable se podrían ver todas las herramientas externas:

Eclipse PDT - Ejecutar un archivo HTML

Volver al principio


Configurar un editor externo

Eclipse permite configurar un editor externo para un tipo determinado de archivos y abrir desde Eclipse los archivos en ese editor. Como ejemplo, se explica aquí como configurar Amaya como editor externo de los archivos HTML.

Para ello, hay que abrir el menú "Window > Preferences".

Eclipse PDT - Menú Window > Preferences

Completar

Volver al principio

Esta página forma parte del curso "Páginas web con PHP" disponible en http://www.mclibre.org
Autor: Bartolomé Sintes Marco
Última modificación: 7 de abril de 2009

Creative Commons License
Esta obra está bajo una licencia de Creative Commons.