Boris — небольшой, но надежный REPL для php

REPL есть у python, ruby, clojure. REPL — read-eval-print loop. Если описать на псевдокоде что такое REPL — это будет выглядеть как-то так:

while(true){     echo eval($input->get()); } 

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

Требования

• PHP >= 5.3
• The Readline functions
• The PCNTL functions
• The POSIX functions

Установка

Boris доступен через composer:

composer require d11wtq/boris dev-master 

Или же по старинке:

git clone git://github.com/d11wtq/boris.git cd boris ./bin/boris 

Использование

При старте Boris появляется приглашение:

boris> 

Попробуйте что-то написать, Boris это обработает и выдаст результат. Если у вас длинное многострочное выражение, Boris соберет его вместе и выполнит вместе. Для отмены любых операций используется ctrl + c. По умолчанию все результаты выдаются функцией var_dump

boris> $x = 1; int(1) boris> $y = 2; int(2) boris> "x + y = " . ($x + $y); string(9) "x + y = 3" boris> exit; 

Для выхода из утилиты используется ctrl + D.

Использование в проектах

Все очень просто:

require_once 'lib/autoload.php';  $boris = new \Boris\Boris('myapp> '); $boris->setLocal(array('appContext' => $appContext)); $boris->start(); 

Здесь инициализируется утилита с глобальной переменной appContext, доступной из Boris.

Есть возможность добавить колбэки перед стартом утилиты. Существует два варианта их добавления:

$boris->onStart('$foo = 42; $bar = 2; echo "Hello Boris!\n";');  $boris->onStart(function($worker, $scope){   extract($scope);   echo '$foo * $bar = ' . ($foo * $bar) . "\n";   $worker->setLocal('name', 'Chris'); }); 

Сначала мы передаем строку кода, которую Boris просто исполнит через eval. Затем исполним callback, который экспортирует в себя данные из области видимости Boris, произведет с ними некоторые действия, а затем добавит переменную $name в Boris.

Ссылка на репозиторий.