Add support for conditional function definitions

Elements can be defined in a conditional way,
this allows elements to be added to the docs.

Fixes #141

Author: jaapio

src/phpDocumentor/Reflection/Php/Factory/File.php

@@ -130,6 +130,17 @@ private function createElements(
     ) : void {
         foreach ($nodes as $node) {
             switch (get_class($node)) {
+                case Node\Stmt\If_::class:
+                    $this->createElements($node->stmts, $file, $strategies, $context);
+
+                    foreach ($node->elseifs as $subNode) {
+                        $this->createElements($subNode->stmts, $file, $strategies, $context);
+                    }
+
+                    if ($node->else instanceof Node\Stmt\Else_) {
+                        $this->createElements($node->else->stmts, $file, $strategies, $context);
+                    }
+                    break;
                 case Node\Stmt\Expression::class:
                     try {
                         $strategy = $strategies->findMatching($node);

tests/integration/FileDocblockTest.php

@@ -10,8 +10,6 @@
 
 /**
  * Integration tests to check the correct working of processing a namespace into a project.
- *
- * @coversNothing
  */
 final class FileDocblockTest extends TestCase
 {
@@ -39,13 +37,30 @@ public function testFileDocblock(string  $fileName) : void
         );
     }
 
-
-    public function fileProvider(string $file)
+    public function fileProvider() : array
     {
         return [
             [ __DIR__ . '/data/GlobalFiles/empty.php' ],
             [ __DIR__ . '/data/GlobalFiles/empty_with_declare.php' ],
             [ __DIR__ . '/data/GlobalFiles/empty_shebang.php' ],
         ];
     }
+
+    /**
+     * @covers \phpDocumentor\Reflection\Php\Factory\File::create
+     * @covers \phpDocumentor\Reflection\Php\Factory\File::<private>
+     */
+    public function testConditionalFunctionDefine() : void
+    {
+        $fileName =  __DIR__ . '/data/GlobalFiles/conditional_function.php';
+        $project = $this->fixture->create(
+            'MyProject',
+            [new LocalFile($fileName)]
+        );
+
+        $this->assertCount(
+            4,
+            $project->getFiles()[$fileName]->getFunctions()
+        );
+    }
 }

tests/integration/data/GlobalFiles/conditional_function.php

@@ -0,0 +1,22 @@
+<?php
+declare(strict_types=1);
+
+if (!function_exists('h')) {
+    function h() {
+
+    }
+} elseif(!function_exists('i')) {
+    if (true) {
+        function i()
+        {
+        }
+    }
+} else {
+    function j() {
+
+    }
+}
+
+function a() {
+
+}