[CodeIgniter4] - パブリック関数とグローバル定数

CodeIgniterでは、あなたはどこでもそれらを使用することができますし、任意のライブラリやヘルパーをロードする必要はありません。

• 公共の機能
  • サービスアクセサ機能
  • その他の機能
• グローバル定数
  • コア定数
  • 時定数

公共の機能

サービスアクセサ機能

cache （[ $キー] ）

パラメータ：	キー$  （文字列） -キャッシュ（オプション）から取得するパラメータの名前
戻り値：	キャッシュまたは変数から取得したキャッシュ・オブジェクト
戻り値の型：	ミックス

$キーが存在しない場合は、キャッシュエンジンはインスタンスを返します。$キーの値が存在する場合は、キャッシュに保存されている$キーの現在の値は、値が存在しない場合はnullが返され返されます。

例：

$foo = cache('foo'); $cache = cache(); 

env （$キー[、  $デフォルト= NULL ] ）

パラメータ：	キー$  （文字列） -で検索するパラメータの環境変数の名前 $デフォルト  （ミックスを） -パラメータの値は、デフォルト値が返され提示されていません。
戻り値：	動作環境変数、デフォルト値、またはnull。
戻り値の型：	ミックス

変数が設定されていない場合は、デフォルト値が返され、環境変数の値に予めセットを取得するために使用されます。キー値は、それはブール結果（偽）を返します。見つからない場合。

セットの環境変数に特定の動作環境.envファイルを使用するには、データベースの設定、APIおよび他の健康上の値として有用です。

esc （$データ、  $コンテキスト= 'HTML' [、  $コード] ）

パラメータ：	データ$  （文字列|配列） -情報が出力されます。 コンテキスト$  （文字列） - 。コンテキストは「HTML」コンテンツのデフォルトを出力しています。 エンコード$  （文字列） -エンコードされた文字列。
戻り値：	出力データ（エスケープデータ）。
戻り値の型：	ミックス

出力データは、XSS攻撃を予防するのに有用であるページに含まれます。使用ラミナエスケーライブラリは、実際のデータのフィルタリングを処理します。

$データは文字列であり、かつシンプルな脱出を返す場合。$ data配列の場合、その配列によって、キーの「価値」でエスケープキー/値のペア。

有効なコンテキスト値：HTML、JS、CSS、URL、ATTR、生、ナル

helper （$ファイル名）

パラメータ：	ファイル名$  （文字列|配列） -追加の補助クラスファイルの名前、またはクラスの配列を含むファイル名。

    補助負荷クラスファイル。

詳細については、ヘルパーのページを参照してください。

lang （$行[、  $ argsを[、  $ロケール] ] ）

param文字列$行：
	テキスト行を取得します
param配列$ argsを：
	配列データのセットは、プレースホルダを交換します。

パラメータ：	$ロケール  （文字列） - 異なる地域ではなく、デフォルトのロケールを使用します。 ローカル別名文字列上の特定のファイルを取得します。

    詳細については、ローカライズページを参照してください。

old （$キー[、  $デフォルト= NULL [、  $エスケープ= 'HTML' ] ] ）

param文字列$キー：
	主な元の形は、提出を使用する必要があります。
混合$デフォルトをPARAM：
	$キーの返却は時にデフォルトが存在しない場合。

パラメータ：	$エスケープ  （ミックス） - エスケープのコンテキストまたは機能を無効にするには、値はfalseを渡します。 戻り値： デフォルトのキー値に対応する値、またはの集合が与えられます
戻り値の型：	ミックス

これは、フォームが送信されたときに、「元の入力データ」にアクセスするための簡単な方法を提供します。

例：

