PadeGest

Un proyecto de aplicación web de gestión integral de un club de pádel para la asignatura de Aprendizaje Basado en Proyectos, basado en el esqueleto de aplicación de CakePHP 3.x.

Instalación

Primero descarga Composer, o actualízalo: composer self-update.

Método 1: instalación tras clonado manual

Asumiendo que ya has clonado este repositorio, y que tu directorio de trabajo actual es el directorio raíz del repositorio, instala PadeGest usando Composer:

composer install

Método 2: instalación automática

Alternativamente al método anterior, puedes dejar que Composer clone el repositorio por ti. Para ello, crea o edita el fichero config.json en el directorio COMPOSER_HOME, de forma que tenga el siguiente contenido:

{
    "repositories": [
        {
            "type": "vcs",
            "url": "git@github.com:aggarcia3/PadeGest.git"
        }
    ]
}

Ahora puedes crear el proyecto de Composer, de manera similar a cómo se haría con la aplicación esqueleto de CakePHP. Con --keep-vcs el repositorio se inicializa automáticamente: sin ese parámetro, simplemente se descargan sus archivos.

composer create-project --prefer-dist --stability=dev --keep-vcs aggarcia3/padegest PadeGest

Avanzado: integración de Composer y PHP para Windows con Cygwin

Esta respuesta de StackOverflow da buenas instrucciones acerca de cómo combinar esas herramientas.

Ejecutando la aplicación

Una vez instalado PadeGest, puedes usar tu servidor web local para interactuar con la aplicación, o iniciar el servidor web embebido de desarrollo con:

bin/cake server -p 8765

Si todo va bien, al visitar http://localhost:8765 te encontrarás con PadeGest. El comando anterior asume que tu directorio de trabajo actual es el directorio raíz de este repositorio.

Editor recomendado

Se recomienda Visual Studio Code, con las extensiones recomendadas indicadas por este repositorio. Entre otras funcionalidades, proporciona:

Comprobación de errores de sintaxis PHP.
Documentación acerca de clases y métodos de CakePHP.
Comprobación de estilo del código fuente, y formateo automático.

Integración continua

Usamos ContinuousPHP para ejecutar un trabajo para cada confirmación enviada al repositorio, enfocado a ejecutar tests de integración y de coherencia del código fuente. Este servicio de CI es también una buena fuente de información acerca de cómo trabajar con la aplicación, y qué requisitos tiene.

Para ver los resultados de CI de una confirmación, observa la lista de "Commits" del repositorio, y haz clic en la aspa roja o tick verde de la confirmación deseada (el aspa significa que algo ha ido mal, mientras que el tick simboliza que todo fue bien).

Corregir que el DebugKit de CakePHP no se visualice

El DebugKit de CakePHP es un menú desplegable con opciones de depuración bastante útiles, que aparece en la esquina inferior derecha de todas las páginas web de la aplicación, y debería de ser visible mientras esté activado el modo de depuración:

Sin embargo, dependiendo de cómo esté configurado PHP en el sistema, este menú puede no aparecer, pues el componente necesita la extensión pdo_sqlite para funcionar en su configuración por defecto. La solución más sencilla a este problema relativamente común es añadir una entrada como la siguiente al archivo de configuración php.ini:

extension=pdo_sqlite