Configuración de Eclipse PDT (1) 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:
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:
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).
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ú "".
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ú .
Para acceder al banco de trabajo (Workbench), se puede hacer clic en el icono del extremo derecho de la ventana:
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).
Para abrir la perspectiva PHP, se puede hacer clic en el menú o mediante el icono situado en el extremo superior derecho de la perspectiva.
Inmediatamente se abre la perspectiva PHP, mostrando las vistas (subventanas) específicas para el desarrollo en PHP.
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 .
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í.
Una vez creado el proyecto, este aparece en la vista Explorador PHP.
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 .
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".
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.
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).
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 .
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".
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).
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 .
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".
Una vez creado el archivo, este aparece en la vista Explorador PHP y su contenido aparece en la vista Editor PHP.
En Mi PC puede comprobarse que se ha creado el archivo.
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.
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ú "", eligiendo la opción "Internal Web Browser" (navegador interno) o "Default system Web Browser" (navegador predeterminado del sistema).
Para ejecutar un archivo PHP, el archivo debe estar incluido en alguna carpeta.
Hay que seleccionar el archivo PHP en la vista Explorador PHP (PHP Explorer), hacer clic derecho y elegir la opción .
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.
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.
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).
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 .
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".
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.
Una vez creado el archivo, este aparece en la vista Explorador PHP y su contenido aparece en la vista Editor HTML.
En Mi PC puede comprobarse que se ha creado el archivo.
Eclipse PDT no es capaz de ejecutar directamente en el servidor archivos HTML, pero se puede conseguir creando primero una herramienta externa (External Tool).
Para ello, hay que elegir el menú .
Se abrirá la ventana de administración de las configuraciones de herramientas externas. En ella hay que hacer clic en "Program".
A continuación hay que hacer clic en el icono de "New launch configuration".
Se mostrarán las opciones de configuración de las herramientas externas.
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.
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.
Al hacer clic en Run, se abrirá Firefox mostrando el archivo en el servidor local:
Igualmente, se pueden crear otras herramientas externas para ejecutar los archivos en otros navegadores (Internet Explorer, etc.)
Una vez creada la herramienta externa, para ejecutar un archivo HTML, hay que seleccionarlo, abrir elegir el menú y elegir la herramienta externa creada anteriormente (en el ejemplo, la herramienta se llama "HTML en localhost")
Al elegirla, se abrirá Firefox mostrando el archivo en el servidor local:
También se puede ejecutar un archivo HTML seleccionando el archivo y haciendo clic en el botón de herramientas externas:
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 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ú "".
Completar
Esta página forma parte del curso "Páginas web con PHP" disponible en http://www.mclibre.org
Esta obra está bajo una licencia de Creative
Commons.