Montar entorno de desarrollo de Dolibarr con Eclipse

Vamos a montar un entorno de desarrollo de Dolibarr con Eclipse PHP utilizando el plugin de PTD que nos aporta funcionalidades muy útiles para poder desarrollar con proyectos de PHP.

Descargamos Eclipse PHP desde: https://eclipse.org/pdt/#download

Las características que nos ofrece PDT las podemos consultar aquí: http://p2.pdt-extensions.org/index.html

Tras instalar Eclipse buscamos si hay actualizaciones existentes. En la propia página descarga nos indica que realicemos estos pasos:

En Eclipse, hacer clic en Help -> Install New Software y hacer la búsqueda con esta url:: http://download.eclipse.org/tools/pdt/updates/3.6

Eclipse ya trae instalado el plugin para poder trabajar con Git, por lo que para poder importar el proyecto desde Git hacemos lo siguiente. Anotamos la url de Git de Dolibarr: https://github.com/Dolibarr/dolibarr

Y realizamos los siguientes pasos desde Eclipse.

Ayuda de Dolibarr Wiki: https://wiki.dolibarr.org/index.php/Recuperar,_actualizar_los_fuentes_del_proyecto

Podemos importar el proyecto de Dolibarr a nuestro eclipse desde dos maneras. Una de ellas es desde File > Import... y seleccionar Projects from Git.

Y después seleccionar la opción Clone URI.

O hacerlo mediante la Perspectiva de Git, seleccionando la opción Clone a Git repository.

En cualquiera de los dos casos, nos aparecerá la siguiente ventana donde tendremos que indicar la url del repositorio Git de Dolibarr en el campo URI y después pulsar el botón Next.

Puede que obtengamos un mensaje de error "Git repository clone failed" donde nos dice además que "cannot open git-upload-pack".

Esto quiere decir que no hemos introducido la url correcta. Si no estamos habituados a trabajar con Git seguramente hayamos introducido la url del navegador, como se suele hacer con SVN, pero con Git es diferente. Desde la web del repositorio, en la parte inferior de la siguiente imagen, veremos que hay un campo con una url HTTPS. Será esa url la que tendremos que usar al clonar el proyecto desde Eclipse.

Una vez introducida la url en el paso anterior se nos mostrará una ventana donde podemos seleccionar la versión de Dolibarr que queremos importar. Aunque podemos seleccionarlas todas, es mejor seleccionar solo una para evitarnos problemas después.

En la siguiente ventana que se nos muestra no habría que hacer nada en principio, le damos a Next.

Y empezará a descargarse toda la rama seleccionada a nuestro local.

Si obtenemos algún mensaje como el que muestro, "Git repository clone failed. Read timed out after 30.000 ms.", puede que nuestra conexión de red no esté bien. En mi caso, repetí el proceso con otra conexión de internet diferente y ya no me dio problemas.

Si todo se realiza sin problemas, podremos ver que ya tenemos el repositorio en nuestra perspectiva de Git con la rama de Dolibarr 3.8 seleccionada.

Ahora solo quedaría crear el proyecto de eclipse para poder desarrollar sobre esa rama. Para ello, desde la carpeta Working Directory con el botón derecho del ratón seleccionamos la opción Import Projects.

Indicamos que la importación la realizaremos sobre un proyecto nuevo utilizando el asistente.

Seleccionamos PHP Project.

En esta ventana, la clave del proceso está en seleccionar la opción Create project at existing location (from existing source), para poder importarlo desde la rama de Git que nos hemos descargado. Indicaremos la carpeta que seleccionamos en los pasos anterior donde hicimos el clone.

El resultado es el proyecto de PHP creado que podemos ver desde la perspectiva de PHP. Si nos fijamos, cada archivo y carpeta tiene el icono amarillo de estar sincronizado con el repositorio indicando que hemos realizado el proceso correctamente.

Ahora solo falta configurar el Build Path según las indicaciones de la wiki de Dolibarr, dejándolo como se muestra en la siguiente imagen.

Y eso es todo. Ya solo queda empezar a cacharrear un poco y aprender a programar sobre esta fantástica herramienta ERP.