Класс AclShell
Оболочка для управления ACL. Известно, что у этой консоли возникают проблемы при включенном zend.ze1_compatibility_mode. Убедитесь, что он выключен при использовании этой оболочки.
- Объект
-
Оболочка -
AppShell -
AclShell
Авторские права: Авторские права (с) Cake Software Foundation, Inc. (http://cakefoundation.org)
Лицензия: Лицензия MIT
Расположение Cake/Console/Command/AclShell.php
Подробное описание методов
_dataVarssource protected
_dataVars( string $type null )
Строит параметры данных на основе типа узла
Параметры
- строка
$typeнеобязательно null - Тип узла (ARO/ACO)
Возвращает
arrayПеременные
_getNodeIdsource protected
_getNodeId( string $class , string|array|null $identifier )
Получает узел для заданного идентификатора. $identifier может быть строковым псевдонимом или массивом свойств для использования в AcoNode::node()
Параметры
- строка
$class - Тип класса, который вы хотите (Aro/Aco)
- строка|массив|null
$identifier - Смешанный идентификатор для поиска узла, в противном случае null.
Возвращает
integerЦелое число NodeId. Вызовет ошибку, если ничего не найдено.
_getParamssource protected
_getParams( )
Получает параметры для стандартных методов ACL
Возвращает
arrayaro, aco, action
_outputNodesource protected
_outputNode( string $class , array $node , integer $indent )
Выводит отдельный узел, используя псевдоним или Model.key
Параметры
- строка
$class - Имя класса, который используется.
- массив
$node - Массив информации об узле.
- целое число
$indent - Уровень отступа.
deletesource public
delete( )
Удаление узла ARO/ACO. Обратите внимание, что (в результате неправильной настройки) может быть несколько записей с одинаковым логическим идентификатором. Все они будут удалены.
getOptionParsersource public
getOptionParser( )
Получает экземпляр обработчика параметров и настраивает его.
Возвращает
ConsoleOptionParserConsoleOptionParser
Переопределяет
Shell::getOptionParser() parseIdentifiersource public
parseIdentifier( string $identifier )
Разбирает идентификатор на Model.foreignKey или псевдоним. Принимает идентификатор, определяет его тип и возвращает результат, используемый другими методами.
Параметры
- строка
$identifier - Идентификатор для разбора
Возвращает
mixedстрока для псевдонимов и массив для model.foreignKey
Методы, унаследованные от Оболочки
__constructsource public
__construct( ConsoleOutput $stdout null , ConsoleOutput $stderr null , ConsoleInput $stdin null )
Создает экземпляр этой оболочки.
Параметры
-
ConsoleOutput$stdoutнеобязательно null - Объект ConsoleOutput для стандартного вывода.
-
ConsoleOutput$stderrнеобязательно null - Объект ConsoleOutput для стандартного потока ошибок.
-
ConsoleInput$stdinнеобязательно null - Объект ConsoleInput для стандартного ввода.
Ссылка
http://book.cakephp.org/2.0/ru/console-and-shells.html#ShellПереопределяет
Object::__construct() __getsource public
__get( string $name )
Перегрузка get для ленивого создания задач
Параметры
- строка
$name - Имя свойства для доступа.
Возвращает
ShellОбъект задачи
__issetsource public
__isset( string $name )
Лениво загружает модели с помощью метода loadModel(), если они объявлены в $uses
Параметры
- строка
$name - Имя модели для поиска.
_checkUnitTestsource protected
_checkUnitTest( )
Действие для создания модульного теста
Возвращает
booleanУспех
_controllerNamesource protected
_controllerName( string $name )
Создаёт правильное множественное имя контроллера для указанного имени класса контроллера
Параметры
- строка
$name - Имя класса контроллера
Возвращает
stringМножественное имя контроллера
_controllerPathsource protected
_controllerPath( string $name )
Создаёт правильный путь к контроллеру для указанного имени класса контроллера
Параметры
- строка
$name - Имя класса контроллера
Возвращает
stringПуть к контроллеру
_displayHelpsource protected
_displayHelp( string $command )
Отображает справку в правильном формате
Параметры
- строка
$command - Команда, для которой требуется справка.
_getInputsource protected
_getInput( string $prompt , string|array $options , string $default )
Запрашивает у пользователя ввод и возвращает его.
Параметры
- строка
$prompt - Текст запроса.
- строка|массив
$options - Массив или строка опций.
- строка
$default - Значение ввода по умолчанию.
Возвращает
Eitherзначение по умолчанию или введённое пользователем значение.
_loadModelssource protected
_loadModels( )
Если $uses — массив, загружает каждый из моделей в массиве
Возвращает
booleanbool
_modelKeysource protected
_modelKey( string $name )
Создаёт правильное подчеркнутое имя модели для ассоциаций
Параметры
- строка
$name - Имя класса модели
Возвращает
stringЕдиничное имя ключа модели
_modelNamesource protected
_modelName( string $name )
Создаёт правильное именованное имя модели (единственное число) для указанного имени
Параметры
- строка
$name - Имя
Возвращает
stringИменованное и единственное имя модели
_modelNameFromKeysource protected
_modelNameFromKey( string $key )
Создаёт правильное имя модели из внешнего ключа
Параметры
- строка
$key - Внешний ключ
Возвращает
stringИмя модели
_pluginPathsource protected
_pluginPath( string $pluginName )
Находит правильный путь для плагина. Ищет плагин в $pluginPaths.
Параметры
- строка
$pluginName - Имя плагина, например DebugKit
Возвращает
stringПуть к плагину.
_pluralHumanNamesource protected
_pluralHumanName( string $name )
Создаёт множественное имя, используемое в представлениях
Параметры
- строка
$name - Имя контроллера
Возвращает
stringМножественное человекопонятное имя
_pluralNamesource protected
_pluralName( string $name )
Создаёт множественное имя для представлений
Параметры
- строка
$name - Используемое имя
Возвращает
stringМножественное имя для представлений
_singularHumanNamesource protected
_singularHumanName( string $name )
Создаёт единственное человекопонятное имя, используемое в представлениях
Параметры
- строка
$name - Имя контроллера
Возвращает
stringЕдинственное человекопонятное имя
_singularNamesource protected
_singularName( string $name )
Создаёт единственное имя для использования в представлениях.
Параметры
- строка
$name - Значение множественного числа в нижнем регистре с подчёркиваниями.
Возвращает
stringИмя
_useLoggersource protected
_useLogger( boolean $enable true )
Используется для включения или отключения вывода журналов в stdout и stderr. Если вы не хотите видеть в stdout или stderr все записи, сделанные через CakeLog, вызовите эту функцию с первым параметром false.
Параметры
- boolean
$enableнеобязательно true - включить или выключить вывод CakeLog
clearsource public
clear( )
Очистить консоль
Ссылка
http://book.cakephp.org/2.0/ru/console-and-shells.html#Shell::clearcreateFilesource public
createFile( string $path , string $contents )
Создаёт файл по указанному пути
Параметры
- строка
$path - Местоположение файла.
- строка
$contents - Содержимое файла.
Возвращает
booleanУспех
Ссылка
http://book.cakephp.org/2.0/ru/console-and-shells.html#Shell::createFiledispatchShellsource public
dispatchShell( )
Пересылает команду другой оболочке. Похоже на Object::requestAction(), но предназначено для запуска оболочек из других оболочек.
Использование:
С строковой командой:
return $this->dispatchShell('schema create DbAcl');
Избегайте использования этого формата, если у вас есть строковые аргументы с пробелами. Отправленная команда будет запущена неправильно. Используйте этот формат только для простой передачи команд.
С массивной командой:
return $this->dispatchShell('schema', 'create', 'i18n', '--dry');
Возвращает
mixedРезультат работы другой оболочки.
Ссылка
http://book.cakephp.org/2.0/ru/console-and-shells.html#Shell::dispatchShellerrsource public
err( string|array $message null , integer $newlines 1 )
Выводит одно или несколько сообщений об ошибках в stderr. Если нет параметров, выводит только символ новой строки.
Параметры
- строка|массив
$messageнеобязательно null - Строка или массив строк для вывода
- целое число
$newlinesнеобязательно 1 - Количество символов новой строки для добавления
Ссылка
http://book.cakephp.org/2.0/ru/console-and-shells.html#Shell::errerrorsource public
error( string $title , string $message null )
Отображает отформатированное сообщение об ошибке и завершает работу приложения со статусом 1
Параметры
- string
$title - Заголовок ошибки
- string
$messageoptional null - Необязательное сообщение об ошибке
Ссылка
http://book.cakephp.org/2.0/ru/console-and-shells.html#Shell::errorhasMethodsource public
hasMethod( string $name )
Проверяет, содержит ли данная оболочка вызываемый метод с заданным именем.
Параметры
- string
$name - Имя метода для проверки.
Возвращает
booleanbool
Ссылка
http://book.cakephp.org/2.0/ru/console-and-shells.html#Shell::hasMethodhasTasksource public
hasTask( string $task )
Проверяет, содержит ли эта оболочка задачу с указанным именем.
Параметры
- string
$task - Имя задачи для проверки.
Возвращает
booleanУспех
Ссылка
http://book.cakephp.org/2.0/ru/console-and-shells.html#Shell::hasTaskhrsource public
hr( integer $newlines 0 , integer $width 63 )
Выводит на стандартный вывод последовательность символов «-», служит визуальным разделителем.
Параметры
- integer
$newlinesoptional 0 - Количество новых строк для добавления в начале и конце
- integer
$widthoptional 63 - Ширина линии, по умолчанию 63
Ссылка
http://book.cakephp.org/2.0/ru/console-and-shells.html#Shell::hrinsource public
in( string $prompt , string|array $options null , string $default null )
Запрашивает у пользователя ввод и возвращает его.
Параметры
- string
$prompt - Текст запроса.
- string|array
$optionsoptional null - Массив или строка опций.
- string
$defaultoptional null - Значение ввода по умолчанию.
Возвращает
mixedЛибо значение по умолчанию, либо введенное пользователем значение.
Ссылка
http://book.cakephp.org/2.0/ru/console-and-shells.html#Shell::ininitializesource public
initialize( )
Инициализирует оболочку, выполняет роль конструктора для подклассов, позволяет настроить задачи до запуска оболочки.
Ссылка
http://book.cakephp.org/2.0/ru/console-and-shells.html#Shell::initializeloadModelsource public
loadModel( string $modelClass null , mixed $id null )
Загружает и создает модели, необходимые для этой оболочки.
Параметры
- string
$modelClassoptional null - Имя класса модели для загрузки
- mixed
$idoptional null - Изначальный идентификатор, который должна иметь созданная модель
Возвращает
mixedtrue при обнаружении единственной модели и создании экземпляра, возвращает ошибку, если модель не найдена.
Выбрасывает
MissingModelExceptionесли класс модели не найден.
loadTaskssource public
loadTasks( )
Загружает задачи, определенные в public $tasks
Возвращает
booleanbool
nlsource public
nl( integer $multiplier 1 )
Возвращает последовательность одной или нескольких символов новой строки.
Параметры
- integer
$multiplieroptional 1 - Число повторений последовательности новой строки
Возвращает
stringstring
Ссылка
http://book.cakephp.org/2.0/ru/console-and-shells.html#Shell::nloutsource public
out( string|array $message null , integer $newlines 1 , integer $level Shell::NORMAL )
Выводит одно или несколько сообщений в стандартный вывод. Если параметры не указаны, выводит только символ новой строки.
Уровни вывода
Существует 3 встроенных уровня вывода. Shell::QUIET, Shell::NORMAL, Shell::VERBOSE. Уровни вывода verbose и quiet соответствуют переключателям вывода verbose и quiet в большинстве оболочек. Использование Shell::QUIET для сообщения означает, что оно всегда будет отображаться. Использование Shell::VERBOSE означает, что оно будет отображаться только при включенном подробном выводе.
Параметры
- string|array
$messageoptional null - Строка или массив строк для вывода
- integer
$newlinesoptional 1 - Количество символов новой строки для добавления
- integer
$leveloptionalShell::NORMAL - Уровень вывода сообщения, см. выше.
Возвращает
integer|booleanВозвращает количество байтов, возвращенных при записи в стандартный вывод.
Ссылка
http://book.cakephp.org/2.0/ru/console-and-shells.html#Shell::outoverwritesource public
overwrite( array|string $message , integer $newlines 1 , integer $size null )
Перезаписывает уже выведенный текст.
Полезно для построения полосок прогресса или когда нужно заменить текст, уже выведенный на экран, новым текстом.
Предупреждение Нельзя перезаписывать текст, содержащий символы новой строки.
Параметры
- array|string
$message - Сообщение для вывода.
- integer
$newlinesoptional 1 - Количество символов новой строки для добавления.
- integer
$sizeoptional null - Количество байтов для перезаписи. По умолчанию равно длине последнего выведенного сообщения.
Возвращает
integer|booleanВозвращает количество байтов, возвращенных при записи в стандартный вывод.
paramsource public
param( string $name )
Безопасно получает значения из $this->params.
Параметры
- string
$name - Имя параметра для получения.
Возвращает
string|boolean|nullЗначение. Возвращает null, если параметр не существует.
runCommandsource public
runCommand( string $command , array $argv )
Выполняет оболочку с предоставленным argv.
Делегирует вызовы задачам и разрешает методы внутри класса. Команды ищутся в следующем порядке:
- Метод в оболочке.
- Соответствующее имя задачи.
-
main()метод.
Если оболочка реализует main() метод, все отсутствующие вызовы методов будут отправлены в main() с исходным именем метода в argv.
Параметры
- string
$command - Имя команды для выполнения в этой оболочке. Если этот аргумент пустой, а у оболочки есть
main()метод, он будет вызван вместо него. - array
$argv - Массив аргументов для выполнения оболочки. Из этого массива должно быть удалено имя оболочки.
Ссылка
http://book.cakephp.org/2.0/ru/console-and-shells.html#Shell::runCommandshortPathsource public
shortPath( string $file )
Делает абсолютный путь к файлу более читаемым
Параметры
- строка
$file - Абсолютный путь к файлу
Возвращает
stringКороткое имя пути
Ссылка
http://book.cakephp.org/2.0/ru/console-and-shells.html#Shell::shortPathwrapTextsource public
wrapText( string $text , string|integer|array $options array() )
Разбивает блок текста на строки. Позволяет задать ширину и отступы для блока текста.
Параметры
-
widthШирина разбиения. По умолчанию 72 -
wordWrapРазбивать только по словам (пробелы). По умолчанию true. -
indentОтступы текста с помощью указанной строки. По умолчанию null.
Параметры
- строка
$text - Текст для форматирования.
- строка|целое число|массив
$optionsнеобязательно массив() - Массив с параметрами, или целое число для ширины разбиения.
Возвращает
stringОтформатированный текст
См. также
CakeText::wrap()Ссылка
http://book.cakephp.org/2.0/ru/console-and-shells.html#Shell::wrapTextМетоды, унаследованные от Object
_mergeVarssource protected
_mergeVars( array $properties , string $class , boolean $normalize true )
Объединяет свойства $property объекта с свойствами $class' определения. Значение свойства этого класса будет объединено поверх $class'
Это обеспечивает некоторые из функций DRY, которые предоставляет CakePHP. Если вы хотите отключить это, переопределите этот метод как пустую функцию.
Параметры
- массив
$properties - Наименования свойств для объединения.
- строка
$class - Класс для объединения свойства с.
- логическое значение
$normalizeнеобязательно true - Установить в true для выполнения Hash::normalize() над свойствами перед объединением.
_setsource protected
_set( array $properties array() )
Позволяет установить несколько свойств объекта в одной строке кода. Будут установлены только свойства, которые являются частью объявления класса.
Параметры
- массив
$propertiesнеобязательно массив() - Ассоциативный массив, содержащий свойства и соответствующие значения.
_stopsource protected
_stop( integer|string $status 0 )
Останавливает выполнение текущего скрипта. Обёртка для exit(), что упрощает тестирование.
Параметры
- целое число|строка
$statusнеобязательно 0 - см. http://php.net/exit для значений
dispatchMethodsource public
dispatchMethod( string $method , array $params array() )
Вызывает метод этого объекта с заданными параметрами. Обеспечивает объектно-ориентированную обёртку для call_user_func_array
Параметры
- строка
$method - Имя вызываемого метода
- массив
$paramsнеобязательно массив() - Список параметров для вызова $method
Возвращает
mixedРезультат вызова метода
logsource public
log( string $msg , integer $type LOG_ERR , null|string|array $scope null )
Удобный метод для записи сообщения в CakeLog. Для получения дополнительной информации о записи в журналы, см. CakeLog::write().
Параметры
- строка
$msg - Сообщение журнала
- целое число
$typeнеобязательно LOG_ERR - Константа типа ошибки. Определена в app/Config/core.php.
- null|строка|массив
$scopeнеобязательно null - Область(и), в которой создается сообщение журнала. Для получения дополнительной информации о областях логирования, см. CakeLog::config().
Возвращает
booleanРезультат записи в журнал
requestActionsource public
requestAction( string|array $url , array $extra array() )
Вызывает метод контроллера из любой точки. Может использоваться для связи контроллеров или подключения плагинов к основному приложению. requestAction может использоваться для возвращения отрисованных представлений или извлечения возвращаемого значения из действий контроллера.
Под капотом этот метод использует Router::reverse() для преобразования параметра $url в строковый URL. Вы должны использовать форматы URL, совместимые с Router::reverse().
Передача данных POST и GET
Данные POST и GET можно моделировать в requestAction. Используйте $extra['url'] для данных GET. Параметр $extra['data'] позволяет моделировать данные POST.
Параметры
- строка|массив
$url - Строковый или массивный URL. В отличие от других массивов URL в CakePHP, этот URL не будет автоматически обрабатывать переданные и именованные аргументы в параметре $url.
- массив
$extraнеобязательно массив() - Если массив содержит ключ "return", устанавливает AutoRender в true. Также можно использовать для отправки данных GET/POST, а также именованных/переданных аргументов.
Возвращает
mixedБулево значение true или false при успехе/неудаче, или содержимое отрисованного действия, если в $extra установлен 'return'.
toStringsource public
toString( )
Преобразование объекта в строку. Каждый класс может переопределить этот метод по мере необходимости.
Возвращает
stringИмя этого класса
Константы, унаследованные от Shell
CODE_ERROR, NORMAL, QUIET, VERBOSE |
Сводка свойств
Свойства, унаследованные от Shell
$OptionParsersource
public ConsoleOptionParser
Экземпляр ConsoleOptionParser, настроенный для этого класса.
$_lastWrittensource
protected integer
Количество байтов, последний раз записанных в поток вывода, используемое при перезаписи предыдущего сообщения.
$interactivesource
public boolean
Если true, скрипт запросит разрешение на выполнение действий.
true $modelClasssource
public string
Основное имя класса модели для этого шелла, первая модель в свойстве $uses.
null $paramssource
public array
Содержит параметры командной строки, разобранные из командной строки.
array() $pluginsource
public string
Имя плагина, к которому принадлежит шелл. Автоматически устанавливается ShellDispatcher при создании шелла.
null $usessource
public array
Содержит модели для загрузки и инициализации
Ссылка
http://book.cakephp.org/2.0/ru/console-and-shells.html#Shell::$usesarray()
© 2005–2016 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
http://api.cakephp.org/2.7/class-AclShell.html