EDIT

/vendor

composer.lock

{

  "name": "cybertaxonomy.org/cdm-dataportal",

  "description": "The dataportal publishes CDM data hosted in a CommunityStore on the web.",

  "minimum-stability": "stable",

  "license": "GPL2",

  "authors": [

    {

      "name": "Andreas Kohlbecker",

      "email": "a.kohlbecker@bgbm.org"

    }

  ],

  "require": {

    "phpunit/phpunit": "^8"

  }

}

/**

 * Validates if the given string is a uuid.

 *

 * @param string $str

 *   The string to validate.

 *

 * return bool

 *   TRUE if the string is a UUID.

 */

function is_uuid($str) {

  return is_string($str) && strlen($str) == 36 && strpos($str, '-');

}

/**

 * Checks if the given $object is a valid cdm entity.

 *

 * An object is considered a cdm entity if it has a string field $object->class

 * with at least 3 characters and if it has a valid uuid in $object->uuid.

 * The function is null save.

 *

 * @author a.kohlbecker <a.kohlbecker@bgbm.org>

 *

 * @param mixed $object

 *   The object to validate

 *

 * @return bool

 *   True if the object is a cdm entity.

 */

function is_cdm_entity($object) {

  return

    isset($object->class) && is_string($object->class) && strlen($object->class) > 2 && $object->class != 'TypedEntityReference'

    && is_string($object->uuid) && is_uuid($object->uuid);

}

<?php

/**

 * Created by PhpStorm.

 * User: andreas

 * Date: 09.01.20

 * Time: 14:11

 */

C:37:"PHPUnit\Runner\DefaultTestResultCache":331:{a:2:{s:7:"defects";a:2:{s:47:"ShortnameTest::test_cdm_dataportal_shortname_of";i:4;s:47:"StatisticalValuesTests::test_statistical_values";i:4;}s:5:"times";a:3:{s:27:"TestTests::test_fancymodule";d:0.002;s:47:"ShortnameTest::test_cdm_dataportal_shortname_of";d:0.003;s:47:"StatisticalValuesTests::test_statistical_values";d:0.003;}}}

Running PHPUnit tests in PHPStorm

============================================

Author: Andreas Kohlbecker, 2012–2020

**Official PhPStorm documentation on PHPUnit tests:**

* https://www.jetbrains.com/help/phpstorm/using-phpunit-framework.html

* https://www.jetbrains.com/help/phpstorm/php-test-frameworks.html

* https://www.jetbrains.com/help/phpstorm/using-the-composer-dependency-manager.html

* https://www.jetbrains.com/help/phpstorm/php-interpreters.html

/usr/bin/php /home/andreas/workspaces/cdm/cdm-dataportal/vendor/phpunit/phpunit/phpunit --configuration /home/andreas/workspaces/cdm/cdm-dataportal/modules/cdm_dataportal/test/phpUnit/phpUnit.xml StatisticalValuesTests /home/andreas/workspaces/cdm/cdm-dataportal/modules/cdm_dataportal/test/phpUnit/src/unit/statistical_values_tests.php

Install PHPUnit

----------------------------------------------

In Debian based Linux distros PHPUnit usually can be installed by

    apt-get install phpunit

