Как перевести комментарии в *.php файлах ?

Question

[vgrayster]

Достался в наследство проект который писали бравые китайцы. Порядка 200х файлов и все комментарии сделаны на китайском :).

Как все эти комментари автоматически ( может быть с помощью гугл транслейт) перевести на английский. Понятно что перевод будет кривой, но это лучше чем китайские комменты :)

Answer 1

[egorinsk]

Хороший повод выучить китайский, не?

Answer 2

[Григорий]

Я думаю что проще всего, на таких объемах, выучить китайский написать скрипт: выдираем коммент, спрашиваем гугл и ответом гугла заменяем или дополняем коммент в файле.

Comments

[vgrayster]

так я про скрипт и спрашиваю, может кто уже такой скрипт писал или видел такой скрипт?

Answer 3

[Ivan Shalganov]

Попробуйте так (убедитесь что у Вас включен tokenizer):

<?php

const SCRIPTS_DIR = '/data/www/framework/lib';

$dir = new RecursiveIteratorIterator(new RecursiveDirectoryIterator(SCRIPTS_DIR));

$replace = array(
	'<hh user=param>' => '#PARAM#',
	'<hh user=return>' => '#RETURN#',
	'<hh user=desc>' => '#DESC#',
	'<hh user=throws>' => '#THROWS#',
	'<hh user=see>' => '#SEE#',
	'<hh user=link>' => '#LINK#',
	'<hh user=access>' => '#ACCESS#',
	'<hh user=since>' => '#SINCE#',
	'<hh user=static>' => '#STATIC#',

);

foreach($dir as $source) {
	if($dir->isDot()) {
		continue;
	}
	$file = file_get_contents($source->getPathname());
	$tokens = token_get_all($file);

	foreach($tokens as $token) {
		if(!is_array($token)) {
			continue;
		}
		if(in_array($token[0], array(T_COMMENT, T_DOC_COMMENT))) {
			$text = preg_replace('![\n\r][\t ]*\*!sSim', "\n", $token[1]);
			$text = str_replace(array_keys($replace), array_values($replace), $text);
			$translate = Yandex::translate($tokens[1]); //
			$translate = str_replace(array_values($replace), array_keys($replace), $text);
			$file = str_replace($tokens[1], $translate, $file);
		}
	}

	file_put_contents($source->getPathname(), $file);
}

Comments

[Ivan Shalganov]

эх, таки заменил @ param, @ return и тд на свою фигню в массиве $replace.

[Ivan Shalganov]

ну и Yandex::translate() свой вставьте)

[Ivan Shalganov]

суть скрипта получить все комменты в скрипте через нативный токенайзер

[vgrayster]

Спасибо, вечером попробую

Answer 4

[EugeneOZ]

Сочувствую.
Если точно нет шансов переписать это с нуля, то могут пригодиться:
php.net/manual/ru/reflectionclass.getdoccomment.php (для описания классов)
www.php.net/manual/ru/reflectionfunctionabstract.getdoccomment.php (для методов)

Answer 5

[Сергей Протько]

Выдрать комментарии, как уже писали выше, можно через рефлексии. Правда это особо не поможет их заменить.

А вот обработать комментарии можно так:

function translateComments($file)
{
     $expr = "/((?:\/\*(?:[^*]|(?:\*+[^*\/]))*\*+\/)|(?:\/\/.*))/";
     $source = file_get_contents($file);
     preg_match_all($expr, $comments, $source); //capture the comments
     
     foreach($matchs[0] as $id => $phpdoc){ 
          $source = str_replace($phpdoc,  translateText($phpdoc), $source); // replace the scores of empty 
     }

     file_put_contents($file, $source);
}

Пример абстрактен, но суть должна быть ясна. Хотя логично эту регулярку через preg_replace_callback прогнать.

Comments

[Сергей Протько]

preg_match_all($expr, $source, $matches); 

будь проклята копипаста и лень.

Answer 6

[eaa]

дык… тут по идее писать-то не сильно долго:

— берем файлик.
— вытаскиваем регэкспом коммент.
— отдает гугле.
— получаем ответ.
— запихиваем вместо того, что было.

вряд ли кто именно такое писал, тут слишком специальное решение, а я делал так на перле, как описал парой строк выше, правда не текст переводить надо было, а кое-что другое подменять в тексте.

для особо любителей можно sed использовать.

Answer 7

[Vampiro]

Мне кажется можно скармливать всю страничку, указав перевод с китайского на английский.
Хотя сложно сказать как он будет на регулярки реагировать.