Herramientas de Desarrollo

Volver al índice
Documentación desarrolladores

Puede ser utilizado cualquier entorno de desarrollo. De todas maneras aquí hay una lista de herramientas muy recomendable por su integridad, calidad y productividad del desarrollo que aportan. Son utilizadas por la mayoría de los desarrolladores principales de Dolibarr. Tenga en cuenta que todas estas soluciones son gratuitas y OpenSource.

Para todos los desarrolladores

Aquí está la base de trabajo recomendado, no obstante cualquier herramienta que respete el estándar Web, PHP, MySQL puede realizar bien el trabajo.

Un servidor AMP

• Apache, Mysql y PHP

En Linux: Estos 3 productos están disponibles en todas las distribuciones.

En Windows: Instalar WampServer 2 (base de datosMysql, Apache y PHP todo en uno). El servidor WAMP ofrece el trio MySql+Apache+PHP, con la posibilidad de bascular de versión para cualquiera de sus componentes con un simple clic.

Firefox y plugins

• Firefox 3.0 con los plugins:
  • HTML Validator
  • Phplangeditor
  • Firebug + Firecookie
  • phplangeditor y los diccionarios de los idiomas en los que usted planea trabajar
  • Cert Viewer Plus si quiere realizar pruebas en HTTPS.
  • FoxyProxy si quiere bascular rápidamente su navegador hacia las utilidades Proxy (WebScarab)
  • User agent switcher para simular accesos desde un smartphone

Descargables desde el sitio http://www.firefox.com

SquirrelSQL

• SquirrelSql para la administración de la base de datos

Descargable desde el sitio http://squirrel-sql.sf.net

Eclipse y plugins

Instalación de Eclipse

Recomendamos la versión :

https://eclipse.org/pdt/

De lo contrario, puede encontrar las versiones disponibles en el sitio Eclipse.

Instalación del plugin Eclipse para PHP: PDT

Para ello, utilizar el método Find And Install y agregar la URL de actualización:

https://download.eclipse.org/releases/xxx - xxx = version

Or from the GUI of any Eclipse =>Install New Software =>Work With Kepler => Wait until list display =>General Purpose Tools Check PHP development tools (PDT)=>Install

Configurar Eclipse para recuperar la versión CVS

Una vez que tenga instalado Eclipse, puede conectar al repositorio CVS para recuperar la última versión de desarrollo.

• Cree un nuevo proyecto : File >> New >> Projects y seleccione "Project from CVS" et "Next"
• Seleccione "Create a new repository location" y "Next"
• Rellene la ventana siguiente como sigue:
  • Host : cvs.savannah.nongnu.org
  • Repository path : /cvsroot/dolibarr
  • User : anonymous
  • Password : (dejar vacío)
  • Connection type : pserver
  • Use default port
• Rellenar el campo Use specified module name : dolibarr
• A continuación, elija el nombre que el proyecto tendrá en su equipo:
  • Comprobar Check out as a projet in the workspace
  • Project Name : dolibarr
  • Comprobar Checkout subfolders
• A continuación, dejar la ruta por defecto del workspace y "Next"
• Por último, seleccione la rama a cargar
  • HEAD es la versión de desarrollo
  • Las versiones 2.6, 2.7, etc., se situan en sus respectivas ramas
• Haga clic en "Finish"

Los archivos deberían descargarse en su equipo local.

Para actualizar la versión de su máquina, debe pasar a la perspectiva "Team Synchronizing" para utilizar la funcionalidad "Synchronize CVS", lo que dará lugar a la descarga de la última versión en su equiplo local. Sólo se descargan los archivos que han cambiado.

Opcional

Si gestiona otros proyectos en SVN

• Instalación del plugin para Eclipse para SVN: SubClipse

para ello, utilizar el metódo Find And Install y agregar la URL de actualización:

http://subclipse.tigris.org/install.html

o

• Instalación del plugin para Eclipse para SVN: Subversive

http://community.polarion.com/projects/subversive/download/eclipse/2.0/ganymede-site/ - [required] Subversive SVN Connectors
http://community.polarion.com/projects/subversive/download/integrations/ganymede-site/ - [optional] Subversive Integrations

Si desea realizar scripts en Perl

• Instalación del plugin Eclipse para Perl: EPIC

Para ello, utilizar el método Find And Install y agregar la URL de actualización: http://e-p-i-c.sourceforge.net/updates

Si desea desarrollar módulos con el generador UML2Dolibarr

