怎样使用 opcache_get_configuration 函数快速查看当前 OPcache 的运行状态？

gitbox 2025-06-29
<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 与文章内容无关的前置代码部分</span></span><span>
</span><span><span class="hljs-comment">// 例如，简单输出当前时间</span></span><span>
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"当前时间："</span></span><span> . </span><span><span class="hljs-title function_ invoke__">date</span></span><span>(</span><span><span class="hljs-string">'Y-m-d H:i:s'</span></span><span>);
</span><span><span class="hljs-meta">?&gt;</span></span><span>

&lt;hr&gt;

</span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 文章正文内容部分：讲解怎样使用 opcache_get_configuration 函数快速查看当前 OPcache 的运行状态</span></span><span>

<span class="hljs-comment">/*
 * OPcache 是 PHP 的一个字节码缓存扩展，可以极大提升 PHP 脚本的执行效率。
 * 在开发和运维过程中，快速了解 OPcache 的当前状态非常重要。
 * PHP 内置函数 opcache_get_configuration() 可以帮助我们获取 OPcache 的配置信息和状态。
 */</span>

<span class="hljs-comment">/**
 * 使用 opcache_get_configuration 查看 OPcache 当前运行状态的步骤：
 *
 * 1. 确认服务器已经启用 OPcache 扩展
 * 2. 通过 opcache_get_configuration() 获取配置信息
 * 3. 解析配置信息，重点关注缓存大小、缓存使用情况、命中率等
 */</span>

</span><span><span class="hljs-function"><span class="hljs-keyword">function</span></span></span><span> </span><span><span class="hljs-title">showOpcacheStatus</span></span><span>(</span><span><span class="hljs-params"></span></span><span>) {
    </span><span><span class="hljs-keyword">if</span></span><span> (!</span><span><span class="hljs-title function_ invoke__">function_exists</span></span><span>(</span><span><span class="hljs-string">'opcache_get_configuration'</span></span><span>)) {
        </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"OPcache 扩展未启用或当前 PHP 版本不支持该函数。"</span></span><span>;
        </span><span><span class="hljs-keyword">return</span></span><span>;
    }

    </span><span><span class="hljs-comment">// 获取 OPcache 配置和状态信息</span></span><span>
    </span><span><span class="hljs-variable">$config</span></span><span> = </span><span><span class="hljs-title function_ invoke__">opcache_get_configuration</span></span><span>();
    </span><span><span class="hljs-variable">$status</span></span><span> = </span><span><span class="hljs-title function_ invoke__">opcache_get_status</span></span><span>(</span><span><span class="hljs-literal">false</span></span><span>); </span><span><span class="hljs-comment">// false 不显示脚本详细信息，提升效率</span></span><span>

    </span><span><span class="hljs-keyword">if</span></span><span> (!</span><span><span class="hljs-variable">$config</span></span><span> || !</span><span><span class="hljs-variable">$status</span></span><span>) {
        </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"无法获取 OPcache 配置或状态信息。"</span></span><span>;
        </span><span><span class="hljs-keyword">return</span></span><span>;
    }

    </span><span><span class="hljs-comment">// 输出配置信息示例</span></span><span>
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"&lt;h2&gt;OPcache 配置信息&lt;/h2&gt;"</span></span><span>;
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"&lt;ul&gt;"</span></span><span>;
    </span><span><span class="hljs-keyword">foreach</span></span><span> (</span><span><span class="hljs-variable">$config</span></span><span>[</span><span><span class="hljs-string">'directives'</span></span><span>] </span><span><span class="hljs-keyword">as</span></span><span> </span><span><span class="hljs-variable">$key</span></span><span> =&gt; </span><span><span class="hljs-variable">$value</span></span><span>) {
        </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"&lt;li&gt;&lt;b&gt;"</span></span><span> . </span><span><span class="hljs-title function_ invoke__">htmlspecialchars</span></span><span>(</span><span><span class="hljs-variable">$key</span></span><span>) . </span><span><span class="hljs-string">":&lt;/b&gt; "</span></span><span> . </span><span><span class="hljs-title function_ invoke__">htmlspecialchars</span></span><span>(</span><span><span class="hljs-variable">$value</span></span><span>) . </span><span><span class="hljs-string">"&lt;/li&gt;"</span></span><span>;
    }
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"&lt;/ul&gt;"</span></span><span>;

    </span><span><span class="hljs-comment">// 输出状态信息示例</span></span><span>
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"&lt;h2&gt;OPcache 运行状态&lt;/h2&gt;"</span></span><span>;
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"&lt;ul&gt;"</span></span><span>;
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"&lt;li&gt;&lt;b&gt;缓存使用大小:&lt;/b&gt; "</span></span><span> . </span><span><span class="hljs-title function_ invoke__">formatBytes</span></span><span>(</span><span><span class="hljs-variable">$status</span></span><span>[</span><span><span class="hljs-string">'memory_usage'</span></span><span>][</span><span><span class="hljs-string">'used_memory'</span></span><span>]) . </span><span><span class="hljs-string">" / "</span></span><span> . </span><span><span class="hljs-title function_ invoke__">formatBytes</span></span><span>(</span><span><span class="hljs-variable">$status</span></span><span>[</span><span><span class="hljs-string">'memory_usage'</span></span><span>][</span><span><span class="hljs-string">'size'</span></span><span>]) . </span><span><span class="hljs-string">"&lt;/li&gt;"</span></span><span>;
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"&lt;li&gt;&lt;b&gt;缓存碎片:&lt;/b&gt; "</span></span><span> . </span><span><span class="hljs-title function_ invoke__">round</span></span><span>(</span><span><span class="hljs-variable">$status</span></span><span>[</span><span><span class="hljs-string">'memory_usage'</span></span><span>][</span><span><span class="hljs-string">'wasted_percentage'</span></span><span>], </span><span><span class="hljs-number">2</span></span><span>) . </span><span><span class="hljs-string">"%&lt;/li&gt;"</span></span><span>;
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"&lt;li&gt;&lt;b&gt;缓存命中率:&lt;/b&gt; "</span></span><span> . </span><span><span class="hljs-title function_ invoke__">calculateHitRate</span></span><span>(</span><span><span class="hljs-variable">$status</span></span><span>) . </span><span><span class="hljs-string">"%&lt;/li&gt;"</span></span><span>;
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"&lt;li&gt;&lt;b&gt;已缓存脚本数:&lt;/b&gt; "</span></span><span> . </span><span><span class="hljs-variable">$status</span></span><span>[</span><span><span class="hljs-string">'opcache_statistics'</span></span><span>][</span><span><span class="hljs-string">'num_cached_scripts'</span></span><span>] . </span><span><span class="hljs-string">"&lt;/li&gt;"</span></span><span>;
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"&lt;li&gt;&lt;b&gt;总请求数:&lt;/b&gt; "</span></span><span> . </span><span><span class="hljs-variable">$status</span></span><span>[</span><span><span class="hljs-string">'opcache_statistics'</span></span><span>][</span><span><span class="hljs-string">'num_requests'</span></span><span>] . </span><span><span class="hljs-string">"&lt;/li&gt;"</span></span><span>;
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"&lt;/ul&gt;"</span></span><span>;
}

