ApiGen, OpenServer и кириллица в имени пользователя...
Добавлено: 27 июн 2015, 21:26
Понадобилось мне сегодня сгенерировать документацию для одного из своих проектов. Ну, думаю, что может быть проще? Открываю встроенную в OpenServer консоль, выполняю команду:
Но, во-первых, вводить путь каждый раз - это неприемлемо, во-вторых, и это главное, при попытке сгенерить документацию, апиген вываливался с ошибкой. Режим дебага показал, что композер установил апиген в пользовательскую папку с кириллическими символами. Меня зовут Сергей, и винда при установке создает такое имя, когда вводишь данные своей учетки Microsoft. Как это поменять, я не стал искать, да и лень было. Я пошел другим путем, и поменял домашнюю папку композера. Делается это путем добавления переменной среды (папку C:\Composer лучше создать заблаговременно)
COMPOSER_HOME=C:\Composer
Далее в PATH добавим путь, чтобы можно было запускать бинарники установленных глобально пакетов без указания полного пути:
Для этого нужно добавить несколько системных переменных окружения (как мы это только что делали с COMPOSER_HOME)
Далее в той же OS консоли смотрим содержимое PATH
И последним штрихом, без которого, однако, апиген не заведется, будет переназначение системных переменных TMP и TEMP. Как вы догадались, в их значениях должен быть путь без кириллицы
Бонусом будет отвязка терминала от OS. Доступны команды php, mysql, composer. PhpStorm больше не нужно будет запускать через закладку ОпенСервера.
Минус - Все это работает только для одной, выбранной версии php (Но встроенная в OS консоль по-прежнему будет работать со всеми версиями php).
У меня всё. Спасибо за внимание
composer global require apigen/apigenНа удивление инсталл прошел на ура, установленный апиген даже версию выдает по команде path/to/apigen -V
Но, во-первых, вводить путь каждый раз - это неприемлемо, во-вторых, и это главное, при попытке сгенерить документацию, апиген вываливался с ошибкой. Режим дебага показал, что композер установил апиген в пользовательскую папку с кириллическими символами. Меня зовут Сергей, и винда при установке создает такое имя, когда вводишь данные своей учетки Microsoft. Как это поменять, я не стал искать, да и лень было. Я пошел другим путем, и поменял домашнюю папку композера. Делается это путем добавления переменной среды (папку C:\Composer лучше создать заблаговременно)
COMPOSER_HOME=C:\Composer
- Добавление переменной среды
%COMPOSER_HOME%\vendor\binТеперь отвяжем консоль от OpenServer'a
Для этого нужно добавить несколько системных переменных окружения (как мы это только что делали с COMPOSER_HOME)
PHP_BIN=w:\modules\php\PHP-5.4\php.exe PHP_DIR=w:\modules\php\PHP-5.4\Значения этих переменных для вашей системы вы можете, выполнив в консоли OpenServer'a команды
echo %PHP_BIN% echo %PHP_DIR%Тут следует учесть, что это будет работать только для одной версии php, поэтому выберите ту, с которой вы больше всего работаете
Далее в той же OS консоли смотрим содержимое PATH
echo %PATH%копируем оттуда следующие пути
w:\modules\php\PHP-5.4\ext;w:\modules\php\PHP-5.4\pear;w:\modules\php\PHP-5.4\pear\bin;w:\modules\php\PHP-5.4;w:\modules\imagemagick;w:\modules\wget\bin;w:\modules\database\MySQL-5.5\bin;w:\modules\http\Apache-2.2\bin;w:\modules\http\Apache-2.2;и добавляем их к системной переменной PATH.
И последним штрихом, без которого, однако, апиген не заведется, будет переназначение системных переменных TMP и TEMP. Как вы догадались, в их значениях должен быть путь без кириллицы
TEMP=C:\Temp TMP=C:\TempВсе. Теперь мы можем открыть стандартный виндовый терминал, ввести команды
w: cd domains\project\wofh-tools apigen generate -s www\application -d docи насладиться сгенерированной документацией
Бонусом будет отвязка терминала от OS. Доступны команды php, mysql, composer. PhpStorm больше не нужно будет запускать через закладку ОпенСервера.
Минус - Все это работает только для одной, выбранной версии php (Но встроенная в OS консоль по-прежнему будет работать со всеми версиями php).
У меня всё. Спасибо за внимание