Global Functions and Constants

CodeIgniter uses provides a few functions and variables that are globally defined, and are available to you at any point. These do not require loading any additional libraries or helpers.

Global Functions

Service Accessors

cache([$key])
パラメータ:
  • $key (string) -- The cache name of the item to retrieve from cache (Optional)
戻り値:

Either the cache object, or the item retrieved from the cache

戻り値の型:

mixed

If no $key is provided, will return the Cache engine instance. If a $key is provided, will return the value of $key as stored in the cache currently, or null if no value is found.

Examples:

$foo = cache('foo');
$cache = cache();
env($key[, $default=null])
パラメータ:
  • $key (string) -- The name of the environment variable to retrieve
  • $default (mixed) -- The default value to return if no value is found.
戻り値:

The environment variable, the default value, or null.

戻り値の型:

mixed

Used to retrieve values that have previously been set to the environment, or return a default value if it is not found. Will format boolean values to actual booleans instead of string representations.

Especially useful when used in conjunction with .env files for setting values that are specific to the environment itself, like database settings, API keys, etc.

esc($data, $context='html'[, $encoding])
パラメータ:
  • $data (string|array) -- The information to be escaped.
  • $context (string) -- The escaping context. Default is 'html'.
  • $encoding (string) -- The character encoding of the string.
戻り値:

The escaped data.

戻り値の型:

mixed

Escapes data for inclusion in web pages, to help prevent XSS attacks. This uses the Zend Escaper library to handle the actual filtering of the data.

If $data is a string, then it simply escapes and returns it. If $data is an array, then it loops over it, escaping each 'value' of the key/value pairs.

Valid context values: html, js, css, url, attr, raw, null

helper($filename)
パラメータ:
  • $filename (string|array) -- The name of the helper file to load, or an array of names.

Loads a helper file.

For full details, see the Helper Functions page.

lang($line[, $args[, $locale]])
パラメータ:
  • $line (string) -- The line of text to retrieve
  • $args (array) -- An array of data to substitute for placeholders.
  • $locale (string) -- Specify a different locale to be used instead of default one.

Retrieves a locale-specific file based on an alias string.

For more information, see the Localization page.

old($key[, $default = null[, $escape = 'html']])
パラメータ:
  • $key (string) -- The name of the old form data to check for.
  • $default (mixed) -- The default value to return if $key doesn't exist.
  • $escape (mixed) -- An escape context or false to disable it.
戻り値:

The value of the defined key, or the default value.

戻り値の型:

mixed

Provides a simple way to access "old input data" from submitting a form.

例:

// in controller, checking form submittal
if (! $model->save($user))
{
        // 'withInput' is what specifies "old data"
        // should be saved.
        return redirect()->back()->withInput();
}

// In the view
<input type="email" name="email" value="<?= old('email') ?>">
// Or with arrays
<input type="email" name="user[email]" value="<?= old('user.email') ?>">

注釈

If you are using the form helper, this feature is built-in. You only need to use this function when not using the form helper.

session([$key])
パラメータ:
  • $key (string) -- The name of the session item to check for.
戻り値:

An instance of the Session object if no $key, the value found in the session for $key, or null.

戻り値の型:

mixed

Provides a convenient way to access the session class and to retrieve a stored value. For more information, see the Sessions page.

timer([$name])
パラメータ:
  • $name (string) -- The name of the benchmark point.
戻り値:

The Timer instance

戻り値の型:

CodeIgniterDebugTimer

A convenience method that provides quick access to the Timer class. You can pass in the name of a benchmark point as the only parameter. This will start timing from this point, or stop timing if a timer with this name is already running.

例:

// Get an instance
$timer = timer();

// Set timer start and stop points
timer('controller_loading');    // Will start the timer
. . .
timer('controller_loading');    // Will stop the running timer
view($name[, $data[, $options]])
パラメータ:
  • $name (string) -- The name of the file to load
  • $data (array) -- An array of key/value pairs to make available within the view.
  • $options (array) -- An array of options that will be passed to the rendering class.
戻り値:

The output from the view.

戻り値の型:

string

Grabs the current RendererInterface-compatible class and tells it to render the specified view. Simply provides a convenience method that can be used in Controllers, libraries, and routed closures.

Currently, only one option is available for use within the $options array, saveData which specifies that data will persistent between multiple calls to view() within the same request. By default, the data for that view is forgotten after displaying that single view file.

The $option array is provided primarily to facilitate third-party integrations with libraries like Twig.

例:

$data = ['user' => $user];

echo view('user_profile', $data);

For more details, see the Views page.

Miscellaneous Functions

csrf_token()
戻り値:The name of the current CSRF token.
戻り値の型:string

Returns the name of the current CSRF token.

csrf_hash()
戻り値:The current value of the CSRF hash.
戻り値の型:string