the recommended way for whowever is the installation via [Composer](https://getcomposer.org/) 

the state of the art dependency manager for PHP.

    apt-get install composer

The `cdm-dataportal` project contains a `composer.json` file which sets *phpunit version 8* as dependency for this project.

PHPStorm should detect this configuration file. You can check this by opening the settings page **Language&Frameworks > PHP > Composer** 

which shoould look like:

 ![](phpStorm-composer-configuration.png)

**NOTE:** You may also want to install PHP_CodeCoverage by adding the dependency to `composer.json`.

Install XDebug

----------------------------------------------

xdebug can easily be installed via pecl:

	pecl install xdebug

at the end of the output pecl shows:

    ...

    Build process completed successfully

    Installing '/usr/lib/php5/20121212/xdebug.so'

After successful installation the XDebug extension binary will be located for example in `/usr/lib/php/*/xdebug.so`.

In order to make XDebug available to the PHP CLI you need to set this location in the settings page **File > Settings > 

Languages and Frameworks > PHP** as *Debugger extension*:

![](phpStorm-php-cli-configuration.png)

Configure PHPUnit in PHPStorm

-----------------------------------------------

PHPStorm should have autodetected the PHPUnit installed via Composer already

Open the settings page **File > Settings > Languages and Frameworks > PHP > Test Frameworks** make sure the option 

"*Use Composer Autoloader*" is checked and set `modules/cdm_dataportal/test/phpUnit/phpUnit.xml` as *Default configuration file*.

![](phpStorm-phpunit-configuration.png)

Running PHPUnit tests in PHPStorm

---------------------------------------------------------------

Simply right click on a test file and choose *Run 'TestFile' (PHPUnit)* in the context menu.

Running PHPUnit tests via the phpunitRunner.php script (DEPRECATED)

---------------------------------------------------------------

*This has only been preseved since it could be useful for running test suites from the commandline or in the CI server.*

 what we are now trying to achieve with the eclipse launcher configuration is in principle

 to run the following command:

  /usr/bin/php52/php /usr/bin/php52/phpunit --verbose --bootstrap bootstrap.php

therefore we provide the script phpunitRunner.php which will execute phpUnit.

In order to configure it properly you need to supply some environment variables.

  DRUPAL_ROOT - path to the root of your Drupal installation, that is dataportal installation.

  XDEBUG_CONFIG - must be set to 'idekey=ECLIPSE_DBGP'

  SITE_BASE_PATH - set this variable to the base path of the dataportal website you want to use for testing, eg: /flora-malesiana

Create a new php run configuration which executes phpunitRunner.php and configure the above named

environment variables in the "Environment" tab.

In the "PhpScriptArgument" tab set the following:

  	--stderr --configuration ${workspace_loc:/Drupal5/sites/all/modules/cdm_dataportal/test/phpUnit/phpUnit.conf.xml} ${workspace_loc:/Drupal5/sites/all/modules/cdm_dataportal/test/phpUnit/src/}

module_load_include('php', 'bootstrap', 'TestUtils');

  print('environment variable "DRUPAL_ROOT" must point to the root of the Drupal installation.');

<?xml version="1.0" encoding="UTF-8"?>

<!--

	This phpUnit configuration will cause a full bootstrap of drupal to allow for full integration tests

	FIXME: bootstrap.php currently causes the php interpreter to exit code 255

-->

<phpunit bootstrap="bootstrap.php">

	<php>

	  <ini name="error_reporting" value="E_ALL &amp; ~E_NOTICE" />

	  <ini name="display_errors" value="TRUE" />

    <ini name="display_startup_errors" value="TRUE" />

	</php>

  <testsuites>

	  <testsuite name="benchmark">

	    <file>src/integration/cdm_dataportal.moduleTest.php</file>

	  </testsuite>

  </testsuites>

</phpunit>

<?xml version="1.0" encoding="UTF-8"?>

<!--

    Configuration for simple unit tests which do not require bootstrapping of drupal

    The test cases are located in ./src/unit-tests

-->

<phpunit defaultTestSuite="unit">

    <php>

        <!--

            include_path: must point to the folder modules/cdm_dataportal

        -->

        <includePath>../..</includePath>

        <ini name="error_reporting" value="E_ALL"/>

        <!--

        <ini name="display_errors" value="TRUE"/>

        <ini name="display_startup_errors" value="TRUE"/>

        -->

    </php>

    <testsuites>

        <testsuite name="unit">

            <directory>src/unit/</directory>

        </testsuite>

    </testsuites>

</phpunit>

{

    "appendedPhrase": "",

    "class": "Taxon",

    "created": "2011-01-17T12:53:58.000+01:00",

    "data": [

    ],

    "doubtful": false,

    "excluded": false,

    "lsid": null,

    "protectedTitleCache": false,

    "taxonStatusUnknown": false,

    "taxonomicChildrenCount": 0,

    "titleCache": "Alectryon myrmecophilus Leenh. sec. Flora Malesiana - Sapindaceae I",

    "unplaced": false,

    "updated": "2011-04-01T17:31:18.795+02:00",

    "useNameCache": false,

    "uuid": "0ae4f7ab-f482-482c-ba57-cf0e4389a417",

    "name": {

        "anamorphic": false,

        "appendedPhrase": "",

        "basionymAuthorship": null,

        "binomHybrid": false,

        "class": "BotanicalName",

        "created": "2011-01-17T12:53:58.000+01:00",

        "data": [

        ],

        "exBasionymAuthorship": null,

        "exCombinationAuthorship": null,

        "genusOrUninomial": "Alectryon",

        "hybridFormula": false,

        "infraGenericEpithet": "",

        "infraSpecificEpithet": "",

        "lsid": null,

        "monomHybrid": false,

        "nomenclaturalCode": "ICNAFP",

        "nomenclaturalMicroReference": "223; 33 (1988) 319",

        "parsingProblem": 0,

        "problemEnds": -1,

        "problemStarts": -1,

        "protectedAuthorshipCache": false,

        "protectedFullTitleCache": false,

        "protectedNameCache": false,

        "protectedTitleCache": false,

        "specificEpithet": "myrmecophilus",

        "titleCache": "Alectryon myrmecophilus Leenh.",

        "trinomHybrid": false,

        "updated": "2011-04-05T16:15:35.581+02:00",

        "uuid": "641a0d51-fa0b-49b4-b335-53746ea2bf83",

        "taggedName": [

            {

                "class": "TaggedText",

                "text": "Alectryon",

                "type": "name"

            },

            {

                "class": "TaggedText",

                "text": "myrmecophilus",

                "type": "name"

            },

            {

                "class": "TaggedText",

                "text": "Leenh.",

                "type": "authors"

            }

        ]

    }

}

<?php

use PHPUnit\Framework\TestCase;

class ShortnameTest extends TestCase {

  /*

   --------'BACILLARIOPHYCEAE (FOSS.)'---------

   --------'BACILLUS OBSCURUS (FOSS.)'---------

   >>> B. OBSCURUS (FOSS.)

   --------'Lapsana communis L.'---------

   >>> L. communis L.

   --------'Lapsana L.'---------

   --------'Lapsana communis subsp. adenophora (Boiss.) Rech.'---------

   >>> L. communis subsp. adenophora (Boiss.) Rech.

   --------'Asterolampra marylandica'---------

   >>> A. marylandica

   --------'Ophrys ×"kreutziana"'---------

   >>> O. ×"kreutziana"

   --------'Ophrys bornmuelleri subsp. bornmuelleri × subsp. grandiflora'---------

   >>> O. bornmuelleri subsp. bornmuelleri × subsp. grandiflora

   --------'Aegilops ×insulae-cypri'---------

   >>> A. ×insulae-cypri

   */

  function test_cdm_dataportal_shortname_of() {

    $testStrings = array(

      "BACILLARIOPHYCEAE (FOSS.)" => "BACILLARIOPHYCEAE (FOSS.)",

      "BACILLUS OBSCURUS (FOSS.)" => "B. OBSCURUS (FOSS.)",

      "Lapsana communis L." => "L. communis L.",

      "Lapsana L." => "Lapsana L.",

      "Lapsana communis subsp. adenophora (Boiss.) Rech." => "L. communis subsp. adenophora (Boiss.) Rech.",

      "Asterolampra marylandica" => "A. marylandica",

      "Ophrys ×\"kreutziana\"" => "O. ×\"kreutziana\"",

      "Ophrys bornmuelleri subsp. bornmuelleri × subsp. grandiflora" => "O. bornmuelleri subsp. bornmuelleri × subsp. grandiflora",

      "Aegilops ×insulae-cypri" => "A. ×insulae-cypri",

      "Hieracium harjuënse Sennikov" => "H. harjuënse Sennikov",

      "Hieracium harjuënse" => "H. harjuënse",

    );

    foreach ($testStrings as $nameString => $shortname) {

      $tagtxt->type = "name";

      $tagtxt->text = $nameString;

      $name->taggedTitle = array($tagtxt);

      $result = cdm_dataportal_shortname_of($name);

      $this->assertEquals($shortname, $result);

    }

  }

}

<?php

use PHPUnit\Framework\TestCase;

class ModuleTests extends TestCase {

  function test_load_polytomousKey() {

    $polytomousKeysPager = cdm_ws_get(CDM_WS_POLYTOMOUSKEY, $polytomousKeyUuid);

    print("\n\n<h4>Benchmarking web services: deep initialization vs. bit-by-bit initialization</h4>\n"

		. $polytomousKeysPager->count . " PolytomousKeys to load.\n");

    print("<table border=\"1\">\n<tr><th>key uuid</td><td>bit-by-bit initialization</td><td>deep initialization</td></tr>\n");

    flush();

    $time_load_bbb_total = 0;

    $time_load_deep_total = 0;

    $i = 0;

    foreach ($polytomousKeysPager->records as $polytomousKey) {

      if (! is_uuid($polytomousKey->uuid)) {

        continue;

      }

      //			if($i++ == 4){

      //				break;

      //			}

      print("<tr><td>$polytomousKey->uuid</td>");

      // ---- bit-by-bit ---- //

      $time_load_start = microtime(true);

      $polytomousKey = cdm_ws_get(CDM_WS_POLYTOMOUSKEY, $polytomousKey->uuid);

      _load_polytomousKeySubGraph($polytomousKey->root);

      $time_load = microtime(true) - $time_load_start;

      //			if($i++ == 1){

      //				var_dump($polytomousKey);

      //			}

      $time_load_bbb_total += $time_load;

      print("<td>" . sprintf('%3.3f', $time_load) . "s</td>");

      // ---- deep ---- //

      $time_load_start = microtime(true);

      $polytomousKey = cdm_ws_get("portal/" . CDM_WS_POLYTOMOUSKEY, array($polytomousKey->uuid, "loadWithNodes"));

      $time_load = microtime(true) - $time_load_start;

      //			if($i++ == 1){

//        var_dump($polytomousKey);

//      }

      $time_load_deep_total += $time_load;

      print("<td>" . sprintf('%3.3f', $time_load) . "s</td></tr>\n");

    }

    print("<tr><td>total time</td><td>" . sprintf('%3.3f', $time_load_bbb_total) . "s</td><td>" . sprintf('%3.3f', $time_load_deep_total) . "s</td></tr>\n");

    flush();

  }

}

<?php

class NameThemeTests extends PHPUnit_Framework_TestCase {

  function test_render_taxon_or_name() {

    $taxon1_file = "theme/cdm_dataportal.name.themeTest-taxon1.json";

    $taxon = TestUtils::load_from_json_resource($taxon1_file);

    $this->assertEquals($taxon->uuid, "0ae4f7ab-f482-482c-ba57-cf0e4389a417");

    $out = render_taxon_or_name($taxon->name);

    TestUtils::stderr($out);

  }

}

<?php

use PHPUnit\Framework\TestCase;

// these includes require <includePath>../..</includePath> to be set in phpUnit.xml

include 'includes/common.inc';

include 'cdm_api/commons.php';

/**

 * test to test if phpUnit is ok

 * @author a.kohlbecker

 *

 */

class StatisticalValuesTests extends TestCase {

  function new_statistical_value($value = null){

    $stat_val = new stdClass();

    $stat_val->_value = $value;

    return $stat_val;

  }

  function create_statistical_values($typicalLowerBoundary = null, $typicalUpperrBoundary = null, $average  = null, $sampleSize = null){

    $stat_vals = statistical_values_array();

    $stat_vals['TypicalLowerBoundary'] = $this->new_statistical_value($typicalLowerBoundary);

    $stat_vals['TypicalUpperBoundary'] = $this->new_statistical_value($typicalUpperrBoundary);

    $stat_vals['SampleSize'] = $this->new_statistical_value($sampleSize);

    $stat_vals['Average'] = $this->new_statistical_value($average);

    return $stat_vals;

  }

  function html2text($html){

    return  html_entity_decode(strip_tags($html), ENT_COMPAT, 'utf-8');

  }

  function test_statistical_values() {

    $stat_vals = $this->create_statistical_values(0.123457,  0.123456, 0.123456523847, 5);

    $this->assertEquals('0.123457–0.123456[5;x̄=0.1234565]', $this->html2text(statistical_values($stat_vals)));

  }

}

<?php

declare(strict_types=1);

use PHPUnit\Framework\TestCase;

/**

 * test to test if phpUnit is ok

 * @author a.kohlbecker

 *

 */

class TestTests extends TestCase {

  function test_fancymodule() {

    $this->assertTrue(true);

  }

}