apc_define_constants()

apc_define_constants - Defines a set of constants for retrieval and mass-definition

Syntax

bool apc_define_constants (string $key, array $constants, bool $case_sensitive)

Arguments

• key - The key serves as the name of the constant set being stored. This key is used to retrieve the stored constants in apc_load_constants().
• constants - An associative array of constant_name => valuepairs. The constant_namemust follow the normal constantnaming rules. valuemust evaluate to a scalar value.
• case_sensitive - The default behaviour for constants is to be declared case-sensitive; i.e. CONSTANTand Constantrepresent different values. If this parameter evaluates to FALSE the constants will be declared as case-insensitive symbols.

Description

define() is notoriously slow. Since the main benefit of APC is to increase the performance of scripts/applications, this mechanism is provided to streamline the process of mass constant definition. However, this function does not perform as well as anticipated.

Version

PHP PECL apc >= 3.0.0

Return value

Returns TRUE on success or FALSE on failure.