Returns the current CSRF hash value.

csrf_field()
戻り値:A string with the HTML for hidden input with all required CSRF information.
戻り値の型:string

Returns a hidden input with the CSRF information already inserted:

<input type="hidden" name="{csrf_token}" value="{csrf_hash}">
force_https($duration = 31536000[, $request = null[, $response = null]])
パラメータ:
  • $duration (int) -- The number of seconds browsers should convert links to this resource to HTTPS.
  • $request (RequestInterface) -- An instance of the current Request object.
  • $response (ResponseInterface) -- An instance of the current Response object.

Checks to see if the page is currently being accessed via HTTPS. If it is, then nothing happens. If it is not, then the user is redirected back to the current URI but through HTTPS. Will set the HTTP Strict Transport Security header, which instructs modern browsers to automatically modify any HTTP requests to HTTPS requests for the $duration.

is_cli()
戻り値:TRUE if the script is being executed from the command line or FALSE otherwise.
戻り値の型:bool
log_message($level, $message[, $context])
パラメータ:
  • $level (string) -- The level of severity
  • $message (string) -- The message that is to be logged.
  • $context (array) -- An associative array of tags and their values that should be replaced in $message
戻り値:

TRUE if was logged successfully or FALSE if there was a problem logging it

戻り値の型:

bool

Logs a message using the Log Handlers defined in app/Config/Logger.php.

Level can be one of the following values: emergency, alert, critical, error, warning, notice, info, or debug.

Context can be used to substitute values in the message string. For full details, see the Logging Information page.

redirect(string $uri)
パラメータ:
  • $uri (string) -- The URI to redirect the user to.

Returns a RedirectResponse instance allowing you to easily create redirects:

// Go back to the previous page
return redirect()->back();

// Go to specific UI
return redirect()->to('/admin');

// Go to a named/reverse-routed URI
return redirect()->route('named_route');

// Keep the old input values upon redirect so they can be used by the `old()` function
return redirect()->back()->withInput();

// Set a flash message
return redirect()->back()->with('foo', 'message');

When passing a URI into the function, it is treated as a reverse-route request, not a relative/full URI, treating it the same as using redirect()->route():

// Go to a named/reverse-routed URI
return redirect('named_route');
remove_invisible_characters($str[, $url_encoded = TRUE])
パラメータ:
  • $str (string) -- Input string
  • $url_encoded (bool) -- Whether to remove URL-encoded characters as well
戻り値:

Sanitized string

戻り値の型:

string

This function prevents inserting NULL characters between ASCII characters, like Java\0script.

例:

remove_invisible_characters('Java\\0script');
// Returns: 'Javascript'
route_to($method[, ...$params])
パラメータ:
  • $method (string) -- The named route alias, or name of the controller/method to match.
  • $params (mixed) -- One or more parameters to be passed to be matched in the route.

Generates a relative URI for you based on either a named route alias, or a controller::method combination. Will take parameters into effect, if provided.

For full details, see the URI ルーティング page.

service($name[, ...$params])
パラメータ:
  • $name (string) -- The name of the service to load
  • $params (mixed) -- One or more parameters to pass to the service method.
戻り値:

An instance of the service class specified.

戻り値の型:

mixed

Provides easy access to any of the Services defined in the system. This will always return a shared instance of the class, so no matter how many times this is called during a single request, only one class instance will be created.

例:

$logger = service('logger');
$renderer = service('renderer', APPPATH.'views/');
single_service($name[, ...$params])
パラメータ:
  • $name (string) -- The name of the service to load
  • $params (mixed) -- One or more parameters to pass to the service method.
戻り値:

An instance of the service class specified.

戻り値の型:

mixed

Identical to the service() function described above, except that all calls to this function will return a new instance of the class, where service returns the same instance every time.

stringify_attributes($attributes[, $js])
パラメータ:
  • $attributes (mixed) -- string, array of key value pairs, or object
  • $js (boolean) -- TRUE if values do not need quotes (Javascript-style)
戻り値:

String containing the attribute key/value pairs, comma-separated

戻り値の型:

string

Helper function used to convert a string, array, or object of attributes to a string.

Global Constants

The following constants are always available anywhere within your application.

Core Constants

constant APPPATH

The path to the app directory.

constant ROOTPATH

The path to the project root directory. Just above APPPATH.

constant SYSTEMPATH

The path to the system directory.

constant FCPATH

The path to the directory that holds the front controller.

constant WRITEPATH

The path to the writable directory.

Time Constants

constant SECOND

Equals 1.

constant MINUTE

Equals 60.

constant HOUR

Equals 3600.

constant DAY

Equals 86400.

constant WEEK

Equals 604800.

constant MONTH

Equals 2592000.

constant YEAR

Equals 31536000.

constant DECADE

Equals 315360000.