<?xml version="1.0" encoding="utf-8"?>

<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.opcache-get-status">

<refnamediv>

<refname>opcache_get_status</refname>

<refpurpose>キャッシュについてのステータス情報を取得</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type class="union"><type>array</type><type>false</type></type><methodname>opcache_get_status</methodname>

<methodparam choice="opt"><type>bool</type><parameter>include_scripts</parameter><initializer>&true;</initializer></methodparam>

</methodsynopsis>

<simpara>

この関数は、インメモリ の キャッシュ・インスタンス

についてのステータス情報を返します。

ファイルキャッシュに関する情報は一切返しません。

</simpara>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<variablelist>

<varlistentry>

<term><parameter>include_scripts</parameter></term>

<listitem>

<simpara>

スクリプト固有の状態の情報を含む。

</simpara>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<simpara>

情報の配列を返します。スクリプト固有の状態の情報をオプションで含みます、

&return.falseforfailure;。

</simpara>

</refsect1>

<refsect1 role="errors">

&reftitle.errors;

<simpara>

<literal>opcache.restrict_api</literal> を使用中で、

かつ現在のパスがルール違反の場合、

E_WARNING が発生します。

ステータス情報は返されません。

</simpara>

</refsect1>

<refsect1 role="changelog">

&reftitle.changelog;

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>PHP 8.3.0</entry>

<entry>

<code>opcache_get_status()['scripts'][n]['revalidate']</code> の値に、

いつスクリプトの更新チェックを行うかの予定が Unix タイムスタンプの形で含まれるようになりました。

いつチェックを行うかは、INI ディレクティブ

<link linkend="ini.opcache.revalidate-freq">opcache.revalidate_freq</link>

によって決まります。

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<example>

<title><function>opcache_get_status</function> の例</title>

<programlisting role="php">

</programlisting>

&example.outputs.similar;

<screen>

</screen>

</example>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<simplelist>

<member><function>opcache_get_configuration</function></member>

</simplelist>

</refsect1>

</refentry>