Saltar al contenido
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Pruebas

Pruebas PHP

Chamilo utiliza PHPUnit para las pruebas de backend.

Configuración de la base de datos de pruebas

Las pruebas requieren una base de datos dedicada. Cree .env.test.local con las credenciales de su base de datos de pruebas:

DATABASE_HOST='127.0.0.1'
DATABASE_PORT='3306'
DATABASE_NAME='chamilo_test'
DATABASE_USER='root'
DATABASE_PASSWORD='root'

A continuación, inicialice la base de datos de pruebas:

php bin/console --env=test cache:clear
php bin/console --env=test doctrine:database:create
php bin/console --env=test doctrine:schema:create
php bin/console --env=test doctrine:fixtures:load --no-interaction

Para restablecerla tras cambios en el esquema:

php bin/console --env=test doctrine:schema:update --force --complete

Ejecución de las pruebas

Ubicación de las pruebas

Las pruebas se encuentran en el directorio tests/, que no se incluye en las descargas empaquetadas de Chamilo: solo está disponible con un git clone. CoreBundle/ y CourseBundle/ reflejan la estructura de subdirectorios de src/CoreBundle/ y src/CourseBundle/:

Consulte Estructura del proyecto para ver el diseño completo de tests/, incluidos los directorios que no forman parte de la suite de pruebas (datafiller/, history/, procedures/, scripts/).

Tipos de pruebas

  • Pruebas unitarias/de integración — pruebas PHPUnit en CoreBundle/ y CourseBundle/; la mayoría acceden a una base de datos real (mediante dama/doctrine-test-bundle)

  • Pruebas funcionales (API) — extienden AbstractApiTest y prueban los endpoints HTTP de extremo a extremo

  • Pruebas Playwright — pruebas de aceptación a nivel de navegador en tests/playwright/ (véase más abajo)

Pruebas Playwright (de extremo a extremo)

Chamilo utiliza Playwright, impulsado a través de playwright-bdd para que los escenarios permanezcan en Gherkin sencillo. Esto sustituyó a la antigua suite Behat; los escenarios de Behat permanecen en el historial de git y conviene consultarlos al añadir cobertura de un área que antaño se probaba (git ls-tree -r --name-only 98c77757ea6 tests/behat), pero trátenlos solo como una pista de qué flujos importan: los selectores se han degradado, así que verifique contra la aplicación en vivo.

Antes de la primera ejecución, cargue los fixtures que la mayoría de los escenarios dan por existentes, en este orden:

A continuación, ejecute la suite (las semillas y el escenario del instalador quedan excluidos de ella):

yarn test:playwright:install cubre el propio instalador web. Recrea la base de datos, por lo que es solo para CI: nunca lo ejecute contra una instalación que le importe.

Tras editar un archivo .feature o cualquier cosa bajo tests/playwright/steps/, regenere las especificaciones compiladas antes de confiar en una ejecución:

Comprobaciones de frontend

Calidad de código PHP

Chamilo utiliza ECS (Easy Coding Standard), PHPStan y Psalm para la calidad del código. Hay atajos de Composer disponibles para cada uno:

Nota: no hay php-cs-fixer en este proyecto. ECS (symplify/easy-coding-standard) es la herramienta de estilo de código.

Integración continua

Las solicitudes de incorporación (pull requests) se comprueban automáticamente mediante cuatro flujos de trabajo de GitHub Actions:

Flujo de trabajo
Qué ejecuta

phpunit.yml

Suite de pruebas PHPUnit

format_code.yml

Comprobación de estilo de código ECS

php_analysis.yml

Psalm, validación del esquema de Doctrine, comprobador de requisitos de dependencias

playwright.yml

Pruebas de extremo a extremo Playwright (instala Chamilo mediante el instalador web y, a continuación, ejecuta la suite)

Última actualización

¿Te fue útil?