Un método para generar un módulo funcional desde UML se encuentra en fase de puesta a punto. Más información en la página Generar un módulo con MDA. Para utilizarlo, deberá instalar los siguientes componentes:

• Instalación de TopCased 1.4 ó +: http://www.topcased.org

• Instalación de acceleo 2.2.1 ó +

Para ello, utilizar el médoto Find And Install y agregar la URL de actualización: http://www.acceleo.org/update/

• Instalación d'UML2Dolibarr

Para ello, recupere los proyectos con el comando:

svn checkout svn://svn.forge.objectweb.org/svnroot/acceleo/trunk/modules/community/uml21/dolibarr/trunk/

e impórtelos en Eclipse.

Si trabaja bajo Windows

• WampServer 2 (para disponer de la base de datos Mysql, Apache y PHP todo en uno). El servidor WAMP ofrece el trio MySql+Apache+PHP instalado llave en mano, con posibilidad de cambiar de versión, para cualquiera de estos componentes con un solo clic). ¡Imprescindible!

• Notepad++ (para aquellos que no soportan el uso de Java o un viejo cuco demasiado bajo para Eclipse).

• WinMerge (para la comparación de ficheros o carpetas)

• CygWin (para los comandos patch y los comandos en línea cvs si prefiere la línea de comandos)

Si usted quiere realizar depuración paso a paso o ajustada (XDebug)

• Para agregar información de tuning en la barra de estado del navegador, agregar la variable de entorno DOL_TUNING con valor 1, para ello incluya la siguiente línea en su fichero apache.conf:

SetEnv DOL_TUNING 1

A continuación, compruebe que su navegador no tiene una opción para bloquear la barra de tareas por javasscript.

• Para el ajuste a la línea de código, instale XDebug:

En Ubuntu: Instalar el paquete php-Xdebug

En Wampserver/Windows, descargar el archivo php_debug_xxx.dll desde http://www.xdebug.org y guardarlo en el directorio /ext de php de WampServer.

• Modificar el fichero php.ini (ó xdebug.ini) para agregar los parámetros

 [xdebug]
 xdebug.remote_enable=on
 xdebug.remote_handle=dbgp
 xdebug.remote_host=localhost
 xdebug.remote_port=9000
 xdebug.profiler_enable=1
 xdebug.show_local_vars=off
 xdebug.profiler_output_dir=c:/temp
 xdebug.profiler_append=0

• A continuación, para analizar los archivos de perfiles generados por Xdebug, puede instalar KCacheGrind (Linux) o WinCacheGrind (Windows).

Para desarrollar o usar los tests tests PHPUnit

From Eclipse

You can also optionnally install The PHP Tools integration for Eclipse:

http://www.phpsrc.org/eclipse/pti/

From command line

Instalar PHPUnit

• Descargar el archivo de la versión desde http://pear.phpunit.de/get/ y descomprimir el contenido en un directorio que se encuentre incluido en el parámetro include_path de su archivo de configuración php.ini.
• Preparar el script phpunit:
  • Bajo Linux: Renombrar el script phpunit.php a phpunit y remplazar la cadena @php_bin@ del archivo con la ruta completa de la línea de comandos del intérprete PHP (normalmente /usr/bin/php).
  • Bajo Windows: Remplazar la cadena @php_bin@ del archivo phpunit.bat con la ruta complete de la línea de comandos del intérprete de PHP y remplazar la cadena @bin_dir@ con el directorio de PHPUnit.
  • Modificar su PATH para incluir el directorio que contiene phpunit.
  • Asignar los permisos de ejecución (chmod +x phpunit bajo Linux).
• Preparar el script PHPUnit/Util/PHP.php:
  • Remplazar la cadena @php_bin@ del archivo con la ruta completa de la línea de comandos del intérprete PHP (normalmente /usr/bin/php).
• También se requiere el módulo xdebug si desea realizar informes de la cobertura de los tests.

Ejecutar los tests PHPUnit

• Ir al directorio /test de la versión CVS. Consulte el archivo README para conocer el proceso de ejecución de una batería de tests.

Configuración CVS

Si es un desarrollador oficial con acceso a CVS en escritura, añadir en la configuración de su Eclipse CVS, una entrada a CVS.

• :ext:yourlogin@cvs.savannah.nongnu.org:/cvsroot/dolibarr para la versión principal de Dolibarr.
• :ext:yourlogin@cvs.savannah.nongnu.org:/cvsroot/dolibarrmod para los módulos externos.

En caso contrario deberá descargar los fuentes disponibles desde la página web Dolibarr (http://www.dolibarr.org) en el área de descargas.