writeLog

Записывает сообщение в файл журнала.

writeLog(text [, type] [, application] [, file] [, log] ) → returns void

CF9+

Lucee

BL 1.0.0+

Справочник аргументов

text string
Обязательный

Сообщение для записи в журнал. Дата и время будут добавлены автоматически.

type string

Тип или уровень важности сообщения журнала

Значения:

information
warning
error
fatal

application boolean
По умолчанию: `true`

Записывает имя приложения, если оно указано в Application.cfc или теге cfapplication.

file string

Имя файла, в который нужно записывать данные журнала. Нельзя указать путь к каталогу или расширение файла (расширение будет .log). Если файл не существует, он будет создан автоматически. Файл журнала будет находиться в каталоге журналов сервера CF.

log string

Если атрибут file не указан, сообщения записываются в стандартный файл журнала. Игнорируется, если указан атрибут file. Application: записывает сообщения в Application.log, обычно используемый для сообщений, связанных с конкретным приложением. Scheduler: записывает сообщения в Scheduler.log, обычно используемый для регистрации выполнения запланированных задач.

Значения:

Application
Scheduler

Совместимость

Lucee:

В Lucee 6.2 и более поздних версиях уровень журнала по умолчанию — ERROR, поэтому в файле журнала не появятся сообщения, если не указать type=error или type=fatal. Изменить значение по умолчанию можно, как описано здесь: https://dev.lucee.org/t/application-log-defaults-to-error-in-6-2/14773

Примеры
Пример кода, вызывающего функцию writeLog

Простой пример кода writeLog

Записывает сообщение об успешной обработке заказа в orders.log, который будет находиться в каталоге журналов CF, например: {cf.root}/cfusion/logs/

writeLog(text="Order #order.getOrderID()# Processed Successfully", type="information", file="orders");

© 2012–present Foundeo, Inc. and the CFDocs contributors.
Licensed under the MIT License.
ColdFusion is a trademark of Adobe Systems Incorporated.
https://cfdocs.org/writelog