modX.setPlaceholders

modX::setPlaceholders¶

Устанавливает коллекцию плейсхолдеров, хранящихся в массиве или в виде объектных переменных. Необязательный параметр пространства имен может быть добавлен перед каждым ключом-плейсхолдера в коллекции, чтобы изолировать коллекцию-плейсхолдеров.

Обратите внимание, что в отличие от modX.toPlaceholders и modX.getChunk, эта функция не добавляет разделители между пространством имен и ключом-плейсхолдера. Используйте toPlaceholders() при работе с многомерными массивами или объектами с переменными, отличными от скаляров, поэтому каждый уровень разделяется разделителем.

Синтаксис¶

void setPlaceholders (array|object  $placeholders, [string $namespace = ''])

Разделитель не вставляется — ни между пространством имен и ключом, ни между уровнями вложенного массива. Поэтому setPlaceholders(['a' => ['b' => 1]]) с пустым пространством имен устанавливает один плейсхолдер с именем ab.

Вложенные массивы объединяются так же: getChunk и toPlaceholders вставляют точку между уровнями, а setPlaceholders — нет. Для многомерных массивов и объектов со значениями, отличными от скалярных, используйте modX.toPlaceholders, который разделяет каждый уровень разделителем (по умолчанию точкой).

Пример¶

Добавьте массив плейсхолдеров и префикс “my.” к их ключу.

$modx->setPlaceholders(array(
   'name' => 'John',
   'email' => '[email protected]',
),'my.');

Смотрите также¶

• modX.toPlaceholder
• modX.toPlaceholders
• modX.setPlaceholder
• modX.getPlaceholder