8. Appendix B. Error messages: A. Resources
« Previous; C. Possible problems
Next »

Appendix B. Error messages

This appendix contains the list of exceptions generated by OPT:

API Exceptions

Opt_Initialization_Exception: Your script tries to perform an action that can be done only if OPT is initialized/uninitialized (see the error message for details).
Opt_ContentType_Exception: The output system received the invalid content type value.
Opt_ObjectNotExists_Exception: The specified item you try to use is not registered in OPT.
Opt_TemplateNotFound_Exception: OPT could not find the specified template within the specified resource.
Opt_OutputOverloaded_Exception: The HTTP output system has already sent the XML content to the browser. The attempt of sending another template content to the browser will surely produce an invalid output document and has been blocked.
Opt_FilesystemAccess_Exception: Permission error: OPT is not able to read/write the specified directory.
Opt_InvalidEntityName_Exception: The specified string is not a valid entity name.
Opt_TreeInvalidDepth_Exception: The opt:tree instruction received invalid depth argument on the element list.

Template exceptions

Opt_XmlNoProlog_Exception: The template must have an XML prolog.; The exception does not occur, if the prologRequired configuration option is set to false.
Opt_XmlInvalidAttribute_Exception: Syntax error in the tag attribute list.
Opt_XmlInvalidProlog_Exception: Syntax/semantic error in the XML prolog.
Opt_XmlInvalidDoctype_Exception: Syntax error in the Doctype tag. Please note that OPT does not check the DTD section syntax.
Opt_XmlInvalidTagStructure_Exception: Invalid use of one of XML elements. For example, if you try to specify attributes for the closing tag, OPT throws this exception.
Opt_XmlRootElement_Exception: The template must contain a single root element.; The exception does not occur, if the singleRootNode configuration option is set to false.
Opt_XmlInvalidCharacter_Exception: Cannot use XML special characters like < and > in the static text. You have to encode them with entities.
Opt_XmlInvalidOrder_Exception: The tags have been closed in the invalid order.
Opt_XmlComment_Exception: The exception occurs, if the comments contain the content that is forbidden by the XML standard.
Opt_InvalidExpressionModifier_Exception: There are only two expression modifiers in OPT: e: and u:. Your template tried to use another one.
Opt_InvalidAttributeType_Exception: The value specified in one of OPT instruction attributes is invalid.
Opt_FormatNotFound_Exception: The specified data format has not been found. Check if you entered the name correctly and if it is installed in OPT.
Opt_FormatNotSupported_Exception: The specified data format does not support the specified functionality.
Opt_AssignNotSupported_Exception: The specified data format does not support assigning the new values to the specified variable.
Opt_FormatNotDecorated_Exception: The specified data format must decorate another data format in order to work properly in the specified place.
Opt_Expression_Exception: OPT expression error. The message identifies the unexpected token.
Opt_FunctionArgument_Exception: Missing argument in the function.
Opt_ExpressionOptionDisabled_Exception: The specified expression syntax option is not available in this place.
Opt_ItemNotAllowed_Exception: The specified item is not registered in OPT and cannot be used in templates.
Opt_SysVariableLength_Exception: The system variable call is invalid. OPT expects it to be longer/shorter.
Opt_SysVariableUnknown_Exception: Unknown system variable action.
Opt_SysVariableInvalidUse_Exception: The specified system variable call cannot be used in this place.
Opt_AttributeNotDefined_Exception: Missing required XML attribute.
Opt_AttributeEmpty_Exception: The required XML attribute is empty.
Opt_InvalidCallback_Exception: The callback registered in OPT is invalid.
Opt_UnknownEntity_Exception: The specified XML entity is not registered in OPT and cannot be parsed.

Compiler exceptions

These exceptions are usually caused by buggy instructions or the compiler code.

Opt_UnknownProcessor_Exception: No instruction processor has been found for the specified postprocessed XML tag.
Opt_CompilerLocked_Exception: The compiler can compile only one template at the same time.
Opt_CompilerCodeBufferConflict_Exception: The specified code buffer permits a limited number of PHP code snippets only.
Opt_APINoWildcard_Exception: Thrown by Opt_Xml_Scannable::sort(); The requested order list must contain a wildcard *.
Opt_APIInvalidBorders_Exception: Undocumented.
Opt_APIInvalidNodeType_Exception: The nodes of the specified type do not accept the specified nodes as their children.
Opt_APIHookNotDefined_Exception: Data format error: the specified hook is not defined in the data format.
Opt_APIMissingDefaultValue_Exception: Thrown by Opt_Compiler_Processor::_extractAttributes().; The optional attribute definition does not contain a default value.
Opt_APINoDataReturned_Exception: The instruction processor requested some data and did not receive them.

Instruction exceptions

The following exceptions are thrown by the instruction processors.

Opt_InstructionInvalidParent_Exception: Invalid parent of the specified tag. Check the instruction documentation.
Opt_InstructionTooManyItems_Exception: Too many occurrences of the specified tag in the instruction. Check the instruction documentation.
Opt_SectionExists_Exception: The specified section is already registered.
Opt_SectionNotFound_Exception: The specified section has not been found.
Opt_InstructionInvalidLocation_Exception: The specified tag must be nested somehow in another tag in order to work properly.
Opt_TreeContent_Exception: Thrown by opt:tree; Informs that the opt:content has been nested in an OPT tag that generates some dynamic PHP code. This may lead to generate an invalid compiler output.
Opt_SnippetRecursion_Exception: Infinite snippet recursion detected.
Opt_CompilerRecursion_Exception: Infinite include recursion detected.
Opt_InheritanceRecursion_Exception: Infinite template inheritance recursion detected.
Opt_IncludeNoAttributes: Thrown by opt:include; The opt:include instruction expects to have either file or from attribute.
Opt_ComponentNotActive_Exception: The specified item cannot be used outside the component context.
Opt_CycleNoValues_Exception: Trying to declare a cycle without values. Please simply add some values to the cycle.
Opt_AttributeInvalidNamespace_Exception: Thrown by opt:single attribute.; This attribute cannot change the state of the tags in the specified namespace.

Other exceptions

Opt_NotImplemented_Exception: The specified feature is not implemented yet.; This exception should not occur in the stable releases.
Opt_NotSupported_Exception: The specified feature is not supported by the current OPT version.

B. Error messages 8. Appendix: « Previous
A. Resources; Next »
C. Possible problems