Differential D276 Diff 703 branches/5.2.x/core/kernel/globals.php

Changeset View

Standalone View

branches/5.2.x/core/kernel/globals.php

	Show First 20 Lines • Show All 922 Lines • ▼ Show 20 Line(s)
	}			}

	if ( $strategy == self::ESCAPE_RAW ) {			if ( $strategy == self::ESCAPE_RAW ) {
	return $text;			return $text;
	}			}

	throw new InvalidArgumentException(sprintf('Unknown escape strategy "%s"', $strategy));			throw new InvalidArgumentException(sprintf('Unknown escape strategy "%s"', $strategy));
	}			}

				/**
				* Mark a method as deprecated and inform when it has been used.
				*
				* The current behavior is to trigger a user deprecation notice in Debug Mode.
				* This method is to be used in every method that is deprecated.
				*
				* @param string $method The method that was called.
				* @param string $version The version that deprecated the method.
				* @param string\|null $replacement The method that should have been called.
				*
				* @return void
				*/
				public static function deprecatedMethod($method, $version, $replacement = null)
				{
				$application =& kApplication::Instance();

				if ( !$application->isDebugMode() ) {
				return;
				}

				$msg = '%1$s is <strong>deprecated</strong> since version %2$s';

				if ( !is_null($replacement) ) {
				@trigger_error(sprintf($msg . '! Use %3$s instead.', $method, $version, $replacement), E_USER_DEPRECATED);
				}
				else {
				@trigger_error(sprintf($msg . ' with no alternative available.', $method, $version), E_USER_DEPRECATED);
				}
				}

				/**
				* Mark a method argument as deprecated and inform when it has been used.
				*
				* This method is to be used whenever a deprecated method argument is used.
				* Before this method is called, the argument must be checked for whether it was
				* used by comparing it to its default value or evaluating whether it is empty.
				* For example:
				*
				* if ( !$deprecated ) {
				* kUtil::deprecatedArgument(__METHOD__, '5.2.2');
				* }
				*
				* The current behavior is to trigger a user deprecation notice in Debug Mode.
				*
				* @param string $method The method that was called.
				* @param string $version The version that deprecated the argument used.
				* @param string\|null $message A message regarding the change.
				*
				* @return void
				*/
				public static function deprecatedArgument($method, $version, $message = null)
				{
				$application =& kApplication::Instance();

				if ( !$application->isDebugMode() ) {
				return;
				}

				$msg = '%1$s was called with an argument that is <strong>deprecated</strong> since version %2$s';

				if ( !is_null($message) ) {
				@trigger_error(sprintf($msg . '! %3$s', $method, $version, $message), E_USER_DEPRECATED);
				}
				else {
				@trigger_error(sprintf($msg . ' with no alternative available.', $method, $version), E_USER_DEPRECATED);
				}
				}

	}			}

	/**			/**
	* Returns array value if key exists			* Returns array value if key exists
	* Accepts infinite number of parameters			* Accepts infinite number of parameters
	*			*
	* @param Array $array searchable array			* @param Array $array searchable array
	* @param int $key array key			* @param int $key array key
	▲ Show 20 Lines • Show All 138 Lines • Show Last 20 Lines