// 在控制器中查看表单提交
if (! $model->save($user)) { // 'withInput'方法意味着"原有的数据"需要被存储。 return redirect()->back()->withInput(); } // 视图中 <input type="email" name="email" value="<?= old('email') ?>"> // 以数组的形式 <input type="email" name="user[email]" value="<?= old('user.email') ?>"> 

コメント

あなたが使用している場合：DOC：  フォームヘルパー</ヘルパー/ form_helper>  、この機能がビルトインされています。フォームヘルパーを使用していない場合にのみ、手動でのみ呼び出す必要があります。

session （[ $キー] ）

変数文字列$キー：	セッション名の値を見つけるKIN。
戻り値：	セッションオブジェクトのインスタンスが返された場合$キー値はnull、$キーが存在しません。
戻り値の型：	ミックス

これは、クラス値がアクセスセッションを格納および取得する便利な方法を提供します。詳細については、セッションのページを参照してください。

timer ([$name])

参数:	$name (string) – 检测点的名称.
返回:	Timer 实例
返回类型:	CodeIgniterDebugTimer

提供一个快速访问 Timer class的便捷的方法。 你可以将基准点的名称作为唯一参数传递。这将从这一点开始计时， 如果这个名称的计时器已经运行，则停止计时。

示例:

// 获取一个timer实例
$timer = timer();

// 设置计时器的开始与结束点 timer('controller_loading'); // 开始计时器 . . . timer('controller_loading'); // 停止计时器运行 

view ($name[, $data[, $options]])

参数:	$name (string) – 被加载的文件名 $data (array) – 键值对数组，在视图中能被获取。 $options (array) – 可选的参数数组，用于传递值给渲染类.
返回:	视图的输出.
返回类型:	string

抓取当前的 RendererInterface-compatible 类（界面渲染类），告诉它展示特定的视图。给控制器、库、路由闭包提供了一种便捷的方法。

目前，在 $options 数组里只有一个选项是可用的，saveData 指定在同一个请求中，在多次调用 view() 时数据将连续。默认情况下， 在显示该单一视图文件之后，该视图的数据被丢弃。

$option 数组主要用于与第三方库整合，例如Twig。

Example:

$data = ['user' => $user]; echo view('user_profile', $data); 

详情参见 the Views 页。

其他函数

csrf_token ()

返回:	当前 CSRF token 名称。
返回类型:	string

返回当前 CSRF token名称。

csrf_header ()

returns:	The name of the header for current CSRF token.
rtype:	string

The name of the header for current CSRF token.

csrf_hash ()

返回:	当前 CSRF hash值.
返回类型:	string

返回当前 CSRF hash 的值.

csrf_field ()

返回:	带有全部请求CSRF信息的隐藏input的HTML字符串。
返回类型:	string

返回已插入CSRF信息的隐藏input:

<input type=”hidden” name=”{csrf_token}” value=”{csrf_hash}”>

csrf_meta ()

returns:	A string with the HTML for meta tag with all required CSRF information.
rtype:	string

Returns a meta tag with the CSRF information already inserted:

<meta name=”{csrf_header}” content=”{csrf_hash}”>

force_https ($duration = 31536000[, $request = null[, $response = null]])

参数:	$duration (int) – 浏览器的秒数应该将此资源的链接转换为 HTTPS 。 $request (RequestInterface) – 当前请求对象的实例。 $response (ResponseInterface) – 当前响应对象的实例。

检查页面当前是否通过HTTPS访问，如果不是，则用户通过HTTPS重定向回当前URI。 将设置 HTTP 严格的传输安全标头，该命令指示现代浏览器自动将HTTP请求修改为 $duration 参数时间的HTTPS请求。

is_cli ()

返回:	如果脚本是从命令行执行的，则为true，否则为false。
返回类型:	bool

log_message ($level, $message[, $context])

参数:	$level (string) – 级别程度 $message (string) – 写入日志的信息. $context (array) – 一个标记和值的联合数组被替换到 $message
返回:	如果写入日志成功则为 TRUE ，如果写入日志出现问题则为 FALSE 。
返回类型:	bool

使用 app/Config/Logger.php 中定义的日志处理程序记录日志。

级别可为以下值: emergency, alert, critical, error, warning, notice, info, or debug.

Context 可用于替换 message 字符串中的值。详情参见 the:doc:Logging Information <logging> 页。

redirect (string $uri)

param string $uri:
	需要引导用户重定向到的页面.

返回以后RedirectResponse的实例以便创建重定向:

        // 回到上一个页面Go back to the previous page
        return redirect()->back(); // 跳转至具体的URI return redirect()->to('/admin'); // 跳转到一个命名路由或反向路由 URI return redirect()->route('named_route'); // 在跳转中保持原有的输入值，使得它们可以被 `old()` 函数调用。 return redirect()->back()->withInput(); // 显示一个消息 return redirect()->back()->with('foo', 'message'); 当将URI传给这个函数时。它将会被作为一个反向路由请求，而不是一个完整的URI，就像使用 redirect()->route()一样:: // 跳转到一个命名路由或反向路由 URI return redirect('named_route'); 

redirect_with_input ($uri[, ...$params])

参数:	$uri (string) – 重定向URI。 $params (mixed) – 一个或更多附加参数可被用于 the RouteCollection::reverseRoute() 方法。

跟``redirect()``方法等同, 该session刷新的请求中的 $_GET 和 $_POST的值除外。 在下一页的请求, 表单辅助类的 set_* 方法将首先检查旧的输入数据, 若没发现, 则当前的 GET/POST 将被检查。

注意

为了取回旧的值, session必须被启用，优先调用函数.

remove_invisible_characters ($str[, $urlEncoded = TRUE])

参数:	$str (string) – 输入字符串 $urlEncoded (bool) – 是否移除URL编码字符
返回:	已过滤的字符串
返回类型:	string

这个函数防止在 ASCII 字符之间插入空字符(NULL)，例如 Java\0script。

范例:

remove_invisible_characters('Java\\0script');
// 返回: 'Javascript'

route_to ($method[, ...$params])

参数:	$method (string) – 命名路由别名, 或匹配controller/method名称。 $params (mixed) – 一个或更多参数被传递到路由中匹配。

以指定的路由别名或 controller::method 组合为依据生成一个相对 URI 。如果提供参数，将执行参数。

详情参见 the URI 路由 页。

service ($name[, ...$params])

参数:	$name (string) – 加载的服务名称 $params (mixed) – 一个或多个参数传递到服务方法。
返回:	指定的服务类的实例。
返回类型:	mixed

提供简易访问任何在系统中定义的服务，详见the Services 。 这将总是返回类的共享实例，因此不管在单个请求中调用多少次，都只会创建一个类实例。

范例:

$logger = service('logger'); $renderer = service('renderer', APPPATH.'views/'); 

single_service ($name[, ...$params])

参数:	$name (string) – 加载的服务名称 $params (mixed) – 一个或多个参数传递到服务方法。
返回:	指定的服务类的实例。
返回类型:	mixed

等同于前面所描述的  service() 函数, 除了所有调用该函数将返回一个类的新实例。

service 返回的是相同的实例。

stringify_attributes ($attributes[, $js])

参数:	$attributes (mixed) – 字符串, 键值对数组, 或者对象 $js (boolean) – TRUE 若值不需要引用 (Javascript风格)
返回:	字符串包含键值对属性, 逗号分隔
返回类型:	string

辅助函数用于转换字符串, 数组, 或者字符串的对象属性。

全局常量

以下的常量在你的应用中的任何地方有效。

核心常量

constant APPPATH

app 目录的路径。

constant ROOTPATH

项目根目录，APPPATH 目录的上层目录。

constant SYSTEMPATH

system 目录的路径。

constant FCPATH

保存的前端控制器目录的路径。

constant SELF

前端控制器的路径, index.php.

constant WRITEPATH

writable 目录的路径。

时间常量

constant SECOND

等于 1.

constant MINUTE

等于 60.

constant HOUR

等于 3600.

constant DAY

等于 86400.

constant WEEK

等于 604800.

constant MONTH

等于 2592000.

constant YEAR

等于 31536000.

constant DECADE

等于 315360000.