Tabla de contenido:
Este es un proyecto de demostración para proporcionar un ejemplo de mis habilidades en programación orientada a objetos usando PHP, escribiendo pruebas unitarias PHPUnit y aprovechando herramientas como Composer (un administrador de dependencias para PHP), Git (un sistema de control de versiones distribuido) y, el Shell Unix. También refleja mi conocimiento de plataformas de desarrollo modernas como GitHub (un centro de repositorios de código fuente en línea), Codecov (para obtener información sobre la cobertura del código) y CircleCI (integración y entrega continuas).
Este proyecto no ha sido escrito en ningún caso pensando para ser utilizado en producción, sino que puede ser utilizado como usted quiera bajo su total responsabilidad. También puedes bifurcarlo y utilizarlo como base para tu propio proyecto si lo encuentras útil.
OoWordpressNonces es un paquete Composer para WordPress que se ocupa de WordPress Nonces utilizando un enfoque de programación orientada a objetos .
No reemplaza el sistema original de WordPress Nonces, este paquete es solo un contenedor, utilizando un enfoque OOP , para las funciones originales de WordPress Nonces .
El código es simple, se explica por sí mismo y está completamente documentado. En el código fuente, cada método de clase tiene un enlace a la función original de WordPress que incluye. Para más detalles puedes ver la documentación oficial de WordPress para Nonces
Puede instalar OoWordpressNonces agregando esta especificación del repositorio de paquetes al archivo composer.json
de su proyecto:
{
"repositories": [
{
"type": "vcs",
"url": "https://github.com/josepcrespo/oo-wordpress-nonces"
}
],
"require": {
"josepcrespo/oo-wordpress-nonces": "master"
}
}
y luego ejecute php composer.phar update
.
En esta sección, puede obtener instrucciones para configurar este proyecto en su máquina local con fines de desarrollo y prueba.
Clona el proyecto usando Git:
git clone https://github.com/josepcrespo/oo-wordpress-nonces.git
o descargue un archivo ZIP con todos los archivos del proyecto: https://github.com/josepcrespo/oo-wordpress-nonces/archive/master.zip
Antes de comenzar a instalar Composer:
- PHP instalado en su sistema es un requisito obligatorio. Si su entorno de desarrollo se ejecuta en macOS, le recomiendo instalarlo usando Homebrew
- Antes de empezar a utilizar Homebrew es muy recomendable tener Xcode instalado y actualizado. Puede instalar/actualizar Xcode usando la App Store de macOS.
- Si está utilizando macOS , también necesita instalar las herramientas de línea de comandos de Xcode. Para instalar/actualizar las herramientas de línea de comandos de Xcode , escriba este comando usando Terminal.app (después de haber instalado o actualizado Xcode ):
xcode-select --install
Para instalar rápidamente Composer en el directorio actual, consulte la página oficial de descarga de Composer para obtener instrucciones actualizadas.
Para instalar las dependencias definidas para su proyecto, simplemente ejecute el comando de instalación de Composer en el directorio raíz del proyecto usando Terminal.app (si está usando macOS ) o con su Shell preferido:
php composer.phar install
Es posible que desee consultar las pautas oficiales de Composer para instalar dependencias para obtener más detalles.
Si utilizó la opción --filename
en la instalación de Composer
- Tal vez hayas instalado Composer usando la opción de instalación
--filename
, por ejemplo de esta manera:php composer-setup.php --filename=composer
En ese caso, debes ejecutarcomposer install
para instalar las dependencias.
Las Pruebas Unitarias de este paquete se han realizado utilizando PHPUnit.
cp phpunit.xml.dist phpunit.xml
vendor/bin/phpunit
Después de ejecutar las pruebas, puede ver los resultados de la cobertura de las pruebas abriendo el archivo index.html
creado en la carpeta tests/code-coverage-reports/html-format/
.
Si PHPUnit arroja un mensaje de error que dice que no puede encontrar alguna clase utilizada en las pruebas.
- Utilice el siguiente comando de Composer y luego vuelva a ejecutar las pruebas.
php composer.phar dump-autoload
Necesita la extensión PHP Xdebug habilitada.
- La funcionalidad de cobertura de código de PHPUnit está configurada de forma predeterminada para este proyecto. Hace uso del componente PHP_CodeCoverage , que a su vez aprovecha la funcionalidad de cobertura de código proporcionada por la extensión Xdebug para PHP.
- Si no desea ver la cobertura del código o no puede habilitar correctamente la extensión Xdebug, puede eliminar la entrada
completa presente en el archivo de configuración phpunit.xml.