RenderController.php 4.16 KB
Newer Older
1 2 3 4 5 6 7
<?php
/**
 * @link http://www.yiiframework.com/
 * @copyright Copyright (c) 2008 Yii Software LLC
 * @license http://www.yiiframework.com/license/
 */

8
namespace yii\apidoc\commands;
9 10

use phpDocumentor\Reflection\FileReflector;
11 12
use TokenReflection\ReflectionFile;
use yii\apidoc\templates\BaseRenderer;
13
use yii\console\Controller;
14
use yii\helpers\ArrayHelper;
15 16
use yii\helpers\Console;
use yii\helpers\FileHelper;
17 18
use yii\apidoc\components\OfflineRenderer;
use yii\apidoc\models\Context;
19 20 21
use Yii;

/**
22
 * Command to render API Documentation files
23 24 25 26
 *
 * @author Carsten Brandt <mail@cebe.cc>
 * @since 2.0
 */
27
class RenderController extends Controller
28
{
29 30 31
	public $template = 'bootstrap';

	public $guide;
32

33 34 35 36 37 38 39
	/**
	 * Renders API documentation files
	 * @param array $sourceDirs
	 * @param string $targetDir
	 * @return int
	 */
	public function actionIndex(array $sourceDirs, $targetDir)
40
	{
41
		$targetDir = rtrim(Yii::getAlias($targetDir), '\\/');
42 43 44
		if (is_dir($targetDir) && !$this->confirm('TargetDirectory already exists. Overwrite?')) {
			return 2;
		}
45 46 47
		if (!is_dir($targetDir)) {
			mkdir($targetDir);
		}
48

49
		$renderer = $this->findRenderer();
50 51 52
		if ($renderer === false) {
			return 1;
		}
53
		$renderer->targetDir = $targetDir;
54 55 56
		if ($this->guide !== null && $renderer->hasProperty('guideUrl')) {
			$renderer->guideUrl = './';
		}
57

58
		$this->stdout('Searching files to process... ');
59 60 61 62 63 64 65
		$files = [];
		foreach($sourceDirs as $source) {
			foreach($this->findFiles($source) as $fileName) {
				$files[$fileName] = $fileName;
			}
		}

66 67
		$this->stdout('done.' . PHP_EOL, Console::FG_GREEN);

68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84
		$context = new Context();

		$cacheFile = $targetDir . '/cache/' . md5(serialize($files)) . '.tmp';
		if (file_exists($cacheFile)) {
			$this->stdout('Loading processed data from cache... ');
			$context = unserialize(file_get_contents($cacheFile));
			$this->stdout('done.' . PHP_EOL, Console::FG_GREEN);

			$this->stdout('Checking for updated files... ');
			foreach($context->files as $file => $sha) {
				if (sha1_file($file) === $sha) {
					unset($files[$file]);
				}
			}
			$this->stdout('done.' . PHP_EOL, Console::FG_GREEN);
		}

85
		$fileCount = count($files);
86
		$this->stdout($fileCount . ' file' . ($fileCount == 1 ? '' : 's') . ' to update.' . PHP_EOL);
87 88 89 90 91 92 93 94 95
		Console::startProgress(0, $fileCount, 'Processing files... ', false);
		$done = 0;
		foreach($files as $file) {
			$context->addFile($file);
			Console::updateProgress(++$done, $fileCount);
		}
		Console::endProgress(true);
		$this->stdout('done.' . PHP_EOL, Console::FG_GREEN);

96 97 98 99 100 101
		// save processed data to cache
		if (!is_dir(dirname($cacheFile))) {
			mkdir(dirname($cacheFile));
		}
		file_put_contents($cacheFile, serialize($context));

102 103 104 105
		$this->stdout('Updating cross references and backlinks... ');
		$context->updateReferences();
		$this->stdout('done.' . PHP_EOL, Console::FG_GREEN);

106
		// render models
107 108
		$renderer->renderApi($context, $this);

109
		ArrayHelper::multisort($context->errors, 'file');
110 111
		print_r($context->errors);

112 113 114 115
		// render guide if specified
		if ($this->guide !== null) {
			$renderer->renderMarkdownFiles($this->findMarkdownFiles($this->guide, ['README.md']), $this);
		}
116 117
	}

118 119 120 121 122
	/**
	 * @return BaseRenderer
	 */
	protected function findRenderer()
	{
123 124
		$rendererClass = 'yii\\apidoc\\templates\\' . $this->template . '\\Renderer';
		if (!class_exists($rendererClass)) {
125
			$this->stderr('Renderer not found.' . PHP_EOL);
126
			return false;
127 128 129 130
		}
		return new $rendererClass();
	}

131
	protected function findFiles($path, $except = ['vendor/', 'tests/'])
132 133 134 135 136 137 138 139 140 141 142 143
	{
		$path = FileHelper::normalizePath($path);
		$options = [
			'filter' => function ($path) {
				if (is_file($path)) {
					$file = basename($path);
					if ($file[0] < 'A' || $file[0] > 'Z') {
						return false;
					}
				}
				return null;
			},
144
			'only' => ['*.php'],
145
			'except' => $except,
146 147 148
		];
		return FileHelper::findFiles($path, $options);
	}
149

150 151 152 153
	protected function findMarkdownFiles($path, $except = [])
	{
		$path = FileHelper::normalizePath($path);
		$options = [
154
			'only' => ['*.md'],
155 156 157 158 159
			'except' => $except,
		];
		return FileHelper::findFiles($path, $options);
	}

160 161 162 163 164
	/**
	 * @inheritdoc
	 */
	public function globalOptions()
	{
165
		return array_merge(parent::globalOptions(), ['template', 'guide']);
166
	}
167
}