Creando Facturados mi primera aplicación saas (2) Configuración de entorno

Facturados homepage

En esta segunda historia voy a mostrar un poco la configuración inicial de mi entorno de desarrollo antes de comenzar el proyecto, vale destacar que uso windows como sistema operativo.

Algunos detalles los pasare por alto como son la instalación de composer y git ambas herramientas cuentan con paginas bien explicadas sobre su instalación y también existen muchos tutoriales dedicados a esos temas.

Voy a utilizar:

  • Laragon entorno wamp todo en uno listo para usar con ventajas adicionales como la creacion automatica de dominios virtuales. Importante destacar que laragon incluye composer y git por lo que incluso no es necesario realizar una instalación aparte.
  • phpstorm IDE de desarrollo de bastante ayuda para moverse rapido a lo largo del proyecto y y uy completo en terminos de la ayuda y facilidad que brinda al desarrollador

Confiurando laragon

Laragon no tiene mayor complejidad, una vez descargado el instalador desde la pagina y e instalarlo en el pc (al instalar existe la opción de permitir crear los dominios virtuales de manera automática, recomiendo marcarla) solo queda ponerlo en marcha e ir a la carpeta que crea para alojar los proyectos siendo por default C:\laragon\www alli para cualquier carpeta que se cree laragon creara un host virtual usando el nombre de la carpeta y añadiendo el “punto dev” (.dev) también configurable y el cual he modificado desde el panel de configuración para ser .app

laragon configuración

Instalando Laravel

En la carpeta elegida para almacenar los proyectos de laragon se crea la carpeta de facturados utilizando el script de instalación de Laravel, en la documentación oficial podemos ver como instalarlo.

laravel new facturados

Configurando phpStorm

Una vez creado el proyecto es momento de configuar phpstorm para trabajar con el

  • Abrimos phpstorm y seleccionamos la opción de “new porject from existing files”, si el panel inicial de phpstorm no se muestra y en cambio se abre directamente el editor esta opcioen se encuentra en barra de menu->file->new porject from existing files.
  • Se nos abrirá una nueva ventana preguntando donde esta nuestro servidor, en principio podemos dejar marcada la primera opción “Web server installed locally…” y dar click en siguiente
  • Donde buscaremos la carpeta de nuestro proyecto y marcarla como la raiz del mismo de igual forma buscamos la carpeta de tests y la marcamos como la raiz de nuetros tests y hacemos click en next.
  • Una nueva ventana se abre y nos pregunta por el server local donde agregaremos uno nuevo seleccionando la de “add new local server” y marcando “don’t check http connection” luego haces click en next.
  • Completamos la información agregando un nombre al servidor local y usando la url del virtual host creada por laragon para nuestro proyecto en este caso facturados.app, nuevamente marcamos “don’t check http connection” y next.

A este momento phpstorm comienza a cargar los archivos de nuestro proyecto e indexarlos para trabajar con el una vez esto concluya podremos trabajar en nuestro proyecto, pero existen algunas configuraciones adicionales que podemos usar para mejorar nuestra experencia con el ide.

Phpstorm language level y cli executable

Si nos vamos a la configuración de nuestro proyecto (crtl + alt +s) luego languages and frameworks y seleccionamos php vemos las opciones de configuar la version de php con la que trabajaremos

Configuración de versión de PHP
  • PHP language level nos peermite definir el tipo de corrección que usara phpstorm en nuestro proyecto, seleccionamos 7.1 para poder usar todas las características de php en su ultima versión.
  • El CLI Interpreter es es ejecutable de php que el ide usara para correr y hacer debug en nuestro proyecto ademas nos permite usar composer, artisan cli y phpunit entre otras cosas desde phpstorm, si no esta configurado debemos hacer click en los tres puntos y esto nos abrira un explorador para navegar hasta el ejecutable de php, usando laragon y su configuracion por default este ejecutable esta en: C:\laragon\bin\php\php-7.1.5\php.exe.

Hacemos click en apply y acept y tenemos configurado phpstorm para nuestra version de php

PHPStorm y phpunit

Para correr phpunit desde phpStorm debemos ir a la configuración de nuestro proyecto (crtl + alt +s) luego languages and frameworks y seleccionamos php y luego phpunit allí vamos a configurar el path de nuestro script y el archivo de configuracion de phpunit para el proyecto.

configuración de phpunit en phpstorm

el path to script es el autoload de composer abrimos el explorador (…) y buscamos la carpeta de nuestro proyecto -> vendor -> autoload.php y damos click en aceptar, esto refresca la ventana de configuración y nos muestra la versión de phpunit instalada. Ahora marcamos Default configuration file para indicar que debe usar esta configuración para correr todos nuestros test nos vamos abrimos el explorador y buscamos el archivo phpunit.xml en la raiz de nuestro proyecto damos click en aceptar y listo. Podemos probar quetodo funciona seleccionando nuestra carpeta de test en la navegacion lateral del IDE y usando la configuracion de teclas (ctrl+ shift + f10) o click derecho run test si todo funciona bien, los test de ejemplo de laravel deben ejecutarse y deberiamos ver como pasan.

phpunit running on phpstorm

Eso es todo por ahora, hay algunas configuraciones adicionales que ire haciendo más adelante.

Nota: Esta configuración es la misma que uso para cada proyecto que comienzo y sobre el cual puedo elegir, por lo general si el proyecto es mediano mi configuración tiende a cambiar para ajustarse a los requerimientos del proyecto como por ejemplo incluyendo el uso de docker o homestead