<span class="hljs-comment">/**
 * 格式化字节数为更友好的单位
 */</span>
</span><span><span class="hljs-function"><span class="hljs-keyword">function</span></span></span><span> </span><span><span class="hljs-title">formatBytes</span></span><span>(</span><span><span class="hljs-params"><span class="hljs-variable">$bytes</span></span></span><span>) {
    </span><span><span class="hljs-variable">$units</span></span><span> = [</span><span><span class="hljs-string">'B'</span></span><span>, </span><span><span class="hljs-string">'KB'</span></span><span>, </span><span><span class="hljs-string">'MB'</span></span><span>, </span><span><span class="hljs-string">'GB'</span></span><span>];
    </span><span><span class="hljs-variable">$i</span></span><span> = </span><span><span class="hljs-number">0</span></span><span>;
    </span><span><span class="hljs-keyword">while</span></span><span> (</span><span><span class="hljs-variable">$bytes</span></span><span> &gt;= </span><span><span class="hljs-number">1024</span></span><span> &amp;&amp; </span><span><span class="hljs-variable">$i</span></span><span> &lt; </span><span><span class="hljs-title function_ invoke__">count</span></span><span>(</span><span><span class="hljs-variable">$units</span></span><span>) - </span><span><span class="hljs-number">1</span></span><span>) {
        </span><span><span class="hljs-variable">$bytes</span></span><span> /= </span><span><span class="hljs-number">1024</span></span><span>;
        </span><span><span class="hljs-variable">$i</span></span><span>++;
    }
    </span><span><span class="hljs-keyword">return</span></span><span> </span><span><span class="hljs-title function_ invoke__">round</span></span><span>(</span><span><span class="hljs-variable">$bytes</span></span><span>, </span><span><span class="hljs-number">2</span></span><span>) . </span><span><span class="hljs-string">' '</span></span><span> . </span><span><span class="hljs-variable">$units</span></span><span>[</span><span><span class="hljs-variable">$i</span></span><span>];
}

<span class="hljs-comment">/**
 * 计算缓存命中率，单位百分比
 */</span>
</span><span><span class="hljs-function"><span class="hljs-keyword">function</span></span></span><span> </span><span><span class="hljs-title">calculateHitRate</span></span><span>(</span><span><span class="hljs-params"><span class="hljs-variable">$status</span></span></span><span>) {
    </span><span><span class="hljs-variable">$hits</span></span><span> = </span><span><span class="hljs-variable">$status</span></span><span>[</span><span><span class="hljs-string">'opcache_statistics'</span></span><span>][</span><span><span class="hljs-string">'hits'</span></span><span>] ?? </span><span><span class="hljs-number">0</span></span><span>;
    </span><span><span class="hljs-variable">$misses</span></span><span> = </span><span><span class="hljs-variable">$status</span></span><span>[</span><span><span class="hljs-string">'opcache_statistics'</span></span><span>][</span><span><span class="hljs-string">'misses'</span></span><span>] ?? </span><span><span class="hljs-number">0</span></span><span>;
    </span><span><span class="hljs-variable">$requests</span></span><span> = </span><span><span class="hljs-variable">$hits</span></span><span> + </span><span><span class="hljs-variable">$misses</span></span><span>;
    </span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$requests</span></span><span> === </span><span><span class="hljs-number">0</span></span><span>) </span><span><span class="hljs-keyword">return</span></span><span> </span><span><span class="hljs-number">0</span></span><span>;
    </span><span><span class="hljs-keyword">return</span></span><span> </span><span><span class="hljs-title function_ invoke__">round</span></span><span>((</span><span><span class="hljs-variable">$hits</span></span><span> / </span><span><span class="hljs-variable">$requests</span></span><span>) * </span><span><span class="hljs-number">100</span></span><span>, </span><span><span class="hljs-number">2</span></span><span>);
}

</span><span><span class="hljs-comment">// 调用函数展示状态</span></span><span>
</span><span><span class="hljs-title function_ invoke__">showOpcacheStatus</span></span><span>();
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>
opcache_get_configuration