From de3b95590b5eba35508b4a65c930a455fdafc82b Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 4 Dec 2024 11:50:22 +0100
Subject: [PATCH] [PHP 8.3] Add `opcache_get_status()` example and changelog

---
 .../opcache/functions/opcache-get-status.xml  | 126 ++++++++++++++++++
 1 file changed, 126 insertions(+)

diff --git a/reference/opcache/functions/opcache-get-status.xml b/reference/opcache/functions/opcache-get-status.xml
index b98798c5627b..0276e284ff48 100644
--- a/reference/opcache/functions/opcache-get-status.xml
+++ b/reference/opcache/functions/opcache-get-status.xml
@@ -48,6 +48,132 @@
    be returned.
   </para>
  </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>
+       now contains a Unix timestamp of when the next revalidation of the
+       scripts timestamp is due, as dictated by the
+       <link linkend="ini.opcache.revalidate-freq"><literal>opcache.revalidate_freq</literal></link>
+       INI directive.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title>A <function>opcache_get_status</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+var_dump(opcache_get_status());
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+array(9) {
+  'opcache_enabled' =>
+  bool(true)
+  'cache_full' =>
+  bool(false)
+  'restart_pending' =>
+  bool(false)
+  'restart_in_progress' =>
+  bool(false)
+  'memory_usage' =>
+  array(4) {
+    'used_memory' =>
+    int(9167936)
+    'free_memory' =>
+    int(125049792)
+    'wasted_memory' =>
+    int(0)
+    'current_wasted_percentage' =>
+    double(0)
+  }
+  'interned_strings_usage' =>
+  array(4) {
+    'buffer_size' =>
+    int(8388608)
+    'used_memory' =>
+    int(2593616)
+    'free_memory' =>
+    int(5794992)
+    'number_of_strings' =>
+    int(10358)
+  }
+  'opcache_statistics' =>
+  array(13) {
+    'num_cached_scripts' =>
+    int(0)
+    'num_cached_keys' =>
+    int(0)
+    'max_cached_keys' =>
+    int(16229)
+    'hits' =>
+    int(0)
+    'start_time' =>
+    int(1733310010)
+    'last_restart_time' =>
+    int(0)
+    'oom_restarts' =>
+    int(0)
+    'hash_restarts' =>
+    int(0)
+    'manual_restarts' =>
+    int(0)
+    'misses' =>
+    int(0)
+    'blacklist_misses' =>
+    int(0)
+    'blacklist_miss_ratio' =>
+    double(0)
+    'opcache_hit_rate' =>
+    double(0)
+  }
+  'scripts' =>
+  array(0) {
+  }
+  'jit' =>
+  array(7) {
+    'enabled' =>
+    bool(false)
+    'on' =>
+    bool(false)
+    'kind' =>
+    int(5)
+    'opt_level' =>
+    int(4)
+    'opt_flags' =>
+    int(6)
+    'buffer_size' =>
+    int(0)
+    'buffer_free' =>
+    int(0)
+  }
+}
+]]>
+   </screen>
+  </example>
+ </refsect1>
  
  <refsect1 role="seealso">
   &reftitle.seealso;