Cada uno de los anteriores est\u00e1 destinado a proporcionar una introducci\u00f3n sobre c\u00f3mo comenzar a escribir pruebas unitarias muy b\u00e1sicas. Las cosas pueden volverse m\u00e1s complejas, especialmente a medida que crece una aplicaci\u00f3n o un proyecto (pero eso siempre es cierto, \u00bfno?).<\/p>\n
Pero para asegurarse de que uno est\u00e9 preparado para eso, hay un componente final para las pruebas unitarias en el que creo que debemos centrarnos y es comprender el archivo de configuraci\u00f3n PHPUnit XML (que puede haber visto en otros proyectos como phpunit.xml).<\/p>\n
Configuraci\u00f3n PHPUnit XML<\/h2>\n
Entonces, en esta publicaci\u00f3n, configurar\u00e9 un proyecto simple que usa PHPUnit, escribe algunas pruebas como las que ya hemos visto y aprovecha un archivo de configuraci\u00f3n para automatizar las pruebas.<\/p>\n
Adem\u00e1s, har\u00e9 lo que pueda para explicar mejor las partes necesarias del archivo de configuraci\u00f3n para que pueda incluir uno en su pr\u00f3ximo proyecto.<\/p>\n
1 Eliminando los archivos<\/h3>\n
Antes de comenzar a escribir c\u00f3digo comprobable, es importante conocer los archivos que se necesitar\u00e1n para que el proceso funcione.<\/p>\n
La siguiente es, m\u00e1s o menos, c\u00f3mo organizamos<\/a><\/strong> las cosas desde el principio de un proyecto:<\/p>\n Eventualmente, tambi\u00e9n ver\u00e1s:<\/p>\n En este punto, sin embargo, echemos un vistazo al archivo de configuraci\u00f3n XML y luego intentemos ejecutar PHPUnit autom\u00e1ticamente sin ning\u00fan otro par\u00e1metro.<\/p>\n Primero, veamos el archivo de configuraci\u00f3n b\u00e1sica:<\/a><\/strong><\/p>\n Ahora entendamos qu\u00e9 es exactamente lo que estamos viendo (aparte del XML simple).<\/p>\n Dicho todo esto, nuestro archivo XML tiene todo lo que PHPUnit necesita para ejecutarse sin ning\u00fan otro par\u00e1metro.<\/p>\n Recuerde, sin embargo, antes de continuar con el resto de este art\u00edculo, asumo que ha instalado PHPUnit globalmente en su sistema usando Composer. De lo contrario, revise este art\u00edculo<\/a><\/strong>, ya que le proporcionar\u00e1 instrucciones sobre c\u00f3mo hacerlo.<\/p>\n Una vez hecho esto, puede verificar que PHPUnit est\u00e9 instalado ingresando el siguiente comando en su terminal:<\/p>\n Y deber\u00edas ver algo como lo siguiente:<\/p>\n<\/p>\n Si ve algo como lo anterior, puede ejecutar PHPUnit en cualquier lugar de su sistema.<\/p>\n Antes de continuar, escribamos un archivo de arranque b\u00e1sico. Lo llamaremos bootstrap.php<\/strong> y lo colocaremos en nuestro directorio de pruebas<\/strong>. Incluir\u00e1 lo siguiente:<\/a><\/strong><\/p>\n Este es un "cargador autom\u00e1tico" simple (que vacilante lo llamo as\u00ed dado que solo est\u00e1 iterando a trav\u00e9s de archivos y requiriendolos, pero funciona para nuestros prop\u00f3sitos).<\/p>\n En este punto, configuremos una prueba b\u00e1sica.<\/p>\n Si lee algo sobre el desarrollo basado en pruebas, es probable que escuche sobre el ciclo de repetici\u00f3n rojo-verde. Hay mucho que decir al respecto y recomiendo leerlo<\/a><\/strong>, pero no es el prop\u00f3sito de esta publicaci\u00f3n.<\/p>\n En cambio, estamos m\u00e1s enfocados en escribir pruebas que coincidan con lo que necesitamos hacer, \u00bfverdad? As\u00ed que dicho esto, hagamos lo siguiente:<\/p>\n Ahora, desde la Terminal, cambie el directorio al directorio del proyecto (que ciertamente falta, por ahora) y luego simplemente ejecute php<\/em><\/strong> unit<\/em>:<\/p>\n Suponiendo que todo est\u00e9 configurado correctamente, deber\u00eda ver algo como esto:<\/p>\n Como no tenemos c\u00f3digo ni pruebas, naturalmente vamos a ver el resultado anterior, \u00bfverdad? Entonces, escribamos una sola prueba que se ejecutar\u00e1 (y fallar\u00e1) ya que no hay c\u00f3digo para probar.<\/p>\n Primero, en el directorio de pruebas<\/strong>, cree un archivo llamado AcmeCacheTest.php.<\/strong> Y hagamos que haga algo simple como instanciar un objeto de cach\u00e9<\/a><\/strong> que eventualmente crearemos.<\/p>\n Antes de ejecutar la prueba, tenga en cuenta que nosotros:<\/p>\n Esto es parte de lo que hace que usar PHPUnit sea tan f\u00e1cil. Una vez hecho esto, ejecute el siguiente c\u00f3digo desde la ra\u00edz de su proyecto:<\/p>\n Despu\u00e9s de eso, deber\u00edas ver lo siguiente:<\/p>\n Tenga en cuenta que esto generar\u00e1 una prueba fallida y le dir\u00e1 d\u00f3nde<\/strong> se encontr\u00f3 el problema, el archivo y la l\u00ednea.<\/p>\n Para arreglar esto, necesitamos escribir una clase:<\/a><\/strong><\/p>\n La prueba de aprobaci\u00f3n b\u00e1sica (que se basar\u00e1 en el c\u00f3digo anterior) incluir\u00e1 lo siguiente:<\/p>\n Primero, probemos que podemos configurar la clase y que no es nula. Esta es una afirmaci\u00f3n un poco innecesaria ya que sabemos que tendremos una clase correctamente instanciada, pero nos pone en el ritmo de escribir pruebas:<\/a><\/strong><\/p>\n Y ejecuta la prueba:<\/p>\n A continuaci\u00f3n, verifiquemos que el valor predeterminado del cach\u00e9 est\u00e9 establecido:<\/a><\/strong><\/p>\n Al igual que con el paso anterior, ejecute las pruebas y ahora deber\u00eda ver dos pruebas aprobadas:<\/p>\n Finalmente, probemos para ver si podemos cambiar el valor con \u00e9xito:<\/a><\/strong><\/p>\n Y las \u00faltimas tres pruebas de aprobaci\u00f3n:<\/p>\n Y ah\u00ed lo tienes:<\/p>\n De acuerdo, es simple, pero esto sienta las bases para mucho m\u00e1s de lo que muchas personas ya hacen con sus pruebas.<\/p>\n Adem\u00e1s, le brinda algo sobre lo que construir a medida que sus habilidades de prueba se fortalecen.<\/p>\n Finalmente, si est\u00e1 ansioso por sumergirse realmente en el archivo de configuraci\u00f3n, puede leer la explicaci\u00f3n detallada del manual.<\/a><\/strong><\/p>\n Sin embargo, tenga en cuenta que todo lo que se describe anteriormente pretende ser lo que necesita para comenzar a configurar su propio archivo de configuraci\u00f3n PHPUnit XML.<\/p>\n\n
\n
2 Los fundamentos del archivo de configuraci\u00f3n<\/h3>\n
<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n\n<!-- http:\/\/phpunit.de\/manual\/4.1\/en\/appendixes.configuration.html -->\n<phpunit xmlns:xsi=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\"\n xsi:noNamespaceSchemaLocation=\"http:\/\/schema.phpunit.de\/4.1\/phpunit.xsd\"\n bootstrap=\".\/tests\/bootstrap.php\"\n backupGlobals=\"false\"\n colors=\"true\"\n convertErrorsToExceptions=\"true\"\n convertNoticesToExceptions=\"true\"\n convertWarningsToExceptions=\"true\"\n>\n <testsuites>\n <testsuite name=\"AcmeTests\">\n <directory>.\/tests<\/directory>\n <\/testsuite>\n <\/testsuites>\n\n <logging>\n <log type=\"coverage-text\" target=\"php:\/\/stdout\" showUncoveredFiles=\"true\"><\/log>\n <\/logging>\n<\/phpunit>\n<\/code><\/pre>\n\n
\n
\n
$ which phpunit<\/code><\/pre>\n3 El archivo Bootstrap<\/h3>\n
<?php\n\/\/ This array has a single file but could whole the contents of an entire directory.\n$files = [\n dirname(__DIR__).'\/AcmeCache.php',\n];\n\nforeach ($files as $file) {\n if (file_exists($file)) {\n require_once $file;\n }\n}\n<\/code><\/pre>\n4 Una prueba b\u00e1sica que falla<\/h3>\n
\n
$ phpunit<\/code><\/pre>\n![\"Escritura](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-163700-61e7588ea742f.png\")
<\/a><\/p>\n<?php\n\nnamespace AcmeTests;\n\nuse PHPUnitFrameworkTestCase;\nuse AcmeAcmeCache;\n\nclass AcmeCacheTest extends TestCase\n{\n private $cache;\n\n public function setUp()\n {\n $this->cache = new AcmeCache();\n }\n\n public function testCacheExists()\n {\n $this->assertNotNull($this->cache);\n }\n}\n<\/code><\/pre>\n\n
$ phpunit<\/code><\/pre>\n![\"Escritura](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-163700-61e75891b9ec8.png\")
<\/a><\/p>\n<?php\n\nnamespace Acme;\n\nclass AcmeCache\n{\n private $duration;\n\n public function __construct()\n {\n $this->duration = 43200;\n }\n\n public function setDuration(int $duration)\n {\n $this->duration = $duration;\n }\n\n public function getDuration(): int\n {\n return $this->duration;\n }\n}\n<\/code><\/pre>\n4 Algunas pruebas b\u00e1sicas para pasar<\/h3>\n
\n
<?php\n\nnamespace AcmeTests;\n\nuse PHPUnitFrameworkTestCase;\nuse AcmeAcmeCache;\n\nclass AcmeCacheTest extends TestCase\n{\n private $cache;\n\n public function setUp()\n {\n $this->cache = new AcmeCache();\n }\n\n public function testCacheExists()\n {\n $this->assertNotNull($this->cache);\n }\n}\n<\/code><\/pre>\n![\"Escritura](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-163700-61e75894bbad2.png\")
<\/a><\/p>\n<?php\n\nnamespace AcmeTests;\n\nuse PHPUnitFrameworkTestCase;\nuse AcmeAcmeCache;\n\nclass AcmeCacheTest extends TestCase\n{\n private $cache;\n\n public function setUp()\n {\n $this->cache = new AcmeCache();\n }\n\n public function testCacheExists()\n {\n $this->assertNotNull($this->cache);\n }\n\n public function testDefaultCacheValue()\n {\n $this->assertSame(43200, $this->cache->getDuration());\n }\n}\n<\/code><\/pre>\n![\"Escritura](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-163700-61e7589770dbe.png\")
<\/a><\/p>\n<?php\n\nnamespace AcmeTests;\n\nuse PHPUnitFrameworkTestCase;\nuse AcmeAcmeCache;\n\nclass AcmeCacheTest extends TestCase\n{\n private $cache;\n\n public function setUp()\n {\n $this->cache = new AcmeCache();\n }\n\n public function testCacheExists()\n {\n $this->assertNotNull($this->cache);\n }\n\n public function testDefaultCacheValue()\n {\n $this->assertSame(43200, $this->cache->getDuration());\n }\n\n public function testSetCustomDuration()\n {\n $duration = 4200;\n\n $this->cache->setDuration($duration);\n $this->assertSame($duration, $this->cache->getDuration());\n }\n}\n<\/code><\/pre>\n![\"Escritura](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-163700-61e7589a7745a.png\")
<\/a><\/p>\n\n
\u00bfHay m\u00e1s? (\u00bfSiempre tiene la raz\u00f3n?)<\/h2>\n